Rótulos de implantação nos Aplicativos de Contêiner do Azure

Os rótulos de implantação ajudam você a atribuir nomes significativos, como desenvolvimento, preparo ou prod, a revisões de contêiner específicas. Ao aplicar esses nomes, você simplifica o tratamento de cenários de implantação complexos e gerenciamento de ambiente.

Usando rótulos de implantação, você pode:

  • Atribua rótulos claros e descritivos a revisões.
  • Atribua automaticamente novas revisões a rótulos para roteamento e gerenciamento de tráfego.
  • Direcionar o tráfego com base em rótulos em vez de alterar os nomes das revisões.
  • Promova ou rebaixe revisões reatribuindo rótulos.
  • Reverter para revisões anteriores utilizando o histórico de rótulos.

Importante

Antes de usar rótulos de implantação, você precisa seguir as etapas para primeiro habilitar os rótulos de implantação no portal do seu aplicativo de contêiner.

Características principais

Os rótulos de implantação permitem que você crie estratégias de implantação sofisticadas, mantendo o controle sobre o ciclo de vida do aplicativo usando os seguintes recursos:

  • Atribuição de Rótulo: Crie e atribua rótulos significativos às revisões de contêiner, facilitando o gerenciamento de ambientes como desenvolvimento, homologação e produção.

  • Divisão de tráfego e teste A/B: o suporte para divisão de tráfego, reversão cega e teste A/B permite distribuições graduais e testes de novos recursos.

  • Versões de teste & Troca automática: a ativação automática de revisões permite que você crie novas revisões sem problemas e as atribua a rótulos novos ou existentes para receber tráfego. Revisões que não são mais referenciadas por um rótulo são encerradas automaticamente.

Usar rótulos de implantação

Por padrão, os rótulos de implantação não estão disponíveis para seu aplicativo de contêiner. Para habilitar os rótulos de implantação, siga estas etapas no portal do Azure:

  1. Abra o aplicativo de contêiner no portal do Azure.

  2. No menu, na seção Aplicativo , selecione Revisões e réplicas.

  3. Selecione o modo de implantação.

  4. Selecione a coluna Rótulos de implantação .

  5. Selecione Aplicar.

Criar um novo rótulo

Crie novos rótulos no portal com base em rótulos existentes. Por padrão, os Aplicativos de Contêiner criam seu primeiro rótulo chamado label-1. Ao criar rótulos por meio da CLI ou do Bicep, você pode associá-los a qualquer revisão existente ou uma nova revisão.

  1. Abra o aplicativo de contêiner no portal do Azure.

  2. No menu, na seção Aplicativo , selecione Rótulos.

  3. Selecione Novo rótulo.

  4. Selecione o rótulo existente no qual você deseja basear seu novo rótulo.

  5. Insira o novo nome do rótulo na caixa de texto.

  6. Selecione Duplicar.

Histórico de rótulos e reversões

Você pode exibir o histórico completo de um rótulo usando as seguintes etapas:

  1. Abra o aplicativo de contêiner no portal do Azure.

  2. No menu, em Aplicativo, selecione Rótulos.

  3. Selecione Mostrar histórico para o rótulo no qual você está interessado.

Use a opção Mostrar histórico para qualquer rótulo para:

  • Examine o histórico de revisão do rótulo.
  • Reverta para uma revisão anterior apontando o rótulo para uma revisão de contêiner diferente.

Usar rótulos de implantação

Para habilitar os rótulos de implantação, siga estas etapas na CLI do Azure:

  1. Abra o terminal.

  2. Crie as variáveis de ambiente a seguir.

     CONTAINER_APP_NAME="my-container-app"
 CONTAINER_APP_IMAGE="mcr.microsoft.com/k8se/quickstart:latest"
 LOCATION="centralus"
 RESOURCE_GROUP="my-container-apps-rg"
 ENVIRONMENT_NAME="my-container-apps-env"
 TARGET_LABEL="stage"

  3. Use o seguinte comando para criar um novo aplicativo e revisão com o rótulo:

    az containerapp create \
--name $CONTAINER_APP_NAME \
--resource-group $RESOURCE_GROUP \
--image $CONTAINER_APP_IMAGE \
--environment $ENVIRONMENT_NAME \
--location $LOCATION \
--ingress external \
--target-port 0 \
--revisions-mode labels \
--target-label $TARGET_LABEL

  4. Para criar uma nova revisão com um rótulo novo ou existente, use o seguinte comando:

    az containerapp update \
--name $CONTAINER_APP_NAME \
--resource-group $RESOURCE_GROUP \
--image $CONTAINER_APP_IMAGE \
--target-label $TARGET_LABEL

  5. Para mostrar o histórico de rótulos, use o seguinte comando:

    az containerapp label-history show \
--name $CONTAINER_APP_NAME \
--resource-group $RESOURCE_GROUP \
--label $TARGET_LABEL

  6. Para mostrar o tráfego de aplicativo de rótulo, use o seguinte comando:

    az containerapp ingress traffic show \
--name $CONTAINER_APP_NAME \
--resource-group $RESOURCE_GROUP \

  7. Para adicionar um rótulo a uma revisão, use os seguintes comandos:

    az containerapp revision label add \
--name $CONTAINER_APP_NAME \
--resource-group $RESOURCE_GROUP \
--revision $REVISION_NAME \
--label $TARGET_LABEL

  8. Para remover um rótulo de uma revisão, use os seguintes comandos:

    az containerapp revision label remove \
--name $CONTAINER_APP_NAME \
--resource-group $RESOURCE_GROUP \
--label $TARGET_LABEL

Cenários com suporte

  • Implantações azul-verde: Gerencie facilmente as implementações azul-verde rotulando e alternando entre revisões. Essa abordagem fornece uma maneira simples de lidar com trocas de ambiente completas.

  • Teste A/B: direcione um percentual de tráfego para revisões diferentes para teste de recursos. Essa prática permite validar a nova funcionalidade com um subconjunto de usuários antes da implantação completa.

  • Distribuições em etapas: aumente gradualmente o tráfego para uma nova revisão ajustando os percentuais de tráfego.

  • Isolamento de ambiente: use rótulos para manter ambientes separados de desenvolvimento, homologação e produção. Cada ambiente pode ser atualizado de forma independente, mantendo um caminho de promoção claro.

Exemplo de fluxo de trabalho

Aqui está um fluxo de trabalho típico usando rótulos de implantação:

  1. Crie rótulos iniciais: crie rótulos como "estágio" e "produção" apontando para a mesma revisão inicialmente.

  2. Atualizar um rótulo: selecione um rótulo (por exemplo, "stage") para atualizá-lo com novos contêineres, dimensionamento ou configurações de volume.

  3. Teste as alterações: com a nova revisão implantada, encaminhe uma parte do tráfego para o rótulo atualizado.

  4. Promover alterações: quando tiver certeza da revisão de produção, atualize a etiqueta de produção para apontar para a mesma revisão.

  5. Monitore e reverta se necessário: caso surjam problemas, utilize o histórico de rótulos para reverter para uma versão anterior.

Conteúdo relacionado

Rótulos de revisão

  • Última atualização em