ACK クラスタに ECS インスタンスをワーカーノードとして追加する場合、またはノードプールにワーカーノードを再追加する場合は、ACK を構成してノードを自動的に追加するか、ACK コンソールでノードを手動で追加します。ノードをノードプールに追加すると、ノードプールの構成がノードによって自動的に使用され、ノードプールレベルでノードを一元管理できます。
制限
インスタンスタイプの制限
制限 | 説明 | 推奨される解決策 |
GPU アクセラレーション ECS ベアメタルインスタンス | GPU アクセラレーション ECS ベアメタルインスタンスファミリ ebmgn7 および ebmgn7e に属するインスタンスは、マルチインスタンス GPU（MIG）構成を自動的に削除できません。ACK は、上記のインスタンスファミリのインスタンスに保持されている MIG 構成を自動的にリセットします。リセットには時間がかかる場合があります。この期間中は、インスタンスをクラスタに追加できない場合があります。 | 問題のトラブルシューティング方法の詳細については、「NVIDIA A100 GPU を搭載した ECS ベアメタルインスタンスを追加できない場合はどうすればよいですか？」をご参照ください。 |
クォータ
制限 | 説明 | 推奨される解決策 |
ノードクォータ | クラスタに十分なノードクォータがあることを確認してください。ACK クラスタに関連するクォータの詳細については、「制限」をご参照ください。 | ノードクォータを増やすには、クォータセンターコンソール でクォータの増加を申請してください。 |
ECS インスタンスの制限
制限 | 説明 | 推奨される解決策 |
アカウント、リージョン、VPC | 追加する ECS インスタンスは、クラスタと同じ Alibaba Cloud アカウントに属している必要があります。さらに、追加する ECS インスタンスは、クラスタと同じリージョンおよび仮想プライベートクラウド（VPC）にデプロイされている必要があります。 | 要件を満たすように ECS インスタンスを再作成するか、クラスタを再作成します。 |
クラスタ | 他のクラスタに既に属している ECS インスタンスを追加することはできません。 | 他のクラスタに既に属している ECS インスタンスを追加する場合は、クラスタから ECS インスタンスを削除してから、目的のクラスタに追加します。詳細については、「ノードを削除する」をご参照ください。 |
ネットワークの制限
制限 | 説明 | 推奨される解決策 |
Terway | Terway には、追加する ECS インスタンスタイプでサポートされるポッドの最大数に関して、次の制限があります。
各 ENI モードでサポートされるポッドの最大数は、インスタンスタイプでサポートされる ENI の最大数によって異なります。各 ENI モードでサポートされるポッドの最大数の計算方法の詳細については、「Terway を使用する」をご参照ください。インスタンスタイプでサポートされるポッドの最大数のクエリ方法の詳細については、「Terway を使用する」をご参照ください。 |
|
Terway には、ENI に関して次の制限があります。 | ||
新しいゾーンのノードをクラスタに追加する場合、Terway の vSwitch 構成を更新する必要があります。そうしないと、ノードのプライマリ ENI の vSwitch からノード上のポッドに IP アドレスが割り当てられます。 | 詳細については、「ポッド vSwitch を変更する」をご参照ください。 | |
既存のノードをノードプールに追加すると、ノードにバインドされている ENI は保持されます。ENI が属する vSwitch は、ノード上のポッドに IP アドレスを割り当てるために使用されます。追加するノードにプライマリ ENI が 1 つだけあることを確認してください。 | ノード上のポッドがノードの vSwitch に属していない IP アドレスを使用している場合は、クラスタからノードを削除し、すべてのセカンダリ ENI を削除してから、クラスタにノードを再追加します。 | |
既存のノードをノードプールに追加する場合は、クラスタ RAM ロールが対応する ECS インスタンスに割り当てられていることを確認してください。そうしないと、権限の問題により、システムはノードでサポートされるポッドの最大数（MaxPod）を正しく計算できません。その結果、システムによって計算された ENI の最大数が正しくありません。 | 詳細については、「RBAC を使用してクラスタ内のリソースに対する操作権限を管理する」をご参照ください。 | |
Flannel | クラスタが存在する VPC のシステムルートテーブルのカスタムルートエントリ数は、ルートテーブルのクォータ制限を超えることはできません。カスタムルートエントリの詳細については、「ルートテーブル」をご参照ください。 | クォータセンターコンソール でクォータの増加を申請してください。 |
IPv4/IPv6 デュアルスタック | 追加する ECS インスタンスのプライマリ ENI に IPv6 アドレスを割り当てる必要があります。 | ECS インスタンスのプライマリ ENI に IPv6 アドレスを割り当てる方法の詳細については、「IPv6 通信」をご参照ください。 |
セキュリティグループの制限
制限 | 説明 | 推奨される解決策 |
セキュリティグループタイプ | 既存の ECS インスタンスをノードプールに追加すると、インスタンスはノードプールのセキュリティグループにも追加されます。ECS の制限により、ECS インスタンスは基本セキュリティグループと高度なセキュリティグループに同時に属することはできません。したがって、ECS インスタンスが属するセキュリティグループのタイプは、ECS インスタンスが追加されるノードプールのタイプと同じである必要があります。 ACK コンソールのノードプール [詳細] ページの [概要] タブで、ノードプールのセキュリティグループを表示できます。また、ECS コンソールに移動して、ECS インスタンスが属するセキュリティグループを表示することもできます。セキュリティグループの詳細については、「概要」をご参照ください。 | ノードプールのセキュリティグループを変更したり、セキュリティグループのタイプを変更したりすることはできません。セキュリティグループの競合が発生した場合は、次の解決策を使用してください。
|
セキュリティグルーパールール | ECS インスタンスのセキュリティグルーパールールは、ECS インスタンスが追加されるノードプールおよびクラスタのセキュリティグルーパールールと競合してはなりません。 | まず、既存のノードを目的のノードプールのセキュリティグループに追加します。 セキュリティグルーパールールチェック機能を使用して、ノードプールの各セキュリティグルーパールールをチェックします。 |
セキュリティグループの数 | 既存の ECS インスタンスをノードプールに追加すると、インスタンスはノードプールのセキュリティグループにも追加されます。インスタンスが属するセキュリティグループの数が上限を超えていないことを確認してください。デフォルトの上限は 5 です。 | セキュリティグループの制限と、ECS インスタンスのセキュリティグループのクォータ制限を増やす方法の詳細については、「セキュリティグループの制限」をご参照ください。 |
注意事項
インスタンスのリリース
クラスタまたはノードプールを削除しても、クラスタまたはノードプールに追加された ECS インスタンスは自動的にリリースされません。ECS インスタンスを手動でリリースする必要があります。詳細については、「ノードを削除する」をご参照ください。
課金
クラスタまたはクラスタ内のノードプールを削除しても、クラスタに追加した ECS インスタンスはリリースされません。不要なコストを避けるため、ECS インスタンスの課金を適宜確認することをお勧めします。詳細については、「課金概要」をご参照ください。
ノードプールとインスタンス構成
既存の ECS インスタンスをノードプールに追加しても、ECS インスタンスの課金方法とインスタンスタイプは変更されません。
この機能は、[スケーリングモード] が [自動] に設定されているノードプールをサポートしていません。
オペレーティングシステムとディスク
データの損失や破損に備えて、ECS インスタンスを追加する前にデータをバックアップすることをお勧めします。詳細については、「スナップショットを作成する」をご参照ください。
ACK を構成してノードを自動的に追加する場合、ACK はノードのオペレーティングシステムをノードプールのオペレーティングシステムにリセットします。ノードを手動で追加する場合、ノードのオペレーティングシステムは保持されます。追加するノードのオペレーティングシステムを保持するには、ノードを手動で追加します。
ACK を構成してノードを自動的に追加する場合、ノードのシステムディスクはリリースされますが、データディスクは保持されます。ただし、データディスクの ID は変更されます。データディスク内のデータは影響を受けません。
ACK を構成してノードを自動的に追加する場合、システムディスクのユーザースナップショットは保持されます。自動スナップショットは、システムディスクの [ディスクのリリース中に自動スナップショットを削除] 属性の設定に基づいて、システムディスクとともに保持または削除されます。ECS コンソール で設定を変更できます。詳細については、「ディスクのリリース中に自動スナップショットを削除属性を有効にする」をご参照ください。
自動スナップショットポリシーを定期的に実行するための十分なスナップショットクォータがあることを確認するために、不要になったユーザースナップショットと自動スナップショットを削除することをお勧めします。
ノードを自動または手動で追加する
ノードを自動または手動で追加しても、クラスタ内の既存のノードまたはアプリケーションには影響しません。互換性の問題を避けるため、ECS インスタンスにサービスが既にデプロイされている場合は、ECS インスタンスをワーカーノードとして初期化しないことをお勧めします。
ACK を構成してノードを自動的に追加する場合、ACK はノードのオペレーティングシステムをノードプールのオペレーティングシステムに置き換えます。ノードを手動で追加する場合、ノードのオペレーティングシステムは保持されます。
ノードを手動で追加する場合、ノードの元のオペレーティングシステムは保持されます。オペレーティングシステムはリセットされません。「制限」に加えて、ノードを手動で追加する前に、次の制限にも注意する必要があります。
オペレーティングシステムが ContainerOS の ECS インスタンスを追加することはできません。詳細については、「ContainerOS」をご参照ください。
追加する ECS インスタンスのオペレーティングシステムでスワップが無効になっていることを確認してください。
コンテナデータとイメージをデータディスクに保存する場合は、データディスクが ext または XFS ファイルシステムを使用していることを確認してください。
ACK コンソール にログインします。左側のナビゲーションウィンドウで、[クラスタ] をクリックします。
[クラスタ] ページで、管理するクラスタを見つけ、その名前をクリックします。左側のナビゲーションウィンドウで、 を選択します。
ノードプール[ノードプール] ページで、ターゲットノードプールを見つけ、 列で
> [既存のノードを追加]アクション を選択します。
ノードを手動で追加する
インストールコマンドを取得し、ECS インスタンスにログインして、コマンドを実行して ACK クラスタに ECS インスタンスを追加する必要があります。操作ごとに追加できる ECS インスタンスは 1 つだけです。
[既存の ECS インスタンスを選択] ウィザードページで、[モード] を [手動] に設定し、リストから既存の ECS インスタンスを選択して、[次のステップ] をクリックします。
[インスタンス情報の指定] ウィザードページで、パラメータを構成し、[次のステップ] をクリックします。
パラメータ
説明
クラスタ ID/名前
ECS インスタンスを追加するクラスタに関する情報。このパラメータは自動的に設定されます。
データディスク
コンテナとイメージデータをデータディスクに保存するかどうかを指定します。
ECS インスタンスにデータディスクがマウントされていて、最後のデータディスクのファイルシステムが初期化されていない場合、システムはデータディスクを ext4 に自動的にフォーマットします。次に、システムはディスクを使用して、/var/lib/docker（Docker のデフォルトのデータディレクトリ）および /var/lib/kubelet（kubelet のデフォルトのデータディレクトリ）にデータを保存します。
重要ディスクのフォーマットはすべてのデータを消去します。したがって、システムフォーマットの前にディスクをバックアップしてください。
ECS インスタンスにデータディスクが接続されていない場合、システムはデータディスクを購入しません。
インスタンス名を保持
デフォルトでは、[インスタンス名を保持] がオンになっています。インスタンス名を保持したくない場合は、[インスタンス名を保持] をオフにします。この機能を無効にすると、ノードの名前変更ルールに基づいてノードの名前が変更されます。
インスタンス情報
追加する ECS インスタンスの ID と名前。
[完了] ウィザードページで、ECS インスタンスにリモートログインするために使用されるコマンドをコピーし、[完了] をクリックします。
ECS コンソール にログインします。左側のナビゲーションウィンドウで、[インスタンスとイメージ] > [インスタンス] を選択します。次に、クラスタがデプロイされているリージョンを選択し、追加する ECS インスタンスを選択します。
[アクション] 列の [接続] をクリックします。接続方法を選択し、接続ページに移動します。
詳細については、「ECS インスタンスへの接続方法」をご参照ください。
保存したコマンドを実行してスクリプトを実行します。
スクリプトが実行されると、ECS インスタンスがクラスタに追加されます。
ECS インスタンスが追加された後、[ノードプール] ページのノードプールの [アクション] 列の [詳細] をクリックして、[ノード] タブで新しく追加されたノードに関する情報を表示できます。
ノードを自動的に追加する
現在のアカウント内の使用可能なすべての ECS インスタンスが ACK コンソールに表示されます。パラメータを構成すると、ECS インスタンスは自動的にクラスタに追加されます。
[既存の ECS インスタンスを選択] ウィザードページで、[モード] を [自動] に設定し、リストから既存の ECS インスタンスを選択して、[次のステップ] をクリックします。
[インスタンス情報の指定] ウィザードページで、パラメータを構成し、[次のステップ] をクリックします。
パラメータ
説明
クラスタ ID/名前
ECS インスタンスを追加するクラスタに関する情報。このパラメータは自動的に設定されます。
データディスク
コンテナとイメージデータをデータディスクに保存するかどうかを指定します。
ECS インスタンスにデータディスクがマウントされていて、最後のデータディスクのファイルシステムが初期化されていない場合、システムはデータディスクを ext4 に自動的にフォーマットします。次に、システムはディスクを使用して、/var/lib/docker（Docker のデフォルトのデータディレクトリ）および /var/lib/kubelet（kubelet のデフォルトのデータディレクトリ）にデータを保存します。
重要ディスクのフォーマットはすべてのデータを消去します。したがって、システムフォーマットの前にディスクをバックアップしてください。
ECS インスタンスにデータディスクが接続されていない場合、システムはデータディスクを購入しません。
インスタンス名を保持
デフォルトでは、[インスタンス名を保持] がオンになっています。インスタンス名を保持したくない場合は、[インスタンス名を保持] をオフにします。この機能を無効にすると、ノードの名前変更ルールに基づいてノードの名前が変更されます。
インスタンス情報
追加する ECS インスタンスの ID と名前。
[確認] メッセージで注意事項を読み、[確認] をクリックします。
ECS インスタンスが追加された後、[ノードプール] ページのノードプールの [アクション] 列の [詳細] をクリックして、[ノード] タブで新しく追加されたノードに関する情報を表示できます。
よくある質問
クラスタに追加した ECS インスタンスをアップグレードまたはダウングレードした場合、クラスタ内のビジネスは影響を受けますか？
ECS インスタンスのアップグレードまたはダウングレードには、通常、ECS インスタンス タイプ、インターネット帯域幅、インターネット帯域幅の課金方式、およびデータ ディスクの課金方式の変更が含まれます。詳細については、「インスタンス構成の変更の概要」をご参照ください。アップグレードまたはダウングレードの方法は、ECS インスタンスにさまざまな影響を与えます。
再起動を必要としないアップグレードまたはダウングレードの場合は、実際のビジネスシナリオに基づいて影響を評価する必要があります。
インスタンスタイプの変更など、再起動を必要とするアップグレードまたはダウングレードは、ビジネスに悪影響を及ぼします。操作（ワーカーノードリソースのアップグレードまたはダウングレード）を実行する前に、エビクトされたアプリケーションポッドをホストするために追加のノードを追加する必要があるかどうかを確認する必要があります。次に、アップグレードまたはダウングレードするノードをドレインし、スケーリンググループと ACK クラスタから削除します。詳細については、「ノードを削除する」をご参照ください。
アップグレードまたはダウングレードが完了したら、このトピックの手順を実行して、ノードをクラスタに再追加します。
既存のノードを追加した後にタイムアウトエラーが発生した場合はどうすればよいですか？
ノードのネットワークと API サーバー の Classic Load Balancer（CLB）インスタンスのネットワークが接続されているかどうかを確認します。セキュリティグループが要件を満たしているかどうかを確認します。セキュリティグループの制限の詳細については、「セキュリティグループの制限」をご参照ください。その他のネットワーク接続の問題の詳細については、「ネットワーク管理に関するよくある質問」をご参照ください。
異なるインスタンスタイプの既存のノードを同じ ACK クラスタに追加できますか？
はい、異なるインスタンスタイプのノードをノードプールに追加できます。これにより、指定したインスタンスタイプが使用できない場合、または指定したタイプの ECS インスタンスの在庫がない場合に、ノードのスケールアウトエラーを回避できます。これを行うには、次の手順を実行します。
ノードプールを作成または変更し、目的のインスタンスタイプを選択します。詳細については、「ノードプールを作成および管理する」をご参照ください。
「ノードを削除する」を参照して、ノードを削除およびドレインします。対応する ECS インスタンスはリリースしないでください。
「制限」および「ノードを自動または手動で追加する」を参照して、異なるインスタンスタイプの ECS インスタンスをノードプールに追加します。
ACK クラスタ間でノードを移動するにはどうすればよいですか？
ACK クラスタ間でノードを直接移動することはできません。既存のノードを追加する方法を使用する必要があります。これを行うには、次の手順を実行します。
「ノードを削除する」を参照して、ノードを削除およびドレインします。対応する ECS インスタンスはリリースしないでください。
「制限」および「ノードを自動または手動で追加する」を参照して、異なるインスタンスタイプの ECS インスタンスをノードプールに追加します。
既存のノードが追加された後、ノードプールのノードの予想数は自動的に変更されますか？
既存のノードを追加すると、ノードの予想数は、追加されたノードの数だけ自動的に増加します。たとえば、ノードプールの [ノードの予想数] パラメータの値が 5 に設定されているとします。既存の ECS インスタンスをノードプールに追加すると、ノードプールの [ノードの予想数] パラメータの値は自動的に 6 に変更されます。
参照
ACK コンソールに加えて、API 操作を呼び出したり、CLI を使用して ACK クラスタに ECS インスタンスを追加することもできます。詳細については、「既存のインスタンスを指定したノードプールに手動で追加する」および「既存の ECS インスタンスを追加する」をご参照ください。
ノードプール機能がリリースされる前に作成されたクラスタには、フリーノードが存在します。フリーノードは、どのノードプールにも属していないノードです。フリーノードをノードプールに追加する方法の詳細については、「フリーノードをノードプールに追加する」をご参照ください。
ノードまたはポッドの例外のトラブルシューティング方法の詳細については、「ノードの例外のトラブルシューティング」、「ポッドのトラブルシューティング」、および「ノードとノードプールに関するよくある質問」をご参照ください。