AWS Outposts での Amazon EKS のローカルクラスターのトラブルシューティング

ローカルクラスターは Amazon EKS API を通して作成されますが、非同期で実行されます。つまり、Amazon EKS API へのリクエストはローカルクラスターに対してすぐに返されます。ただし、これらのリクエストは成功し、入力検証エラーにより迅速に失敗するか、あるいは失敗して説明入りの検証エラーが発生する可能性があります。この動作は、Kubernetes API のと似ています。

ローカルクラスターは FAILED ステータスに移行しません。Amazon EKS は、クラスターの状態をユーザーが要求した望ましい状態と一致させようと継続的に試みます。その結果、根本的な問題が解決されるまで、長期間にわたってローカルクラスターが CREATING 状態のままになる可能性があります。

describe-cluster Amazon EKS AWS CLI コマンドを使用して、ローカルクラスターの問題は検出できます。ローカルクラスターの問題は、describe-cluster コマンドの応答の cluster.health フィールドによって明らかになります。このフィールドに含まれるメッセージには、エラーコード、説明メッセージ、および関連するリソース ID が含まれます。この情報は、Amazon EKS API および AWS CLI のみから利用可能です。次の例では、my-cluster をローカルクラスターの名前に置き換えます。

aws eks describe-cluster --name my-cluster --query 'cluster.health'

出力例は次のとおりです。

{
    "issues": [
        {
            "code": "ConfigurationConflict",
            "message": "The instance type 'm5.large' is not supported in Outpost 'my-outpost-arn'.",
            "resourceIds": [
                "my-cluster-arn"
            ]
        }
    ]
}

問題が修復できない場合は、ローカルクラスターを削除して新しいクラスターを作成する必要がある場合があります。たとえば、Outpost で利用できないインスタンスタイプでクラスターをプロビジョニングしようとしている場合などです。下表は、一般的なヘルス関連のエラーを示しています。

次の表は、describe-cluster 応答のヘルスフィールドに表示される他の AWS のサービス からのエラーを示しています。

ローカルクラスターには、クラウド内にホストされている Amazon EKS クラスターとは異なるアクセス権限とポリシーが必要です。クラスターの作成に失敗し InvalidPermissions エラーが表示される場合は、使用しているクラスター ロールに AmazonEKSLocalOutpostClusterPolicy マネージドポリシーがアタッチされているかどうかを確認します。その他すべての API 呼び出しには、クラウド内の Amazon EKS クラスターと同じ権限セットが必要です。

ローカルクラスターの作成にかかる時間は、いくつかの要因によって異なります。ネットワーク設定、Outpost の設定、およびクラスターの設定などが要因として考えられます。通常、ローカルクラスターは 15 ～ 20 分以内に作成され、ACTIVE ステータスに変わります。ローカルクラスターが CREATING 状態を維持する場合は、describe-cluster を呼び出すと cluster.health 出力フィールドに原因に関する情報が表示されます。

次は、最も一般的な問題を示しています。

VPC とサブネット DNS の設定が誤っているか、欠落しています

確認Amazon EKS ローカルクラスター VPC およびサブネットの要件と考慮事項。

Outpost が関連付けられている AWS リージョン から切断された場合でも、Kubernetes クラスターは依然として動作し続ける可能性があります。ただし、クラスターが正常に機能しない場合は、ネットワーク切断の準備 にあるトラブルシューティング手順に従ってください。他の問題が発生した場合は、AWS Support にお問い合わせください。AWS Support からログ収集ツールをダウンロードして実行する方法を説明します。この方法により、Kubernetes クラスターコントロールプレーンインスタンスからログを収集し、詳細な調査のために AWS Support サポートに送信できます。

Amazon EKS コントロールプレーンインスタンスが AWS Systems Manager (Systems Manager) を通してアクセスでない場合、Amazon EKS はクラスターに対して次のエラーを表示します。

Amazon EKS control plane instances are not reachable through SSM. Please verify your SSM and network configuration, and reference the EKS on Outposts troubleshooting documentation.

この問題を解決するには、VPC とサブネットが Amazon EKS ローカルクラスター VPC およびサブネットの要件と考慮事項 の要件を満たしており、AWS Systems Manager ユーザーガイドの「Session Manager の設定」にある手順が完了していることを確認してください。