Gerenciar revisões em Aplicativos de Contêiner do Azure

Os Aplicativos de Contêiner do Azure permitem que seu aplicativo de contêiner ofereça 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 em 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 aplicativo contêiner. Para obter mais informações sobre comandos de aplicativos de contêiner, consulte az containerapp. Para obter mais informações sobre comandos para gerenciar revisões, consulte az containerapp revision.

Atualizando seu aplicativo de contêiner

Para atualizar um aplicativo de contêiner, use o az containerapp update comando. Com este comando, você pode modificar variáveis de ambiente, recursos de computação, parâmetros de escala 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

Liste todas as revisões associadas ao seu aplicativo de contêiner com az containerapp revision listo . Para obter mais informações sobre esse comando, consulte 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

Show de revisão

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

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

Cópia de revisão

Para criar uma nova revisão com base em uma revisão existente, use o az containerapp revision copy. Container Apps usa a configuração da revisão existente, que você pode modificar.

Com esse comando, você pode modificar variáveis de ambiente, recursos de computação, 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, consulte az containerapp revision copy.

Este exemplo copia a revisão mais recente e define os parâmetros do recurso de computação. (Substitua a seringa <ESPAÇOS RESERVADOS> com os 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 CLI do Azure. Não há um comando equivalente do PowerShell.

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

Revisão ativada

Ative uma revisão usando o az containerapp revision activate comando.

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

Revisão desativada

Desative as revisões que não estão mais em uso com o az containerapp revision deactivate comando. 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

Reinício da revisão

O az containerapp revision restart comando reinicia uma revisão.

Quando você modifica segredos em seu aplicativo de contêiner, precisa reiniciar as revisões ativas para que eles 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

Modo de conjunto de revisão

O modo de revisão controla se apenas uma única revisão ou várias revisões do seu aplicativo de contêiner podem estar ativas simultaneamente. Para definir seu aplicativo contêiner para oferecer suporte ao modo de revisão única ou múltipla, use o az containerapp revision set-mode comando.

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 de modo são single ou multiple. Alterar o modo de revisão não cria uma nova revisão.

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 um URL exclusivo 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 para o URL do rótulo para uma revisão diferente. Para obter mais informações sobre rótulos de revisão, consulte Rótulos de revisão.

Você pode adicionar e remover um rótulo de uma revisão. Para obter mais informações sobre os comandos label, consulte az containerapp revision label

Adicionar rótulo de revisão

Para adicionar um rótulo a uma revisão, use o az containerapp revision label add comando.

Você só pode atribuir um rótulo a uma revisão de cada vez, e uma revisão só pode ser atribuída a um rótulo. Se a revisão especificada 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>

Rótulo de revisão remover

Para remover um rótulo de uma revisão, use o az containerapp revision label remove comando.

Este exemplo remove um rótulo para 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>

Divisão de tráfego

Aplicado atribuindo valores percentuais, você pode decidir como equilibrar o tráfego entre diferentes revisões. 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óximos passos

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