管理 Azure 容器應用程式中的修訂版本

Azure Container Apps 可讓您的容器應用程式支援多個修訂。 透過這項功能，您可以啟用和停用修訂，並控制傳送至每個修訂的流量量。 若要深入瞭解修訂，請參閱 Azure Container Apps 中的修訂。

當您第一次部署應用程式時，就會建立修訂。 當您使用修訂範圍變更更新應用程式時，會建立新的修訂。 您也可以根據特定修訂來更新容器應用程式。

本文說明管理容器應用程式修訂的命令。 如需 Container Apps 命令的詳細資訊，請參閱 az containerapp。 如需管理修訂之命令的詳細資訊，請參閱 az containerapp revision。

更新您的容器應用程式

若要更新容器應用程式，請使用 az containerapp update 命令。 使用此命令，您可以修改環境變數、計算資源、調整參數，以及部署不同的映像。 如果您的容器應用程式更新包含 修訂範圍變更，將會產生新的修訂。

Bash

此範例會更新容器映像。 將 <PLACEHOLDERS> 取代為您的值。

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

PowerShell

將 <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

將 <PLACEHOLDERS> 取代為您的值。

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

PowerShell

將 <PLACEHOLDERS> 取代為您的值。

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

Get-AzContainerAppRevision @CmdArgs

修訂顯示

使用 az containerapp revision show 命令顯示特定修訂的詳細數據。

Bash

將 <PLACEHOLDERS> 取代為您的值。

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

PowerShell

將 <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。 Container Apps 會使用現有修訂的組態，然後您可以加以修改。

使用此命令，您可以修改環境變數、計算資源、調整參數，以及部署不同的映像。 您也可以使用 YAML 檔案來定義這些和其他組態選項和參數。 如您需要此指令的詳細資訊，請參閱 az containerapp revision copy。

此範例會複製最新的修訂，並設定計算資源參數。 （取代<>使用您的值佔位元。

Bash

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

PowerShell

下列範例示範如何使用 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

範例：（以 <您的值取代佔位符> 。）

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

PowerShell

範例：（以 <您的值取代佔位符> 。）

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

Enable-AzContainerAppRevision @CmdArgs

修訂停用

停用不再與 命令搭配 az containerapp revision deactivate 使用的修訂。 停用會停止修訂的所有執行中複本。

Bash

範例：（以 <您的值取代佔位符> 。）

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

PowerShell

範例：（以 <您的值取代佔位符> 。）

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

Disable-AzContainerAppRevision @CmdArgs

修訂重新啟動

命令 az containerapp revision restart 會重新啟動修訂。

當您在容器應用程式中修改秘密時，您必須重新啟動作用中的修訂，以便他們可以存取秘密。

Bash

範例：（以 <您的值取代佔位符> 。）

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

PowerShell

範例：（以 <您的值取代佔位符> 。）

$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

範例：（以 <您的值取代佔位符> 。）

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

PowerShell

範例：（以 <您的值取代佔位符> 。）

$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 命令會取代現有的標籤。

本範例會將標籤新增至修訂：（將 PLACEHOLDERS> 取代<為您的值。

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>

修訂標籤移除

若要從修訂中移除標籤，請使用 az containerapp revision label remove 命令。

此範例會移除修訂的標籤：（以您的值取代 <PLACEHOLDERS> ）。

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>

流量分割

藉由指派百分比值來套用，您可以決定如何平衡不同修訂之間的流量。 流量分割規則會藉由依名稱或 標籤將權數設定為不同的修訂來指派。 如需詳細資訊，請參閱 流量分割。

下一步

• Azure Container Apps 中的修訂
• Azure 容器應用程式中的應用程式生命週期管理