管理 Azure Container Apps 中的修訂

Azure 容器應用程式允許你的容器應用程式支援多個版本。透過此功能，你可以啟動和停用修訂，並控制每個修訂的流量。欲了解更多關於修訂的資訊，請參閱 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

修訂標籤

標籤提供一個獨特的網址，你可以用來引導流量到修訂版。你可以在版本間移動標籤，將指向該標籤網址的流量重新導向到不同的版本。欲了解更多修訂標籤資訊，請參閱修訂標籤。

你可以在修訂版中新增或移除標籤。關於標籤指令的更多資訊，請參見 az containerapp revision label

新增修訂標籤

要在修訂版上加上標籤，請使用指令 az containerapp revision label add 。

你一次只能為一個版本分配標籤，而修訂版只能被指定一個標籤。如果你指定的版本有標籤，add 指令會替換現有標籤。

這個範例會在修訂版上加上一個標籤：（將 <PLACEHOLDERS> 替換為你的值。）

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 。

此範例會從修訂中移除標籤：(請將 <PLACEHOLDERS> 替換為您的值)。

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>

流量切分

藉由指派百分比值來套用，您可以決定如何在不同修訂之間平衡流量。流量分割規則，是藉由依名稱或標籤，對不同修訂設定權數來指派。更多資訊請參見「流量分割」。

下一步

意見反應

此頁面對您有幫助嗎？

上次更新時間： 2026-03-29

管理 Azure Container Apps 中的修訂

更新您的容器應用程式

修訂清單

顯示修訂

修訂版

啟用修訂

停用修訂

修訂過程重啟

修訂集模式

修訂標籤

新增修訂標籤

修訂標籤移除

流量切分

下一步

意見反應

其他資源