Gerenciar revisões nos Aplicativos de Contêiner do Azure
Os Aplicativos de Contêiner do Azure permitem que seu aplicativo de contêiner dê suporte a várias revisões. Com esse recurso, você pode ativar e desativar revisões e controlar a quantidade de tráfego enviado para cada revisão. Para saber mais sobre revisões, consulte Revisões nos Aplicativos de Contêiner do Azure.
Uma revisão é criada quando você implanta seu aplicativo pela primeira vez. Novas revisões são criadas quando você atualiza seu aplicativo com alterações no escopo de revisão. Você também pode atualizar seu aplicativo de contêiner com base em uma revisão específica.
Este artigo descreve os comandos para gerenciar as revisões do seu aplicativo de contêiner. Para mais informações sobre os comandos dos Aplicativos de Contêiner, confira az containerapp. Para obter mais informações sobre comandos para gerenciar revisões, confira az containerapp revision.
Atualizando seu aplicativo de contêiner
Para atualizar um aplicativo de contêiner, use o comando az containerapp update. Com esse comando, você pode modificar variáveis de ambiente, calcular recursos, dimensionar parâmetros e implantar uma imagem diferente. Se a atualização do aplicativo de contêiner incluir alterações no escopo de revisão, uma nova revisão será gerada.
Este exemplo atualiza a imagem do contêiner. Substitua os <ESPAÇOS RESERVADOS> pelos seus valores.
az containerapp update \
--name <APPLICATION_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--image <IMAGE_NAME>
Você também pode atualizar seu aplicativo de contêiner com o comando Cópia de revisão.
Lista de Revisão
Lista todas as revisões associadas ao seu aplicativo de contêiner com az containerapp revision list. Para obter mais informações sobre esse comando, confira az containerapp revision list
Substitua os <ESPAÇOS RESERVADOS> pelos seus valores.
az containerapp revision list \
--name <APPLICATION_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
-o table
Mostrar revisão
Mostrar os detalhes sobre uma revisão específica usando o comando az containerapp revision show.
Substitua os <ESPAÇOS RESERVADOS> pelos seus valores.
az containerapp revision show \
--name <APPLICATION_NAME> \
--revision <REVISION_NAME> \
--resource-group <RESOURCE_GROUP_NAME>
Copiar revisão
Para criar uma revisão com base em outra existente, use o az containerapp revision copy. Os aplicativos de contêiner usam a configuração da revisão existente, que você pode modificar.
Com esse comando, você pode modificar variáveis de ambiente, calcular recursos, dimensionar parâmetros e implantar uma imagem diferente. Você também pode usar um arquivo YAML para definir essas e outras opções e parâmetros de configuração. Para obter mais informações sobre esse comando, confira az containerapp revision copy.
Este exemplo copia a revisão mais recente e define os parâmetros do recurso de computação. (Substitua os <ESPAÇOS RESERVADOS> pelos seus valores).
az containerapp revision copy \
--name <APPLICATION_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--cpu 0.75 \
--memory 1.5Gi
Ativar revisão
Ative uma revisão usando o comando az containerapp revision activate.
Exemplo: (substitua os <ESPAÇOS RESERVADOS> pelos seus valores).
az containerapp revision activate \
--revision <REVISION_NAME> \
--resource-group <RESOURCE_GROUP_NAME>
Desativar revisão
Desative as revisões que não estão mais em uso com o comando az containerapp revision deactivate. A desativação interrompe todas as réplicas em execução de uma revisão.
Exemplo: (substitua os <ESPAÇOS RESERVADOS> pelos seus valores).
az containerapp revision deactivate \
--revision <REVISION_NAME> \
--resource-group <RESOURCE_GROUP_NAME>
Reinicializar revisão
O comando az containerapp revision restart reinicia uma revisão.
Quando você modifica segredos no aplicativo de contêiner, precisa reiniciar as revisões ativas para que elas possam acessar os segredos.
Exemplo: (substitua os <ESPAÇOS RESERVADOS> pelos seus valores).
az containerapp revision restart \
--revision <REVISION_NAME> \
--resource-group <RESOURCE_GROUP_NAME>
Definir modo da revisão
O modo de revisão controla se apenas uma revisão ou várias revisões do seu aplicativo de contêiner podem estar ativas simultaneamente. Para definir seu aplicativo de contêiner a fim de dar suporte ao modo de revisão única ou ao modo de revisão múltipla, use o comando az containerapp revision set-mode.
A configuração padrão é o modo de revisão única. Para obter mais informações sobre esse comando, consulte az containerapp revision set-mode.
Os valores do modo são single ou multiple. Alterar o modo de revisão não cria uma revisão do zero.
Exemplo: (substitua os <ESPAÇOS RESERVADOS> pelos seus valores).
Exemplo: (substitua os <ESPAÇOS RESERVADOS> pelos seus valores).
az containerapp revision set-mode \
--name <APPLICATION_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--mode <REVISION_MODE>
Rótulos de revisão
Os rótulos fornecem uma URL exclusiva que você pode usar para direcionar o tráfego para uma revisão. Você pode mover um rótulo entre revisões para redirecionar o tráfego direcionado à URL do rótulo para uma revisão diferente. Para mais informações sobre rótulos de revisão, confira Rótulos de Revisão.
Você pode adicionar e remover um rótulo em uma revisão. Para mais informações sobre os comandos do rótulo, confira az containerapp revision label
Adicionar rótulo de revisão
Para adicionar um rótulo a uma revisão, use o comando az containerapp revision label add.
Você só pode atribuir um rótulo a uma revisão por vez e cada revisão só pode ter um rótulo atribuído a ela. Se a revisão que você especificar tiver um rótulo, o comando add substituirá o rótulo existente.
Este exemplo adiciona um rótulo a uma revisão: (substitua os <ESPAÇOS RESERVADOS> pelos seus valores).
az containerapp revision label add \
--revision <REVISION_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--label <LABEL_NAME>
Remover rótulo de revisão
Para remover um rótulo de uma revisão, use o comando az containerapp revision label remove.
Este exemplo remove um rótulo em uma revisão: (substitua os <ESPAÇOS RESERVADOS> pelos seus valores).
az containerapp revision label remove \
--revision <REVISION_NAME> \
--resource-group <RESOURCE_GROUP_NAME> \
--label <LABEL_NAME>
Separação de tráfego
Aplicado por meio da atribuição de valores percentuais, você pode decidir como balancear o tráfego entre revisões diferentes. As regras de divisão de tráfego são atribuídas definindo pesos para diferentes revisões por seu nome ou rótulo. Para obter mais informações, consulte Divisão de Tráfego.