Instalar a extensão AKS da Configuração de Aplicativo do Azure

A 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. A extensão de Configuração de Aplicativo do Azure para AKS (Serviço de Kubernetes do Azure) permite que você instale e gerencie o Provedor de Kubernetes de Configuração de Aplicativo do Azure no cluster do AKS por meio do ARM (Azure Resource Manager).

Pré-requisitos

• Uma assinatura do Azure. Criar uma conta gratuita.
• A versão mais recente da CLI do Azure.
• Um cluster do AKS (Serviço de Kubernetes do Azure). Criar um cluster do AKS.
• Permissão com a função de administrador do RBAC do Serviço de Kubernetes do Azure.

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

Instale a extensão da CLI do Azure k8s-extension 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 ser relatado como Registrado, 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 de Configuração de Aplicativo do Azure, que instala o Provedor de Kubernetes de Configuração de Aplicativo do Azure em seu AKS.

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

CLI do Azure

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

Bicep

Crie um modelo Bicep usando o exemplo a seguir.

@description('The name of the Managed Cluster resource.')
param clusterName string

resource existingManagedCluster 'Microsoft.ContainerService/managedClusters@2024-02-01' existing = {
  name: clusterName
}

resource appConfigExtension 'Microsoft.KubernetesConfiguration/extensions@2022-11-01' = {
  name: 'appconfigurationkubernetesprovider'
  scope: existingManagedCluster
  properties: {
    autoUpgradeMinorVersion: true
    configurationSettings: {
      'global.clusterType': 'managedclusters'
    }
    extensionType: 'microsoft.appconfiguration'
  }
}

Implante o modelo Bicep usando o comando az deployment group.

az deployment group create \
  --resource-group myResourceGroup \
  --template-file ./my-bicep-file-path.bicep \
  --parameters clusterName=myAKSCluster

Importante

A extensão AKS da Configuração de Aplicativo do Azure é instalada no azappconfig-system namespace 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 de Configuração de Aplicativo do Azure sem especificar uma versão, --auto-upgrade-minor-versionserá habilitado automaticamente, configurando a extensão configuração de aplicativo do Azure para atualizar automaticamente sua versão secundária em novas versões.

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

CLI do Azure

--auto-upgrade-minor-version false

Bicep

properties {
  autoUpgradeMinorVersion: false
}

Direcionando uma versão específica

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

CLI do Azure

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

Bicep

Crie um modelo Bicep usando o exemplo a seguir.

@description('The name of the Managed Cluster resource.')
param clusterName string

resource existingManagedCluster 'Microsoft.ContainerService/managedClusters@2024-02-01' existing = {
  name: clusterName
}

resource appConfigExtension 'Microsoft.KubernetesConfiguration/extensions@2022-11-01' = {
  name: 'appconfigurationkubernetesprovider'
  scope: existingManagedCluster
  properties: {
    autoUpgradeMinorVersion: false
    configurationSettings: {
      'global.clusterType': 'managedclusters'
    }
    extensionType: 'microsoft.appconfiguration'
    version: '2.1.0'
  }
}

Implante o modelo Bicep usando o comando az deployment group.

az deployment group create \
  --resource-group myResourceGroup \
  --template-file ./my-bicep-file-path.bicep \
  --parameters clusterName=myAKSCluster

Versões da extensão

A extensão de Configuração de Aplicativo do Azure dá suporte à seguinte versão do Provedor de Kubernetes de Configuração de Aplicativo 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, experimente as sugestões e soluções do guia de solução de problemas da extensão Configuração de aplicativos do Azure.

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

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

Excluir a extensão

Se você precisar excluir a extensão e remover o Provedor de Kubernetes de Configuração de Aplicativo do Azure 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

• Saiba mais sobre configurações e preferências extras que você pode definir na extensão de Configuração de Aplicativo do Azure.
• Depois de instalar com êxito a extensão da Configuração de Aplicativos do Azure em seu cluster do AKS, experimente o início rápido para saber como usá-la.
• Veja todos os recursos suportados do Provedor Kubernetes de configuração de aplicativos do Azure.