Extensão de configuração de aplicativo do Azure para o serviço Azure Kubernetes

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 Aplicativo do Azure é um operador 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 no Kubernetes ConfigMaps and Secrets. 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. Não tem uma? Crie uma conta gratuita.
• Instale a versão mais recente da CLI do Azure.
• Se você ainda não tiver um locatário, precisará criar um cluster do AKS.
• Verifique se você tem uma função de Administrador 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

Configurar atualizações automáticas

Se você criar uma extensão de Configuração de Aplicativos do Azure sem especificar uma versão, --auto-upgrade-minor-version será habilitada automaticamente, configurando a extensão da Configuração de Aplicativos do Azure para atualizar automaticamente sua versão secundária 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.

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.0.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.0.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.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 Aplicativo 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.