本文說明當您在 Azure 的本機環境中建立及部署 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，請參閱 布建的叢集實例 來建立布建的叢集實例。
控制層數量和虛擬機大小
在 Kubernetes 中，控制平面節點會管理和協調叢集。 它們會執行重要元件，例如 API Server 等、排程器等。控制平面節點會維護叢集狀態、排程工作負載，並確保高可用性，通常會使用多個節點進行備援。
若要成功建立 AKS Arc 叢集，您必須至少指定一個控制平面節點計數。 此外，若要維護 etcd 仲裁，控制平面節點計數應該是奇數。 如需有關支援計數和 VM SKU 選項的詳細資訊，請參閱 Azure Local 上的 AKS 擴容需求。