Manage revisions in Azure Container Apps

Supporting multiple revisions in Azure Container Apps allows you to manage the versioning of your container app. With this feature, you can activate and deactivate revisions, and control the amount of traffic sent to each revision. To learn more about revisions, see Revisions in Azure Container Apps

A revision is created when you first deploy your application. New revisions are created when you update your application with revision-scope changes. You can also update your container app based on a specific revision.

This article described the commands to manage your container app's revisions. For more information about Container Apps commands, see az containerapp. For more information about commands to manage revisions, see az containerapp revision.

Updating your container app

To update a container app, use the az containerapp update command. With this command you can modify environment variables, compute resources, scale parameters, and deploy a different image. If your container app update includes revision-scope changes, a new revision is generated.

Bash

You can also use a YAML file to define these and other configuration options and parameters. For more information regarding this command, see az containerapp revision copy.

This example updates the container image. Replace the <PLACEHOLDERS> with your values.

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

PowerShell

Replace the <Placeholders> with your values.

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

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

You can also update your container app with the Revision copy command.

Revision list

List all revisions associated with your container app with az containerapp revision list. For more information about this command, see az containerapp revision list

Bash

Replace the <PLACEHOLDERS> with your values.

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

PowerShell

Replace the <Placeholders> with your values.

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

Get-AzContainerAppRevision @CmdArgs

Revision show

Show details about a specific revision by using az containerapp revision show. For more information about this command, see az containerapp revision show.

Bash

Replace the <PLACEHOLDERS> with your values.

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

PowerShell

Replace the <Placeholders> with your values.

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

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

Revision copy

To create a new revision based on an existing revision, use the az containerapp revision copy. Container Apps uses the configuration of the existing revision, which you can then modify.

With this command, you can modify environment variables, compute resources, scale parameters, and deploy a different image. You can also use a YAML file to define these and other configuration options and parameters. For more information regarding this command, see az containerapp revision copy.

This example copies the latest revision and sets the compute resource parameters. (Replace the <PLACEHOLDERS> with your values.)

Bash

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

PowerShell

The following example demonstrates how to copy a container app revision using the Azure CLI command. There isn't an equivalent PowerShell command.

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

Revision activate

Activate a revision by using az containerapp revision activate. For more information about this command, see az containerapp revision activate.

Bash

Example: (Replace the <PLACEHOLDERS> with your values.)

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

PowerShell

Example: (Replace the <Placeholders> with your values.)

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

Enable-AzContainerAppRevision @CmdArgs

Revision deactivate

Deactivate revisions that are no longer in use with az containerapp revision deactivate. Deactivation stops all running replicas of a revision. For more information, see az containerapp revision deactivate.

Bash

Example: (Replace the <PLACEHOLDERS> with your values.)

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

PowerShell

Example: (Replace the <Placeholders> with your values.)

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

Disable-AzContainerAppRevision @CmdArgs

Revision restart

This command restarts a revision. For more information about this command, see az containerapp revision restart.

When you modify secrets in your container app, you need to restart the active revisions so they can access the secrets.

Bash

Example: (Replace the <PLACEHOLDERS> with your values.)

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

PowerShell

Example: (Replace the <Placeholders> with your values.)

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

Restart-AzContainerAppRevision @CmdArgs

Revision set mode

The revision mode controls whether only a single revision or multiple revisions of your container app can be simultaneously active. To set your container app to support single revision mode or multiple revision mode, use the az containerapp revision set-mode command.

The default setting is single revision mode. For more information about this command, see az containerapp revision set-mode.

The mode values are single or multiple. Changing the revision mode doesn't create a new revision.

Example: (Replace the <placeholders> with your values.)

Bash

Example: (Replace the <PLACEHOLDERS> with your values.)

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

PowerShell

Example: (Replace the <Placeholders> with your values.)

$CmdArgs = @{
  Name = '<ContainerAppName>'
  ResourceGroupName = '<ResourceGroupName>'
  Location = '<Location>'
  ConfigurationActiveRevisionMode = '<RevisionMode>'
}

Update-AzContainerApp @CmdArgs

Revision labels

Labels provide a unique URL that you can use to direct traffic to a revision. You can move a label between revisions to reroute traffic directed to the label's URL to a different revision. For more information about revision labels, see Revision Labels.

You can add and remove a label from a revision. For more information about the label commands, see az containerapp revision label

Revision label add

To add a label to a revision, use the az containerapp revision label add command.

You can only assign a label to one revision at a time, and a revision can only be assigned one label. If the revision you specify has a label, the add command replaces the existing label.

This example adds a label to a revision: (Replace the <PLACEHOLDERS> with your values.)

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>

Revision label remove

To remove a label from a revision, use the az containerapp revision label remove command.

This example removes a label to a revision: (Replace the <PLACEHOLDERS> with your values.)

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>

Traffic splitting

Applied by assigning percentage values, you can decide how to balance traffic among different revisions. Traffic splitting rules are assigned by setting weights to different revisions by their name or label. For more information, see, Traffic Splitting.

Next steps

• Revisions in Azure Container Apps
• Application lifecycle management in Azure Container Apps