Extensão de Configuração de Aplicativo do Azure para o Serviço Kubernetes do Azure

A Configuração de Aplicativo do Azure fornece um serviço para gerenciar centralmente as configurações do aplicativo e os sinalizadores de recursos. O Provedor Kubernetes de Configuração de Aplicativo do Azure é um operador do Kubernetes que obtém valores de chave, referências do Cofre de Chaves e sinalizadores de recursos da Configuração de Aplicativo do Azure e os cria em ConfigMaps e Segredos do Kubernetes. A extensão de Configuração de Aplicativo do Azure para o Serviço Kubernetes do Azure (AKS) permite que você instale e gerencie o Provedor Kubernetes de Configuração de Aplicativo do Azure em seu cluster AKS por meio do Azure Resource Manager (ARM).

Pré-requisitos

• Uma subscrição do Azure. Não tem um? Crie uma conta gratuita.
• Instale a versão mais recente da CLI do Azure.
• Se você ainda não tem um, você precisa criar um cluster AKS.
• Verifique se você tem uma função de administrador RBAC do Serviço Kubernetes do Azure

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

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

az extension add --name k8s-extension

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

az extension update --name k8s-extension

Registrar o provedor de KubernetesConfiguration recursos

Se você não tiver usado extensões de cluster anteriormente, talvez seja necessário registrar o provedor de recursos com sua assinatura. Você pode verificar o status do registro do 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 relatar como Registered, conforme mostrado na saída de exemplo a seguir:

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

Se o provedor mostrar como NotRegistered, registre o provedor usando o registro do provedor az, conforme mostrado no exemplo a seguir:

az provider register --namespace Microsoft.KubernetesConfiguration

Instale a extensão no seu cluster AKS

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

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

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

@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'
  }
}

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

Configurar as 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-version será habilitada automaticamente, configurando a extensão de 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 --auto-upgrade-minor-version parâmetro e definindo o valor como false.

--auto-upgrade-minor-version false

properties {
  autoUpgradeMinorVersion: false
}

Segmentação de uma versão específica

O mesmo argumento de linha de comando é usado para instalar uma versão específica do Provedor 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 Kubernetes de Configuração de Aplicativo do Azure que você deseja instalar. Se o version parâmetro 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

@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'
  }
}

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

Versões de extensão

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

• 2.1.0
• 2.0.0

Solucionar erros de instalação de extensão

Se a extensão falhar ao criar ou atualizar, tente sugestões e soluções no guia de solução de problemas da extensão de Configuração do Aplicativo Azure.

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

Solucione problemas de erros do Provedor Kubernetes de Configuração do 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 Kubernetes de Configuração do Aplicativo do Azure do cluster AKS, poderá usar o seguinte comando:

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

Passos Seguintes

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