針對擴充功能安裝錯誤進行疑難解答 Azure 應用程式組態
本文討論您在安裝或更新 Microsoft Azure Kubernetes Service （AKS） Azure 應用程式組態 擴充功能時可能會遇到的一些常見錯誤案例。
注意
如果已成功安裝 Azure 應用程式組態 擴充功能，但在使用時遇到問題，請參閱 Azure 應用程式組態 Kubernetes 提供者疑難解答指南。
案例 1：已安裝 kubernetes 提供者 Azure 應用程式組態
您嘗試安裝 AKS 的 Azure 應用程式組態 擴充功能，但收到錯誤訊息，指出已透過 helm install 命令安裝 Azure 應用程式組態 Kubernetes Provider。 錯誤訊息可能類似下列任一錯誤訊息。
訊息 1
（ExtensionOperationFailed）擴充作業失敗，發生下列錯誤：錯誤： [ InnerError： [Helm 安裝失敗：叢集中已經存在的資源：建議手動刪除您叢集中 目前存在的資源，然後再試一次安裝。 若要刪除這些資源，請執行下列命令：
kubectl delete {resource type} -n {resource namespace} {resource name}：InnerError [轉譯的指令清單包含已經存在的資源。 無法繼續安裝：命名空間 「中的 CustomResourceDefinition 」azureappconfigurationproviders.azconfig.io「存在，且無法匯入目前版本：無效的擁有權元數據;註釋驗證錯誤：索引鍵 「meta.helm.sh/release-name」 必須等於 “azureappconfig”： 目前的值為 “azureappconfiguration.kubernetesprovider”;批註驗證錯誤： 索引鍵 「meta.helm.sh/release-namespace」 必須等於 「kube-system」： 目前的值為 “azappconfig-system”]]]，執行作業時發生 ：[建立]，如需一般疑難解答，請造訪： https://aka.ms/k8s-extensions-TSG。
訊息 2
（ExtensionOperationFailed）擴充作業失敗，發生下列錯誤：錯誤： [ InnerError： [Helm 安裝失敗：叢集中已經存在的資源：建議手動刪除您叢集中 目前存在的資源，然後再試一次安裝。 若要刪除這些資源，請執行下列命令：
kubectl delete {resource type} -n {resource namespace} {resource name}：InnerError [轉譯的指令清單包含已經存在的資源。 無法繼續安裝：命名空間 “azappconfig-system” 中的 ServiceAccount “az-appconfig-k8s-provider” 存在，且無法匯入至目前的版本：無效的擁有權元數據;批注驗證錯誤：金鑰 「meta.helm.sh/release-name」 必須等於 「azureappconfigconfigconfig」： 目前的值為 “azureappconfiguration.kubernetesprovider”]]] 執行作業時發生：[建立]，如需一般疑難解答流覽： https://aka.ms/k8s-extensions-TSG。
解決方案 1：先卸載 kubernetes Provider Azure 應用程式組態
安裝 Azure 應用程式組態 擴充功能之前，請先卸載 Azure 應用程式組態 Kubernetes Provider。 如需詳細資訊，請參閱清除資源。
案例 2：目標 Azure 應用程式組態 擴充功能版本不存在
當您嘗試安裝 Azure 應用程式組態 擴充功能以鎖定特定版本時，您會收到錯誤訊息，指出 Azure 應用程式組態 版本不存在：
（ExtensionOperationFailed）擴充作業失敗，發生下列錯誤： 無法從指定的值解析擴充功能版本。 如需一般疑難解答，請參閱 https://aka.ms/k8s-extension-type-versions 尋找安裝的正確版本： https://aka.ms/k8s-extensions-TSG。
程序代碼：ExtensionOperationFailed
訊息：擴充作業失敗，發生下列錯誤： 無法從指定的值解析擴充功能版本。 如需一般疑難解答，請參閱 https://aka.ms/k8s-extension-type-versions 尋找安裝的正確版本： https://aka.ms/k8s-extensions-TSG。
解決方案 2：針對支援的 Azure 應用程式組態 擴充功能版本再次安裝
請再試一次，以安裝延伸模組。 請確定您使用支援的 Azure 應用程式組態 擴充功能版本。
案例 3：目標 Azure 應用程式組態 延伸模組版本存在，但不在指定的區域中
因為 Azure 應用程式組態 擴充功能無法在所有 AKS 區域中使用，您可能會收到下列錯誤訊息：
（ExtensionTypeRegistrationGetFailed）擴充功能類型 microsoft.appconfiguration 未在區域 <區域名稱>中註冊。
程序代碼：ExtensionTypeRegistrationGetFailed
訊息：擴充功能類型 microsoft.appconfiguration 未在區域區域 <名稱中註冊>
解決方案3：在不同的區域中安裝
在 叢集擴充功能支援的區域中 執行安裝。
下一步
如果您仍然遇到安裝問題，請流覽 AKS 疑難解答指南。
與我們連絡，以取得說明
如果您有問題或需要相關協助，請建立支援要求，或詢問 Azure community 支援。 您也可以向 Azure 意見反應社群提交產品意見反應。