排查 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 反馈社区提交产品反馈。