Administración de revisiones en Azure Container Apps

Azure Container Apps permite que la aplicación contenedora admita varias revisiones. Con esta característica, puede activar y desactivar revisiones y controlar la cantidad de tráfico que se envía a cada revisión. Para obtener más información sobre las revisiones, consulte Revisiones en Azure Container Apps.

Se crea una revisión al implementar la aplicación por primera vez. Se crean nuevas revisiones al actualizar la aplicación con cambios en el ámbito de revisión. También puede actualizar la aplicación de contenedor en función de una revisión específica.

En este artículo se describen los comandos para administrar las revisiones de la aplicación contenedora. Para obtener más información sobre los comandos de Container Apps, consulte az containerapp. Para obtener más información sobre los comandos para administrar revisiones, consulte az containerapp revision.

Actualización de la aplicación de contenedor

Para actualizar una aplicación de contenedor, use el comando az containerapp update. Con este comando puede modificar variables de entorno, recursos de proceso y parámetros de escalado e implementar una imagen diferente. Si la actualización de la aplicación de contenedor incluye cambios en el ámbito de revisión, se genera una nueva revisión.

Bash

En este ejemplo se actualiza la imagen de contenedor. Reemplace los <PLACEHOLDERS> por sus valores.

az containerapp update \
  --name <APPLICATION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --image <IMAGE_NAME>

PowerShell

Reemplace los <PLACEHOLDERS> por sus valores.

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

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

También puede actualizar la aplicación de contenedor con el comando Revision copy.

Revision list

Enumera todas las revisiones asociadas a la instancia de Container Apps con az containerapp revision list. Para obtener más información sobre este comando, consulte az containerapp revision list.

Bash

Reemplace los <PLACEHOLDERS> por sus valores.

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

PowerShell

Reemplace los <PLACEHOLDERS> por sus valores.

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

Get-AzContainerAppRevision @CmdArgs

Revision show

Muestre detalles sobre una revisión específica usando el comando az containerapp revision show.

Bash

Reemplace los <PLACEHOLDERS> por sus valores.

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

PowerShell

Reemplace los <PLACEHOLDERS> por sus valores.

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

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

Revision copy

Para crear una revisión basada en una revisión existente, use az containerapp revision copy. Container Apps usa la configuración de la revisión existente, que puede modificar.

Con este comando puede modificar variables de entorno, recursos de proceso y parámetros de escalado e implementar una imagen diferente. También puede usar un archivo YAML para definir estas y otras opciones de configuración y parámetros. Para obtener más información sobre este comando, consulte az containerapp revision copy.

En este ejemplo se copia la revisión más reciente y se establecen los parámetros del recurso de proceso. (Reemplace los <PLACEHOLDERS> por sus valores.)

Bash

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

PowerShell

En el ejemplo siguiente se muestra cómo copiar una revisión de la aplicación contenedora mediante el comando de la CLI de Azure. No hay un comando equivalente de PowerShell.

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

Revision activate

Active una revisión mediante el comando az containerapp revision activate.

Bash

Ejemplo: (Reemplace los <PLACEHOLDERS> por sus valores.)

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

PowerShell

Ejemplo: (Reemplace los <PLACEHOLDERS> por sus valores.)

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

Enable-AzContainerAppRevision @CmdArgs

Revision deactivate

Desactive las revisiones que ya no están en uso con el comando az containerapp revision deactivate. La desactivación detiene todas las réplicas en ejecución de una revisión.

Bash

Ejemplo: (Reemplace los <PLACEHOLDERS> por sus valores.)

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

PowerShell

Ejemplo: (Reemplace los <PLACEHOLDERS> por sus valores.)

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

Disable-AzContainerAppRevision @CmdArgs

Revision restart

El comando az containerapp revision restart reinicia una revisión.

Al modificar secretos en la aplicación de contenedor, debe reiniciar las revisiones activas para que puedan acceder a los secretos.

Bash

Ejemplo: (Reemplace los <PLACEHOLDERS> por sus valores.)

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

PowerShell

Ejemplo: (Reemplace los <PLACEHOLDERS> por sus valores.)

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

Restart-AzContainerAppRevision @CmdArgs

Revision set mode

El modo de revisión controla si una sola revisión o varias revisiones de su aplicación de contenedor pueden estar activas simultáneamente. Para establecer la aplicación de contenedor de forma que admita el modo de revisión única o el modo de revisión múltiple, use el comando az containerapp revision set-mode.

El valor predeterminado es el modo de revisión única. Para obtener más información acerca de este comando, vea az containerapp revision set-mode.

Los valores del modo son single o multiple. Si cambia el modo de revisión, no se creará una nueva revisión.

Ejemplo: (Reemplace los <PLACEHOLDERS> por sus valores.)

Bash

Ejemplo: (Reemplace los <PLACEHOLDERS> por sus valores.)

az containerapp revision set-mode \
  --name <APPLICATION_NAME> \
  --resource-group <RESOURCE_GROUP_NAME> \
  --mode <REVISION_MODE>

PowerShell

Ejemplo: (Reemplace los <PLACEHOLDERS> por sus valores.)

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

Update-AzContainerApp @CmdArgs

Etiquetas de revisión

Las etiquetas proporcionan una dirección URL única que puede usar para dirigir el tráfico a una revisión. Puede mover una etiqueta entre revisiones para reenrutar a una revisión diferente el tráfico que está dirigido a la dirección URL de la etiqueta. Para obtener más información sobre las etiquetas de revisión, consulte Etiquetas de revisión.

Puede agregar y quitar una etiqueta de una revisión. Para obtener más información sobre los comandos de etiqueta, consulte az containerapp revision label.

Adición de etiquetas de revisión

Para agregar una etiqueta a una revisión, use el comando az containerapp revision label add.

Solo se puede asignar una etiqueta a una revisión de cada vez y solo se puede asignar una etiqueta a una revisión. Si la revisión especificada tiene una etiqueta, el comando de adición reemplaza la etiqueta existente.

En este ejemplo se agrega una etiqueta a una revisión: (Reemplace los <PLACEHOLDERS> por sus 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>

Eliminación de etiquetas de revisión

Para quitar una etiqueta de una revisión, use el comando az containerapp revision label remove.

En este ejemplo se quita una etiqueta de una revisión: (Reemplace los <PLACEHOLDERS> por sus 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>

División del tráfico

Se aplica mediante la asignación de valores de porcentaje, con los cuales puede decidir cómo equilibrar el tráfico entre diferentes revisiones. Las reglas de división de tráfico se asignan estableciendo ponderaciones a distintas revisiones por su nombre o etiqueta. Para más información, consulte División del tráfico.

Pasos siguientes

• Revisiones de Azure Container Apps
• Administración del ciclo de vida de las aplicaciones en Azure Container Apps