排查 Azure 应用配置扩展 (预览版) 安装错误
本文讨论在安装或更新 Microsoft Azure Kubernetes 服务的 Azure 应用配置扩展 (AKS) 时可能会遇到的一些常见错误方案。
注意
此问题仅适用于扩展的预览版。
如果已成功安装 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 [呈现的清单包含已存在的资源。 无法继续安装：命名空间“”中的 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”必须等于“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 未在 region-name <>中注册。
代码：ExtensionTypeRegistrationGetFailed
消息：未在区域 <区域名称中注册扩展类型 microsoft.appconfiguration>
解决方案 3：在不同区域中安装
在 支持 Azure 应用配置扩展的区域运行安装。
后续步骤
如果仍然遇到安装问题，请浏览 AKS 故障排除指南。
联系我们寻求帮助
如果你有任何疑问或需要帮助，请创建支持请求或联系 Azure 社区支持。 还可以向 Azure 反馈社区提交产品反馈。