クラスタの作成または更新に関する問題のトラブルシューティング

このページでは、GKE on Azure のインストールやアップグレードに関連する問題を解決する方法について説明します。

さらにサポートが必要な場合は、Cloud カスタマーケアにお問い合わせください。

クラスタの作成に失敗する

クラスタを作成するリクエストを行うと、GKE on Azure は、最初に一連のプリフライト テストを実行し、そのリクエストの検証を行います。クラスタの作成に失敗した場合は、このプリフライト テストのいずれかが失敗したか、クラスタを作成するプロセス自体のステップが完了しなかった可能性があります。

プリフライト テストが失敗すると、クラスタはリソースを作成せず、エラーに関する情報を直接返します。たとえば、invalid%%%name という名前のクラスタを作成しようとすると、有効なクラスタ名のプリフライト テストは失敗し、リクエストは次のエラーを返します。

ERROR: (gcloud.container.azure.clusters.create) INVALID_ARGUMENT: must be
between 1-63 characters, valid characters are /[a-z][0-9]-/, should start with a
letter, and end with a letter or a number: "invalid%%%name",
field: azure_cluster_id

プリフライト テストに合格した後にクラスタの作成に失敗する場合もあります。これは、クラスタの作成開始から数分後（GKE on Azure が Google Cloud と Azure にリソースを作成した後）に発生する可能性があります。この場合は、状態が ERROR に設定されている Azure リソースが Google Cloud プロジェクト内に存在します。

失敗の詳細を取得するには、次のコマンドを実行します。

gcloud container azure clusters describe CLUSTER_NAME \
    --location GOOGLE_CLOUD_LOCATION \
    --format "value(state, errors)"

次のように置き換えます。

  • CLUSTER_NAME: 状態のクエリを実行するクラスタの名前。
  • GOOGLE_CLOUD_LOCATION: この Azure クラスタを管理する Google Cloud リージョンの名前。

あるいは、Create Cluster API 呼び出しに関連付けられた Operation リソースを記述して、作成エラーの詳細を取得することもできます。

gcloud container azure operations describe OPERATION_ID

OPERATION_ID は、クラスタを作成したオペレーションの ID に置き換えます。クラスタ作成リクエストのオペレーション ID がない場合は、次のコマンドで取得できます。

gcloud container azure operations list \
    --location GOOGLE_CLOUD_LOCATION

タイムスタンプまたは関連情報を使用して、対象のクラスタ作成オペレーションを特定します。

クラスタの更新に失敗する

クラスタを更新すると、新しいクラスタを作成する場合と同様に、GKE on Azure は、最初に一連のプリフライト テストを実行してリクエストを検証します。クラスタの更新に失敗した場合は、このプリフライト テストのいずれかが失敗したか、クラスタを更新するプロセス自体のステップが完了しなかった可能性があります。

プリフライト テストが失敗すると、クラスタはリソースを更新せず、エラーに関する情報を直接返します。たとえば、test_ec2_keypair という SSH 認証鍵ペアを使用するようにクラスタを更新しようとすると、プリフライト テストで EC2 鍵ペアの取得に失敗し、リクエストは次のエラーを返します。

ERROR: (gcloud.container.azure.clusters.update) INVALID_ARGUMENT: key pair
"test_ec2_keypair" not found,
field: azure_cluster.control_plane.ssh_config.ec2_key_pair

プリフライト テストに合格した後にクラスタの構成に失敗する場合もあります。これは、クラスタの更新開始から数分後に発生する可能性があり、Google Cloud プロジェクトの Azure リソースの状態は DEGRADED に設定されます。

失敗と関連する操作の詳細については、クラスタの作成に失敗するをご覧ください。

次のステップ