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.

Bash

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>

PowerShell

Substitua os <ESPAÇOS RESERVADOS> pelos seus valores.

$ImageParams = @{
    Name = '<ContainerName>'
    Image = 'mcr.microsoft.com/k8se/quickstart'
}
$TemplateObj = New-AzContainerAppTemplateObject @ImageParams

$UpdateArgs = @{
  Name = '<ApplicationName>'
  ResourceGroupName = '<ResourceGroupName>'
  Location = '<Location>'
}
Update-AzContainerApp @UpdateArgs

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

Bash

Substitua os <ESPAÇOS RESERVADOS> pelos seus valores.

az containerapp revision list \
  --name <APPLICATION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  -o table

PowerShell

Substitua os <ESPAÇOS RESERVADOS> pelos seus valores.

$CmdArgs = @{
  ContainerAppName = '<CONTAINER_APP_NAME>'
  ResourceGroupName = '<RESOURCE_GROUP_NAME>'
}

Get-AzContainerAppRevision @CmdArgs

Mostrar revisão

Mostrar os detalhes sobre uma revisão específica usando o comando az containerapp revision show.

Bash

Substitua os <ESPAÇOS RESERVADOS> pelos seus valores.

az containerapp revision show \
  --name <APPLICATION_NAME> \
  --revision <REVISION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME>

PowerShell

Substitua os <ESPAÇOS RESERVADOS> pelos seus valores.

$CmdArgs = @{
  ContainerAppName = '<CONTAINER_APP_NAME>'
  ResourceGroupName = '<RESOURCE_GROUP_NAME>'
  RevisionName = '<REVISION_NAME>'
}

$RevisionObject = (Get-AzContainerAppRevision @CmdArgs) | Select-Object -Property *
echo $RevisionObject

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).

Bash

az containerapp revision copy \
  --name <APPLICATION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --cpu 0.75 \
  --memory 1.5Gi

PowerShell

O exemplo a seguir demonstra como copiar uma revisão de aplicativo de contêiner usando o comando da CLI do Azure. Não há um comando PowerShell equivalente.

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.

Bash

Exemplo: (substitua os <ESPAÇOS RESERVADOS> pelos seus valores).

az containerapp revision activate \
  --revision <REVISION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME>

PowerShell

Exemplo: (substitua os <ESPAÇOS RESERVADOS> pelos seus valores).

$CmdArgs = @{
  ContainerAppName = '<CONTAINER_APP_NAME>'
  ResourceGroupName = '<RESOURCE_GROUP_NAME>'
  RevisionName = '<REVISION_NAME>'
}

Enable-AzContainerAppRevision @CmdArgs

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.

Bash

Exemplo: (substitua os <ESPAÇOS RESERVADOS> pelos seus valores).

az containerapp revision deactivate \
  --revision <REVISION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME>

PowerShell

Exemplo: (substitua os <ESPAÇOS RESERVADOS> pelos seus valores).

$CmdArgs = @{
  ContainerAppName = '<CONTAINER_APP_NAME>'
  ResourceGroupName = '<RESOURCE_GROUP_NAME>'
  RevisionName = '<REVISION_NAME>'
}

Disable-AzContainerAppRevision @CmdArgs

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.

Bash

Exemplo: (substitua os <ESPAÇOS RESERVADOS> pelos seus valores).

az containerapp revision restart \
  --revision <REVISION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME>

PowerShell

Exemplo: (substitua os <ESPAÇOS RESERVADOS> pelos seus valores).

$CmdArgs = @{
  ContainerAppName = '<CONTAINER_APP_NAME>'
  ResourceGroupName = '<RESOURCE_GROUP_NAME>'
  RevisionName = '<REVISION_NAME>'
}

Restart-AzContainerAppRevision @CmdArgs

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).

Bash

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>

PowerShell

Exemplo: (substitua os <ESPAÇOS RESERVADOS> pelos seus valores).

$CmdArgs = @{
  Name = '<CONTAINER_APP_NAME>'
  ResourceGroupName = '<RESOURCE_GROUP_NAME>'
  Location = '<LOCATION>'
  ConfigurationActiveRevisionMode = '<REVISION_MODE>'
}

Update-AzContainerApp @CmdArgs

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).

Bash

az containerapp revision label add \
  --revision <REVISION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --label <LABEL_NAME>

PowerShell

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).

Bash

az containerapp revision label remove \
  --revision <REVISION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --label <LABEL_NAME>

PowerShell

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.

Próximas etapas

• Revisões em Aplicativos de Contêiner do Azure
• Gerenciamento de ciclo de vida do aplicativo nos Aplicativos de Contêiner do Azure