既存の Elastic Compute Service (ECS) インスタンスをワーカーノードとしてクラスターに追加したり、削除されたワーカーノードをノードプールに戻したりできます。これにより、クラスター内の既存のサービスを中断することなく、計算リソースを迅速に再利用できます。
ACK は、ノードを追加するための自動および手動のメソッドを提供します。インスタンスの課金方法とインスタンスタイプは、インスタンスが追加された後も変更されません。
項目 | 自動追加 | 手動追加 |
OS のリセット | 現在のノードプールの構成に基づいて、インスタンスのオペレーティングシステムをリセットおよび初期化します。
| インスタンスの元のオペレーティングシステムを保持するため、柔軟性が向上します。 |
シナリオ | 標準化された管理のためにインスタンスをノードプールの構成に一致させたい場合、このメソッドを使用します。 | インスタンスの既存のオペレーティングシステムまたは特定の構成を保持する必要がある場合、このメソッドを使用します。 |
制限事項
開始する前に、お使いの環境とインスタンスが次の条件を満たしていることを確認してください。
カテゴリ | 制限 | 説明 |
インスタンスとノードプール | クラスターノードクォータ | クラスター内のノードの総数は、クォータを超えることはできません。クォータを増やすには、Quota Center に移動してください。 Basic Edition の ACK マネージドクラスターのデフォルトのノードクォータは 10 です。 |
インスタンスの所有権 | インスタンスとクラスターは、同じアカウント、同じリージョン、同じ VPC 内にある必要があります。そうでない場合は、インスタンスを移行するか、これらの要件を満たす新しいインスタンスまたはクラスターを作成してください。 VPC ピアリング接続のもう一方の端から ECS インスタンスを追加することはできません。 | |
クラスターの所有権 | 別の ACK クラスターにすでに属しているインスタンスを追加することはできません。まず、元のクラスターからノードを削除し、次に新しいクラスターに追加します。 | |
Auto Scaling グループ (ESS) の所有権 | 別のスケーリンググループにすでに属しているインスタンスを追加することはできません。スケーリンググループからインスタンスを手動で削除して、リトライしてください。 | |
ノードプールタイプ |
| |
オペレーティングシステム |
| |
インスタンスタイプ |
| |
ネットワーク | API サーバーへのアクセス | インスタンスの IP アドレスは、API サーバーのアクセスホワイトリストに含まれている必要があります。そうでない場合、インスタンスはコントロールプレーンと通信できません。詳細については、「API サーバーのアクセス制御ポリシーを構成する」をご参照ください。 |
セキュリティグループ |
インスタンスのセキュリティグループタイプを変更したり、インスタンスを事前にノードプールのセキュリティグループに追加したりするには、「インスタンス (プライマリ ENI) にセキュリティグループを関連付ける」をご参照ください。セキュリティグループクォータを増やすには、「Elastic Compute Service クォータの表示または増加」をご参照ください。 | |
Terway - 最大 Pod 数 | インスタンスがサポートする Pod の最大数は、次の条件を満たす必要があります: 異なる ENI モードでサポートされる Pod の最大数は、インスタンスがサポートする ENI の最大数によって異なります。計算方法については、「ノードの Pod クォータの計算方法」をご参照ください。
これらの条件が満たされない場合は、ノードリソースをスペックアップまたはスペックダウンするか、新しいインスタンスを購入してください。 | |
Terway - vSwitch 構成 | インスタンスとノードプールが異なるゾーンにある場合は、Terway vSwitch 構成を更新する必要があります。そうしないと、Terway はノードのプライマリ ENI の vSwitch から Pod IP を割り当てるため、Pod IP の割り当てが失敗する可能性があります。詳細については、「Pod の vSwitch を変更する」をご参照ください。 | |
Terway - ENI | インスタンスを追加すると、アタッチされている ENI は保持されます。Pod IP は、これらの ENI に関連付けられている vSwitch から割り当てられます。インスタンスにプライマリネットワークインターフェイスカード (ENI) が 1 つしかないことを確認してください。 Pod IP が構成済みの vSwitch に属していない場合は、クラスターからノードを削除し、すべてのセカンダリ ENI を削除してから、ノードをクラスターに再度追加します。 | |
Terway - Worker RAM ロール | 追加するインスタンスは、ノードプールの Worker RAM ロールにアタッチする必要があります。これにより、最大利用可能 Pod 数 (MaxPod) の計算が不正確になる可能性のある権限の問題を防ぐことができます。 [ノードプール] ページで、ノードプール名をクリックし、[基本情報] タブで Worker RAM ロールを表示します。RAM ロールを付与するには、「ECS インスタンスに RAM ロールを付与する」をご参照ください。 | |
Terway - IPv6 デュアルスタック | クラスターで IPv6 デュアルスタックが有効になっている場合は、インスタンスのプライマリ ENI に IPv6 アドレスを割り当てる必要があります。詳細については、「IPv6 通信」をご参照ください。 | |
Flannel | クラスターの VPC のシステムルートテーブル内のカスタムルートエントリの数は、ルートテーブルクォータを超えることはできません。クォータを調整するには、Quota Center に移動してください。 |
注意事項
データバックアップ: 開始する前に、スナップショットを作成してインスタンスのシステムディスクとデータディスクをバックアップし、データの損失を防ぎます。
十分なスナップショットクォotaを確保するために、新しいスナップショットを作成する前に不要な手動および自動スナップショットを削除してください。
インスタンスのリリースと課金: ノード数を自動的に管理しないノードプールにインスタンスを追加した場合、クラスターまたはノードプールを削除してもインスタンスは自動的にリリースされません。ノードを手動で削除する必要があります。追加料金が発生しないように、ECS の課金ステータスを監視してください。
手順
所要時間: ノード追加プロセスには、システムディスクの交換 (自動追加のみ) とノードの初期化が含まれます。このプロセスには約 5 分かかります。実際の時間は、ネットワークの状態やオペレーティングシステムのサイズなどの要因によって異なる場合があります。
既存のノードを追加しても、クラスター内の既存のノードやアプリケーションには影響しません。互換性の問題を避けるため、すでにサービスを実行している ECS インスタンスをワーカーノードとして初期化しないでください。
ACK コンソールにログインします。左側のナビゲーションウィンドウで、[クラスター] をクリックします。
クラスター ページで、管理するクラスターを見つけてその名前をクリックします。左側のナビゲーションウィンドウで、 を選択します。
[ノードプール] ページで、対象のノードプールの [アクション] 列の
をクリックし、[既存ノードの追加] をクリックします。宛先の ECS インスタンスがクラウドサーバーのリストにない場合、クラスターに追加するための条件を満たしていません。[利用不可のインスタンスを表示] を選択して、利用不可の ECS インスタンスとその理由を表示できます。理由の詳細については、このトピックの「制限事項」および「注意事項」セクションをご参照ください。
画面上の注意事項をよく読み、ノードを追加するメソッドを選択します。
ノードを手動で追加する
このメソッドでは、インストールコマンドを取得してインスタンス上で実行する必要があります。一度に追加できる ECS インstance は 1 つだけです。
[追加方法] を [手動追加] に設定し、既存のクラウドサーバーのリストから追加する ECS インスタンスを選択して、[次へ] をクリックします。
[インスタンス情報の入力] ページで、プロンプトに従ってクラスターとインスタンスの情報を確認します。データディスクとインスタンス名を設定し、[次へ] をクリックします。画面の指示に従ってプロセスを完了します。
設定項目
説明
データディスクのマウント
コンテナーとイメージのデータをデータディスクに保存するかどうかを指定します。これにより、システムディスクがデータディスクから分離され、安定性が向上します。
ECS インスタンスにすでにデータディスクがアタッチされており、最後のデータディスクのファイルシステムが初期化されていない場合、ACK は最後のデータディスクを ext4 ファイルシステムに自動的にフォーマットします。このディスクは、/var/lib/containerd または /var/lib/docker (コンテナーランタイムのデフォルトのデータディレクトリ) および /var/lib/kubelet (kubelet コンポーネントのデフォルトのデータディレクトリ) 専用に使用されます。
重要フォーマットされたデータディスク上の元のデータは失われます。最初にスナップショットを作成してデータをバックアップしてください。
コンテナーとイメージをデータディスクに保存する場合、ext4 および xfs ファイルシステムのみがサポートされます。
ECS インスタンスにデータディスクがアタッチされていない場合、このオプションを選択したかどうかに関係なく、ACK は新しいデータディスクを自動的にアタッチしません。
インスタンス名を保持
有効: インスタンス名をノード名として使用します。
無効: ACK は、カスタムノード名に指定されたルールに従ってノードの名前を変更します。
[追加完了] ページで、ACK が自動的に生成するノードアクセスコマンドを後で使用するためにコピーし、[完了] をクリックします。
ECS コンソールにログインします。左側のナビゲーションウィンドウで、[インスタンスとイメージ] > [インスタンス] をクリックします。クラスターが配置されているリージョンを選択し、宛先インスタンスを選択します。
宛先インスタンスの [リモート接続] をクリックします。リモート接続メソッドを選択し、ECS インスタンスに接続します。
画面の指示に従って、ステップ 3 でコピーしたスクリプトを実行します。これにより、インスタンスが自動的に構成され、クラスターに追加されます。
スクリプトが正常に実行されると、ノードが追加されたことを示すメッセージが表示されます。ノードが初期化されるのを待ちます。ノードが初期化されると、ノードリストでノードのステータスが Ready に変わります。

ノードを自動的に追加する
コンソールからインスタンスを自動的に追加できます。
[追加方法] を [自動追加] に設定し、既存のクラウドサーバーのリストから追加する ECS インスタンスを選択して、[次へ] をクリックします。
[インスタンス情報の入力] ページで、プロンプトに従ってクラスターとインスタンスの情報を確認します。データディスクとインスタンス名を設定し、[次へ] をクリックします。
設定項目
説明
データディスクのマウント
コンテナーとイメージのデータをデータディスクに保存するかどうかを指定します。これにより、システムディスクがデータディスクから分離され、安定性が向上します。
ECS インスタンスにすでにデータディスクがアタッチされており、最後のデータディスクのファイルシステムが初期化されていない場合、ACK は最後のデータディスクを ext4 ファイルシステムに自動的にフォーマットします。このディスクは、/var/lib/containerd または /var/lib/docker (コンテナーランタイムのデフォルトのデータディレクトリ) および /var/lib/kubelet (kubelet コンポーネントのデフォルトのデータディレクトリ) 専用に使用されます。
重要フォーマットされたデータディスク上の元のデータは失われます。最初にスナップショットを作成してデータをバックアップしてください。
コンテナーとイメージをデータディスクに保存する場合、ext4 および xfs ファイルシステムのみがサポートされます。
ECS インスタンスにデータディスクがアタッチされていない場合、このオプションを選択したかどうかに関係なく、ACK は新しいデータディスクを自動的にアタッチしません。
ログオン方法とパスワード
ノードプールの [ログオン方法] が [パスワードの設定] に設定されている場合は、インスタンスのパスワードをリセットします。
インスタンス名を保持
有効: インスタンス名をノード名として使用します。
無効: ACK は、カスタムノード名に指定されたルールに従ってノードの名前を変更します。
表示されるダイアログボックスで、注意事項をよく読み、[OK] をクリックします。
インスタンスが追加されたら、ノードが初期化されるのを待ちます。ノードが初期化されると、ノードリストでノードのステータスが Ready に変わります。
よくある質問
既存のノードを追加すると、クラスター内の既存のサービスに影響しますか?
いいえ。既存のノードを手動または自動で追加しても、クラスター内の既存のサービスには影響しません。
ECS インスタンスをクラスターに追加した後、ECS インスタンスをスペックアップまたはスペックダウンすると、クラスターサービスに影響しますか?
ECS インスタンスのスペックアップまたはスペックダウンには、通常、インスタンスタイプの変更、パブリック帯域幅の課金方法の変更、パブリック帯域幅の変更、データディスクの課金方法の変更などの操作が含まれます。詳細については、「インスタンス構成変更の概要」をご参照ください。これらの操作が ECS インスタンスに与える影響はさまざまです。
再起動を必要としない操作: サービスへの影響は、特定のビジネス要件によって異なります。
ECS インスタンスの再起動が必要な操作: インスタンスタイプのスペックアップやスペックダウンなどの操作は、サービスに破壊的な変更をもたらします。このような操作 (たとえば、ノードリソースのスペックアップまたはスペックダウン) を実行する前に、現在のワークロードを評価してください。冗長なノードをスケールアウトして、アプリケーション Pod を処理できます。次に、変更したいノードをドレインし、スケーリンググループと ACK クラスターから削除します。詳細については、「ノードの削除」をご参照ください。
スペックアップまたはスペックダウンが完了したら、このトピックの指示に従ってノードをクラスターに再度追加します。
異なるインスタンスタイプの既存ノードを ACK クラスターに追加できますか?
はい。ACK では、同じノードプール内で複数のインスタンスタイプのノードを管理できます。これにより、利用できない、または在庫切れのインスタンスタイプが原因で発生するノードのスケールアウトの失敗を防ぐことができます。ECS インスタンスを追加する前に、ECS インスタンスのインスタンスタイプがノードプールでサポートされているインスタンスタイプのリストに含まれていることを確認してください。次のステップに従ってください。
ノードプールを編集または作成し、必要なノード仕様を構成します。詳細については、「ノードプールの作成と管理」をご参照ください。
ターゲットノードを削除してドレインします。ノードを削除するときに ECS インスタンスをリリースしないでください。詳細については、「ノードの削除」をご参照ください。
このトピックの「制限事項」および「手順」セクションの指示に従って、異なる仕様の ECS インスタンスをノードプールに追加します。
ACK クラスター間でノードを移動するにはどうすればよいですか?
ACK では、クラスター間でノードを直接移動することはできません。ただし、ソースクラスターからノードを削除し、宛先クラスターに追加することでノードを移動できます。次のステップに従ってください。
ACK EOL オペレーティングシステムを搭載した ECS インスタンスをノードプールに追加できますか?
手動追加: サポートされていないオペレーティングシステムを実行している既存のインスタンスをノードプールに手動で追加できます。ただし、インスタンスの OS バージョンが現在のクラスターバージョンと互換性があることを確認してください。詳細については、「オペレーティングシステム」をご参照ください。
たとえば、CentOS 7 と Alibaba Cloud Linux 2 は、Kubernetes 1.30 以前を実行するクラスターでのみサポートされます。
自動追加: はい。ACK は、ノードプールの構成で指定されたオペレーティングシステムイメージを使用してインスタンスを初期化します。
既存のノードを追加すると、そのカスタムユーザーデータはノードプールのユーザーデータによって上書きされますか?
元のインスタンスのユーザーデータが上書きされるかどうかは、追加方法によって異なります。
自動追加: ACK はシステムディスクを初期化します。元のインスタンスのユーザーデータは、ノードプールのユーザーデータ構成によって上書きされます。
手動追加: 元のインスタンスのユーザーデータは上書きされません。インスタンスがノードプールに追加された後も、インスタンスは元のユーザーデータを引き続き使用します。
既存のノードを追加した後にタイムアウトエラーが発生した場合はどうすればよいですか?
API サーバー Classic Load Balancer (CLB) インスタンスのネットワークにノードが接続できるかどうかを確認します。まず、セキュリティグループが要件を満たしているかどうかを確認します。既存のノードを追加するためのセキュリティグループの制限の詳細については、このトピックの「制限事項」セクションをご参照ください。その他のネットワーク接続の問題のトラブルシューティングの詳細については、「ネットワーク管理に関する FAQ」をご参照ください。
既存のノードを追加した後、ノードプール内の希望するノード数は自動的に変更されますか?
既存のノードを追加すると、希望するノード数は追加されたノードの数だけ自動的に増加します。たとえば、ノードプールの [希望するノード数] が 5 で、1 つの ECS インスタンスをノードプールに追加すると、ノードプールの [希望するノード数] は自動的に 6 に変更されます。
関連ドキュメント
コンソールに加えて、OpenAPI を呼び出すか、コマンドラインインターフェイス (CLI) を使用して ECS インスタンスを ACK クラスターに追加できます。詳細については、「クラスターノードプールに既存のノードを追加するためのクエリスクリプト」および「既存の ECS インスタンスの追加」をご参照ください。
ノードプール機能が利用可能になる前に作成された古いクラスターには、孤立ノードが存在する場合があります。孤立ノードは、どのノードプールにも属さないクラスターノードです。これらのノードはノードプールで管理できます。詳細については、「孤立ノードをノードプールに移行する」をご参照ください。
ノード、Pod、またはその他のコンポーネントが異常な場合は、「異常なノードのトラブルシューティング」、「異常な Pod のトラブルシューティング」、および「ノードとノードプールに関する FAQ」を参照して問題をトラブルシューティングしてください。