排查Azure 应用程序配置扩展安装错误
本文讨论在安装或更新 Microsoft Azure Kubernetes 服务 （AKS） 的 Azure 应用程序配置 扩展时可能会遇到的一些常见错误方案。
注意
如果已成功安装Azure 应用程序配置扩展，但在使用时遇到问题，请参阅 Azure 应用程序配置 Kubernetes 提供程序故障排除指南。
方案 1：已安装 Azure 应用程序配置 Kubernetes 提供程序
尝试为 AKS 安装 Azure 应用程序配置 扩展，但会收到一条错误消息，指示已通过helm install命令安装 Azure 应用程序配置 Kubernetes 提供程序。 错误消息可能类似于以下任一错误消息。
消息 1
（ExtensionOperationFailed）扩展操作失败并出现以下错误：错误： [ InnerError： [Helm 安装失败：群集 中已存在的资源：建议手动删除群集中当前存在的资源，然后重试安装。 若要删除这些资源，请运行以下命令：
kubectl delete {resource type} -n {resource namespace} {resource name}InnerError [呈现的清单包含已存在的资源。 无法继续安装：命名空间“azureappconfigurationproviders.azconfig.io”中的 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”必须等于“azureappconfigconfig”：当前值为“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 应用程序配置扩展在所有 AKS 区域中不可用，因此可能会收到以下错误消息：
（ExtensionTypeRegistrationGetFailed）扩展类型 microsoft.appconfiguration 未在区域区域 <名称>中注册。
代码：ExtensionTypeRegistrationGetFailed
消息：扩展类型 microsoft.appconfiguration 未在区域区域 <名称中注册>
解决方案 3：在不同的区域中安装
在群集扩展支持的区域中运行安装。
后续步骤
如果仍遇到安装问题，请浏览 AKS 故障排除指南。
联系我们寻求帮助
如果你有任何疑问或需要帮助，请创建支持请求或联系 Azure 社区支持。 你还可以将产品反馈提交到 Azure 反馈社区。