Solucionar problemas de erros de instalação da extensão da Configuração de Aplicativos do Azure

Este artigo discute alguns cenários de erro comuns que você pode encontrar ao instalar ou atualizar a extensão da Configuração de Aplicativos do Azure para o AKS (Serviço de Kubernetes do Microsoft Azure).

Observação

Se a extensão da Configuração de Aplicativos do Azure foi instalada com êxito, mas você tiver problemas ao usá-la, consulte o guia de solução de problemas do Provedor de Kubernetes da Configuração de Aplicativos do Azure.

Cenário 1: o Provedor de Kubernetes da Configuração de Aplicativos do Azure já está instalado

Você tenta instalar a extensão da Configuração de Aplicativos do Azure para o AKS, mas recebe uma mensagem de erro que indica que o Provedor de Kubernetes da Configuração de Aplicativos do Azure já está instalado por meio do helm install comando. A mensagem de erro pode ser semelhante a uma das mensagens de erro a seguir.

Mensagem 1

(ExtensionOperationFailed) A operação de extensão falhou com o seguinte erro: Erro: [ InnerError: [Falha na instalação do Helm: Recurso já existente no cluster : Recomendação Exclua manualmente os recursos que existem atualmente no cluster e tente instalar novamente. Para excluir esses recursos, execute os seguintes comandos: kubectl delete {resource type} -n {resource namespace} {resource name} : InnerError [manifestos renderizados contêm um recurso que já existe. Não é possível continuar com a instalação: CustomResourceDefinition "azureappconfigurationproviders.azconfig.io" no namespace "" existe e não pode ser importado para a versão atual: metadados de propriedade inválidos; Erro de validação de anotação: a chave "meta.helm.sh/release-name" deve ser igual a "AzureAppConfig": o valor atual é "AzureAppConfiguration.kubernetesProvider"; erro de validação de anotação: a chave "meta.helm.sh/release-namespace" deve ser igual a "kube-system": o valor atual é "azappconfig-system"]]] ocorreu ao fazer a operação: [Criar] na configuração, para solução de problemas gerais, visite: https://aka.ms/k8s-extensions-TSG.

Mensagem 2

(ExtensionOperationFailed) A operação de extensão falhou com o seguinte erro: Erro: [ InnerError: [Falha na instalação do Helm: Recurso já existente no cluster : Recomendação Exclua manualmente os recursos que existem atualmente no cluster e tente instalar novamente. Para excluir esses recursos, execute os seguintes comandos: kubectl delete {resource type} -n {resource namespace} {resource name} : InnerError [manifestos renderizados contêm um recurso que já existe. Não é possível continuar com a instalação: ServiceAccount "az-appconfig-k8s-provider" no namespace "azappconfig-system" existe e não pode ser importado para a versão atual: metadados de propriedade inválidos; erro de validação de anotação: a chave "meta.helm.sh/release-name" deve ser igual a "azureappconfig": o valor atual é "azureappconfiguration.kubernetesprovider"]]] ocorreu ao fazer a operação: [Criar] na configuração, para solução de problemas gerais, visite: https://aka.ms/k8s-extensions-TSG.

Solução 1: Desinstalar primeiro o Provedor de Kubernetes da Configuração de Aplicativos do Azure

Desinstale o Provedor de Kubernetes da Configuração de Aplicativos do Azure antes de instalar a extensão da Configuração de Aplicativos do Azure. Para saber mais, confira Limpar recursos.

Cenário 2: a versão de extensão da Configuração de Aplicativos do Azure de destino não existe

Ao tentar instalar a extensão da Configuração de Aplicativos do Azure para direcionar uma versão específica, você recebe uma mensagem de erro informando que a versão da Configuração de Aplicativos do Azure não existe:

(ExtensionOperationFailed) A operação de extensão falhou com o seguinte erro: Falha ao resolver a versão da extensão dos valores fornecidos. https://aka.ms/k8s-extension-type-versions Consulte para encontrar a versão correta para sua instalação, Para solução de problemas gerais, visite: https://aka.ms/k8s-extensions-TSG.

Código: ExtensionOperationFailed

Mensagem: A operação de extensão falhou com o seguinte erro: Falha ao resolver a versão da extensão dos valores fornecidos. https://aka.ms/k8s-extension-type-versions Consulte para encontrar a versão correta para sua instalação, Para solução de problemas gerais, visite: https://aka.ms/k8s-extensions-TSG.

Solução 2: instalar novamente para uma versão de extensão da Configuração de Aplicativos do Azure com suporte

Tente novamente instalar a extensão. Certifique-se de usar uma versão com suporte da extensão da Configuração de Aplicativos do Azure.

Cenário 3: a versão de extensão da Configuração de Aplicativos do Azure de destino existe, mas não na região especificada

Como a extensão da Configuração de Aplicativos do Azure não está disponível em todas as regiões do AKS, você pode receber a seguinte mensagem de erro:

(ExtensionTypeRegistrationGetFailed) O tipo de extensão microsoft.appconfiguration não está registrado no <nome> da região region.

Código: ExtensionTypeRegistrationGetFailed

Mensagem: O tipo de extensão microsoft.appconfiguration não está registrado no <nome da região>

Solução 3: Instalar em uma região diferente

Execute a instalação em uma região compatível com a extensão de cluster.

Próximas etapas

Se você ainda tiver problemas de instalação, explore o guia de solução de problemas do AKS.

Entre em contato conosco para obter ajuda

Se você tiver dúvidas ou precisar de ajuda, crie uma solicitação de suporte ou peça ajuda à comunidade de suporte do Azure. Você também pode enviar comentários sobre o produto para a comunidade de comentários do Azure.