共用方式為

針對 Azure 應用程式組態擴充功能 (預覽) 安裝錯誤進行疑難解答

  • 發行項

本文討論當您安裝或更新 Microsoft Azure Kubernetes Service (AKS) 的 Azure 應用程式 組態擴充功能時，可能會遇到的一些常見錯誤案例。

注意事項

案例 1：已安裝 Azure 應用程式設定 Kubernetes 提供者

您嘗試安裝適用於 AKS 的 Azure 應用程式組態擴充功能，但會收到錯誤訊息，指出已透過 helm install 命令安裝 Azure 應用程式組態 Kubernetes 提供者。 錯誤訊息可能類似下列其中一個錯誤訊息。

訊息 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”]]] 執行作業時發生：[Create] 在設定上，若要進行一般疑難解答，請造訪： 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」 必須等於 「azureappconfig」：目前值為 “azureappconfiguration.kubernetesprovider”]]] 執行作業時發生：[建立] 在設定上，如需一般疑難解答，請造訪： https://aka.ms/k8s-extensions-TSG。

解決方案 1：先卸載 Azure 應用程式組態 Kubernetes 提供者

安裝 Azure 應用程式組態擴充功能之前，請先卸載 Azure 應用程式組態 Kubernetes 提供者。 如需詳細資訊，請參閱 清除資源。

案例 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 應用程式組態擴充功能無法在所有區域中使用，因此您可能會收到下列錯誤訊息：

(ExtensionTypeRegistrationGetFailed) 延伸模組類型 microsoft.appconfiguration 未在區域 <區域名稱>中註冊。

程序代碼：ExtensionTypeRegistrationGetFailed

訊息：延伸模組類型 microsoft.appconfiguration 未在區域區域 <名稱中註冊>

解決方案3：在不同的區域中安裝

在 支援 Azure 應用程式組態延伸模組的區域中執行安裝。

後續步驟

如果您仍然遇到安裝問題，請流覽 AKS 疑難解答指南。

與我們連絡，以取得說明

如果您有問題或需要相關協助，請建立支援要求，或詢問 Azure community 支援。 您也可以將產品意見反應提交給 Azure 意應見反社群。