Amazon EKS のマネージド型ノードグループに関するカスタム起動テンプレートの問題をトラブルシューティングする方法を教えてください。

所要時間2分

Amazon Elastic Kubernetes Service (Amazon EKS) クラスターのマネージド型ノードグループでカスタム起動テンプレートを使用する際のエラーをトラブルシューティングする方法を教えてください。

簡単な説明

Amazon EKS クラスターのマネージド型ノードグループでカスタム起動テンプレートを使用すると、以下のいずれかのエラーが発生する可能性があります。

「Client.InternalError: Client error on launch」(Client.InternalError: 起動時のクライアントエラー)
「SourceEc2LaunchTemplateNotFound or The Amazon EC2 Launch Template lt-xxxxxxxxxxxxxxxxx version x was not found」(ソース EC2 起動テンプレートが見つからないか、Amazon EC2 起動テンプレート lt-xxxxxxxxxxxxxxx バージョン x が見つかりませんでした)
「Node group entered a DEGRADED status」(ノードグループが DEGRADED ステータスになりました)

解決方法

Client.InternalError: 起動時のクライアントエラー

このエラーは、カスタム起動テンプレートで暗号化された Amazon Elastic Block Store (Amazon EBS) ボリュームを誤った権限で使用した場合に発生します。暗号化ステータスと AWS ID およびアクセス管理 (IAM) の権限またはポリシーを確認するには、以下を確認してください。

ボリュームの暗号化に使用される AWS Key Management Service (AWS KMS) キーが有効になっている。
AWS KMS キーに正しいキーポリシーが設定されている。暗号化された Amazon EBS ボリュームでより多くの IAM ロールを使用できるようにするために、キーポリシーを変更できます。詳細については、「KMS キーの使用をキーユーザーに許可する」をご覧ください。

SourceEc2LaunchTemplateNotFound or The Amazon EC2 Launch Template lt-xxxxxxxxxxxxxxxxx version x was not found (ソース EC2 起動テンプレートが見つからないか、Amazon EC2 起動テンプレート lt-xxxxxxxxxxxxxxx バージョン x が見つかりませんでした)

このエラーは、Amazon EKS の代わりにノードの Auto Scaling グループを使用してカスタム起動テンプレートのバージョンを手動で変更した場合に発生します。この問題を解決するには、Amazon EKS を使用して起動テンプレートのバージョンを更新する必要があります。

マネージド型ノードグループから EC2 起動テンプレートを更新するには、以下の手順を実行します。

Amazon EKS コンソールを開きます。
ナビゲーションペインで [Clusters] (クラスター)を選択します。
[Cluster name] (クラスター名)で、更新するノードグループを含むクラスターを選択します。
[Compute] (コンピュ―ティング) タブを選択します。
ノードグループの場合は、ノードを選択し、[Change version] (バージョンを変更) を選択します。
ノードグループに適用するバージョンを選択します。更新方法が [Rolling Update] (ローリング更新) に設定されていることを確認します。
[更新] を選択します。

詳細については、「マネージド型ノードグループの更新」をご覧ください。

新しい起動テンプレートを作成した後、ノードグループが DEGRADED ステータスになりました

ノードグループは、以下のようなエラーで DEGRADED ステータスになることがあります。

「The Amazon EC2 Launch Template : lt-xxxxxxxxxxxxxxxxx has a new version associated with your Autoscaling group, which is not managed by Amazon EKS.Expected Launch Template version : x」(Amazon EC2 起動テンプレート: lt-xxxxxxxxxxxxxxxxx に、Amazon EKS によって管理されていない自動スケーリンググループに関連する新しいバージョンがあります。起動予定テンプレートのバージョン: x)

この問題は、マネージド型ノードグループの Amazon EC2 起動テンプレートのバージョンが Amazon EKS が作成したバージョンと一致しない場合に発生します。カスタム起動テンプレートを使用しない既存のノードグループは直接更新できません。これを解決するには、希望の設定で起動テンプレートとバージョンを作成し、その起動テンプレートを使用してノードグループを作成します。カスタムテンプレートから新しいノードグループを起動すると、新しいバージョンのテンプレートを作成できます。このテンプレートは、ノードグループを DEGRADED ステータスにしなくても使用できます。