次の方法で共有

コントロール プレーン構成の検証エラー

この記事では、Azure Local で AKS クラスター 作成してデプロイするときに発生する可能性があるエラー コード ControlPlaneConfigurationValidation を特定して解決する方法について説明します。

症状

AKS Arc クラスターを作成しようとすると、次のようなエラー メッセージが表示されます。

admission webhook "vhybridakscluster.kb.io" denied the request: { 
   "result": "Failed", 
   "validationChecks": [ 
      { 
         "name": "ControlPlaneConfigurationValidation", 
         "message": "ControlPlane: Global LinuxProfile SSH public keys should be valid and non-empty. ssh: no key found", 
         "recommendation": "Please check https://aka.ms/AKSArcValidationErrors/ControlPlaneConfigurationValidation for recommendations" 
      } 
   ] 
}

次のセクションでは、ControlPlaneConfigurationValidation エラー コードが発生したときに表示されるエラー メッセージについて説明します。

グローバル LinuxProfile SSH 公開キーは有効であり、空ではない必要があります

Kubernetes クラスターの作成時に有効な SSH キー情報を指定せず、SSH キーが存在しない場合は、次のようなエラー メッセージが表示されます。

  • RSA キー ファイルまたはキー値を SSH キー値に指定する必要があります。
  • コントロール プレーン: クラスター構成にセキュリティ キーがありません。
  • LinuxProfile SSH 公開キーは有効であり、空でない必要があります。
  • グローバル LinuxProfile SSH 公開キーは有効であり、空でない必要があります。

この問題を軽減するには、Azure CLI を使用して SSH キーを生成して格納 SSH キーを作成する方法に関するページを参照してください。 次に、「使用しているインターフェイスに Kubernetes クラスターを作成する」を参照してください。 REST API を使用している場合は、プロビジョニングされたクラスター インスタンス に関する説明を参照して、プロビジョニングされたクラスター インスタンスを作成します。

コントロール プレーンの数と VM サイズ

Kubernetes では、コントロール プレーン ノードがクラスターを管理および調整します。 API Server、etcd、スケジューラなどの主要なコンポーネントを実行します。コントロール プレーン ノードは、クラスターの状態を維持し、ワークロードをスケジュールし、高可用性を確保します。多くの場合、冗長性のために複数のノードを使用します。

AKS Arc クラスターを正常に作成するには、少なくとも 1 つのコントロール プレーン ノード数を指定する必要があります。 また、etcd クォーラムを維持するには、コントロール プレーン ノードの数を奇数にする必要があります。 サポートされているカウントと VM SKU のオプションの詳細については、「Azure Localでの AKS のスケール要件」を参照してください。

次の手順

Azure Arc で有効になっている AKS の問題のトラブルシューティング

  • Last updated on