管理Azure Container Apps中的修订

Azure Container Apps允许容器应用支持多个修订。使用此功能，可以激活和停用修订，并控制发送到每个修订的流量量。若要了解有关修订的详细信息，请参阅 Azure 容器应用中的修订。

首次部署应用程序时会创建修订。使用修订范围更改更新应用程序时，会创建新的修订。还可以根据特定修订版更新容器应用。

本文介绍用于管理容器应用的修订的命令。有关容器应用命令的详细信息，请参阅 az containerapp。有关用于管理修订的命令的详细信息，请参阅 az containerapp revision。

更新容器应用

若要更新容器应用，请使用 az containerapp update 命令。使用此命令，可以修改环境变量、计算资源、缩放参数和部署其他映像。如果容器应用更新包含修订范围更改，则生成新的修订。

Bash
PowerShell

此示例更新容器映像。将 <PLACEHOLDERS> 替换为你的值。

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

将 <PLACEHOLDERS> 替换为你的值。

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

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

还可以使用 “修订复制 ”命令更新容器应用。

修订列表

列出与容器应用 az containerapp revision list关联的所有修订。有关此命令的详细信息，请参阅 az containerapp revision list

Bash
PowerShell

将 <PLACEHOLDERS> 替换为你的值。

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

将 <PLACEHOLDERS> 替换为你的值。

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

Get-AzContainerAppRevision @CmdArgs

显示修订内容

使用 az containerapp revision show 命令显示有关特定修订的详细信息。

Bash
PowerShell

将 <PLACEHOLDERS> 替换为你的值。

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

将 <PLACEHOLDERS> 替换为你的值。

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

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

修订副本

若要基于现有修订创建新修订，请使用 az containerapp revision copy. 容器应用使用现有修订的配置，然后可以对其进行修改。

使用此命令，可以修改环境变量、计算资源、缩放参数和部署其他映像。还可以使用 YAML 文件来定义这些和其他配置选项和参数。有关此命令的详细信息，请参阅 az containerapp revision copy。

此示例复制最新修订并设置计算资源参数。请用您的值替换<占位符>。

Bash
PowerShell

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

以下示例演示如何使用 Azure CLI 命令复制容器应用修订。没有等效的 PowerShell 命令。

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

修订开启

使用 az containerapp revision activate 命令激活修订。

Bash
PowerShell

示例：（将 <占位符> 替换为你的值。）

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

示例：（将 <占位符> 替换为你的值。）

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

Enable-AzContainerAppRevision @CmdArgs

修订停用

使用 az containerapp revision deactivate 命令停用不再使用的修订。停用会停止修订版本的所有正在运行的实例。

Bash
PowerShell

示例：（将 <占位符> 替换为你的值。）

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

示例：（将 <占位符> 替换为你的值。）

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

Disable-AzContainerAppRevision @CmdArgs

修订过程重启

该 az containerapp revision restart 命令将重启修订。

在容器应用中修改机密时，需要重启当前的修订版本，以便其可以访问机密。

Bash
PowerShell

示例：（将 <占位符> 替换为你的值。）

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

示例：（将 <占位符> 替换为你的值。）

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

Restart-AzContainerAppRevision @CmdArgs

修订集模式

修订模式控制容器应用的单个修订还是多个修订可以同时处于活动状态。若要将容器应用设置为支持单一修订模式或多个修订模式，请使用 az containerapp revision set-mode 该命令。

默认设置为 单一修订模式。有关此命令的详细信息，请参阅 az containerapp revision set-mode。

模式值为 single 或 multiple。更改修订模式不会创建新的修订。

示例：（将 <占位符> 替换为你的值。）

Bash
PowerShell

示例：（将 <占位符> 替换为你的值。）

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

示例：（将 <占位符> 替换为你的值。）

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

Update-AzContainerApp @CmdArgs

修订标签

标签提供一个唯一的 URL，您可以用它来引导流量到修订版本。可以在不同的修订间移动标签，以将定向到标签的 URL 的流量重新路由到其他修订。有关修订标签的详细信息，请参阅修订标签。

可以从修订中添加和删除标签。有关标签命令的详细信息，请参阅 az containerapp revision label

修订标签添加

若要将标签添加到修订，请使用 az containerapp revision label add 命令。

您只能一次将一个标签分配给一个修订，并且一个修订只能被分配一个标签。如果指定的修订具有标签，则 add 命令将替换现有标签。

本示例向修订中添加标签：（将 <占位符> 替换为你的值）。

Bash
PowerShell

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

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

删除修订标签

若要从修订中删除标签，请使用 az containerapp revision label remove 命令。

此示例将删除指向修订的标签：（将 <占位符> 替换为你的值。）

Bash
PowerShell

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

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

流量分流

通过分配百分比值来应用，可以决定如何在不同修订之间平衡流量。流量拆分规则是通过为不同版本或标签设置权重来指定的。有关详细信息，请参阅流量拆分。

后续步骤

Last updated on 2026-04-17

共用方式為

管理Azure Container Apps中的修订

更新容器应用

修订列表

显示修订内容

修订副本

修订开启

修订停用

修订过程重启

修订集模式

修订标签

修订标签添加

删除修订标签

流量分流

后续步骤

其他資源