Instalar a extensão do AKS para o Configuração de Aplicativos do Azure

Configuração de Aplicativos do Azure fornece um serviço para gerenciar centralmente as configurações do aplicativo e os sinalizadores de recursos. Provedor de Kubernetes de Configuração de Aplicativos do Azure é um operador do Kubernetes que obtém valores-chave, referências do Key Vault e sinalizadores de recursos da Configuração de Aplicativos do Azure e os cria em ConfigMaps e segredos do Kubernetes. Extensão Configuração de Aplicativos do Azure para AKS (Serviço de Kubernetes do Azure) permite que você instale e gerencie o Provedor Kubernetes do Configuração de Aplicativos do Azure no seu cluster AKS por meio do Azure Resource Manager (ARM).

Pré-requisitos

Configurar a extensão CLI do Azure para extensões de cluster

Instale a extensão k8s-extension CLI do Azure executando os seguintes comandos:

az extension add --name k8s-extension

Se a extensão k8s-extension já estiver instalada, você poderá atualizá-la para a versão mais recente usando o comando seguinte:

az extension update --name k8s-extension

Registrar o provedor de recursos KubernetesConfiguration

Se você ainda não usou extensões de cluster, talvez seja necessário registrar o provedor de recursos com sua assinatura. Você pode verificar o status do registro de provedor usando o comando az provider list, conforme mostrado no exemplo a seguir:

az provider list --query "[?namespace=='Microsoft.KubernetesConfiguration']" -o table

O provedor Microsoft.KubernetesConfiguration deve constar como Registered, conforme mostrado na seguinte saída de exemplo:

Namespace                          RegistrationState    RegistrationPolicy
---------------------------------  -------------------  --------------------
Microsoft.KubernetesConfiguration  Registered           RegistrationRequired

Se o provedor é exibido como NotRegistered, registre o provedor usando az provider register conforme mostrado no exemplo a seguir:

az provider register --namespace Microsoft.KubernetesConfiguration

Instalar a extensão no cluster do AKS

Crie a extensão Configuração de Aplicativos do Azure, que instala Configuração de Aplicativos do Azure Provedor de Kubernetes em seu AKS.

Por exemplo, instale a versão mais recente do Provedor de Kubernetes do Configuração de Aplicativos do Azure por meio da extensão Configuração de Aplicativos do Azure no cluster do AKS:

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration

Importante

A extensão do AKS Configuração de Aplicativos do Azure é instalada no namespace azappconfig-system por padrão. Se você tiver atribuições do Azure Policy que validam ou alteram as especificações do pod (por exemplo, a política integrada "Os clusters do Kubernetes devem desabilitar as credenciais da API de montagem automática", que impõe automountServiceAccountToken: false), exclua o namespace azappconfig-system dessas políticas, adicionando-o à lista de exclusão de namespace da política para que a extensão funcione corretamente. Não excluí-lo pode fazer com que os pods da extensão falhem na validação ou pareçam não estar em conformidade.

Configurar atualizações automáticas

Se você criar a extensão Configuração de Aplicativos do Azure sem especificar uma versão, --auto-upgrade-minor-version será habilitada automaticamente, configurando a extensão Configuração de Aplicativos do Azure para atualizar automaticamente sua versão menor em novos lançamentos.

Você pode desabilitar a atualização automática especificando o parâmetro --auto-upgrade-minor-version definindo o valor como false.

--auto-upgrade-minor-version false

Direcionando uma versão específica

O mesmo argumento de linha de comando é usado para instalar uma versão específica do Configuração de Aplicativos do Azure Kubernetes Provider ou reverter para uma versão anterior. Defina --auto-upgrade-minor-version como false e --version para a versão do Provedor de Kubernetes Configuração de Aplicativos do Azure que você deseja instalar. Se o parâmetro version for omitido, a extensão instalará a versão mais recente.

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration \
    --auto-upgrade-minor-version false
    --version 2.1.0

Versões da extensão

A extensão Configuração de Aplicativos do Azure dá suporte à seguinte versão do Provedor de Kubernetes Configuração de Aplicativos do Azure:

  • 2.1.0
  • 2.0.0

Solucionar problemas de erros de instalação de extensão

Se a extensão não conseguir criar ou atualizar, tente sugestões e soluções no guia de solução de problemas de extensão Configuração de Aplicativos do Azure.

Solucionar problemas do Configuração de Aplicativos do Azure Provedor de Kubernetes

Solucione erros de Configuração de Aplicativos do Azure do Provedor Kubernetes por meio do guia de solução de problemas .

Excluir a extensão

Se você precisar excluir a extensão e remover Configuração de Aplicativos do Azure Provedor de Kubernetes do cluster do AKS, poderá usar o seguinte comando:

az k8s-extension delete --resource-group myResourceGroup --cluster-name myAKSCluster --cluster-type managedClusters --name appconfigurationkubernetesprovider

Próximas etapas

  • Last updated on