Configurar a extensão da Configuração de Aplicativos do Azure para o Serviço de Kubernetes do Azure

Artigo
09/10/2024

Depois de criar a extensão da Configuração de Aplicativos do Azure, você poderá configurar a extensão para funcionar melhor para você e o seu projeto usando várias opções de configuração, como:

Configurando a contagem de réplicas.
Configurando o detalhamento de log.
Configurando o namespace de instalação.

A extensão permite que você defina as configurações de extensão da Configuração de Aplicativo do Azure usando o parâmetro --configuration-settings na CLI do Azure.

Dica

Para obter uma lista das opções disponíveis, confira os valores do helm do Provedor do Kubernetes da Configuração de Aplicativos do Azure.

Configurar a contagem de réplicas

A contagem de réplicas padrão é 1. Criar a extensão de Configuração de Aplicativos do Azure com a contagem de réplicas personalizada:

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration \
    --auto-upgrade-minor-version true \
    --configuration-settings "replicaCount=3"

Observação

Se as definições de configuração forem confidenciais e precisarem ser protegidas (por exemplo, informações relacionadas ao certificado), passe o parâmetro --configuration-protected-settings e o valor será protegido contra leitura.

Configurar o detalhamento de log

O detalhamento de log padrão é 1. Criar a extensão de Configuração de Aplicativos do Azure com o detalhamento de log personalizado:

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration \
    --auto-upgrade-minor-version true \
    --configuration-settings "logVerbosity=3"

Os níveis de detalhamento de log seguem a convenção klog:

0: somente aviso e erro.
1: informativo, este é o nível padrão.
2: informações de estado estável detalhadas.
3: informações estendidas sobre alterações.
4: detalhamento de nível de depuração.
5: detalhamento de nível de rastreamento.

Configurar o namespace de extensão da Configuração de Aplicativos do Azure

A extensão de Configuração de Aplicativo do Azure é instalada no namespace azappconfig-system por padrão. Para substituí-la, use --release-namespace. Inclua o cluster --scope para redefinir o namespace.

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration \
    --auto-upgrade-minor-version true \
    --scope cluster \
    --release-namespace custom-namespace

Mostrar definições de configuração atuais

Use o comando az k8s-extension show para mostrar as configurações de extensão atuais da Configuração de Aplicativos do Azure:

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

Atualizar definições de configuração

Para atualizar as configurações de extensão da Configuração de Aplicativos do Azure, recrie a extensão com o estado desejado. Por exemplo, suponha que instalamos a extensão usando a seguinte configuração:

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration \
    --auto-upgrade-minor-version true \  
    --configuration-settings "replicaCount=2"

Para atualizar de replicaCount dois para três, use o seguinte comando:

az k8s-extension create --cluster-type managedClusters \
    --cluster-name myAKSCluster \
    --resource-group myResourceGroup \
    --name appconfigurationkubernetesprovider \
    --extension-type Microsoft.AppConfiguration \
    --auto-upgrade-minor-version true \
    --configuration-settings "replicaCount=3"

Próximas etapas

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.

Compartilhar via