az acr pipeline-run

注意

此參考是 Azure CLI 的 acrtransfer 延伸模組的一部分 （2.0.67 版或更高版本）。 擴充功能會在您第一次執行 az acr pipeline-run 命令時自動安裝。 深入了解擴充功能。

此命令群組處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

管理 ACR 匯入和匯出管線執行。

命令

名稱	Description	類型	狀態
az acr pipeline-run clean	刪除登錄上所有失敗的管線執行。	擴充	預覽版
az acr pipeline-run create	建立管線執行。	擴充	預覽版
az acr pipeline-run delete	刪除管線執行。	擴充	預覽版
az acr pipeline-run list	列出容器登錄上所有管線的管線執行。	擴充	預覽版
az acr pipeline-run show	詳細顯示管線執行。	擴充	預覽版

az acr pipeline-run clean

預覽

命令群組 'acr pipeline-run' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

刪除登錄上所有失敗的管線執行。

az acr pipeline-run clean --registry
                          --resource-group
                          [--dry-run]

範例

刪除登錄上所有失敗的管線執行。

az acr pipeline-run clean --resource-group $MyRG --registry $MyReg

列出已刪除但不會刪除任何失敗的管線執行。

az acr pipeline-run clean --resource-group $MyRG --registry $MyReg --dry-run -o table

必要參數

--registry -r

登錄的名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

選擇性參數

--dry-run

列出已刪除但不會刪除任何失敗的管線執行。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az acr pipeline-run create

預覽

命令群組 'acr pipeline-run' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

建立管線執行。

az acr pipeline-run create --name
                           --pipeline
                           --pipeline-type
                           --registry
                           --resource-group
                           --storage-blob
                           [--artifacts]
                           [--force-redeploy]

範例

建立匯入管線執行。

az acr pipeline-run create --resource-group $MyRG --registry $MyReg --pipeline $MyPipeline --name $MyPipelineRunName --pipeline-type import --storage-blob $MyBlob

建立匯出管線執行並強制重新部署。

az acr pipeline-run create --resource-group $MyRG --registry $MyReg --pipeline $MyPipeline --name $MyPipelineRunName --pipeline-type export --storage-blob $MyBlob --artifacts hello-world:latest hello-world@sha256:90659bf80b44ce6be8234e6ff90a1ac34acbeb826903b02cfa0da11c82cbc042 --force-redeploy

必要參數

--name -n

管線執行的名稱。

--pipeline -p

要執行的管線名稱。

--pipeline-type -t

管線的類型。 必須是匯入或匯出。

--registry -r

登錄的名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--storage-blob -b

要匯入或匯出的儲存體 Blob 名稱。

選擇性參數

--artifacts -a

容器成品的空間分隔清單。 成品必須是表單 repository:tag 或例如 hello-world：latest 或 repository@digest hello-world@sha256：90659bf80b44ce6be8234e6ff90a1ac34acbeb826903b02cfa0da11c82cbc042。

--force-redeploy -f

即使沒有任何參數變更，仍會強制 ARM 重新部署資源的旗標。

預設值: False

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az acr pipeline-run delete

預覽

命令群組 'acr pipeline-run' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

刪除管線執行。

az acr pipeline-run delete --name
                           --registry
                           --resource-group

範例

刪除管線執行。

az acr pipeline-run delete --resource-group $MyRG --registry $MyReg --name $MyPipelineRun

必要參數

--name -n

管線執行的名稱。

--registry -r

登錄的名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az acr pipeline-run list

預覽

命令群組 'acr pipeline-run' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

列出容器登錄上所有管線的管線執行。

az acr pipeline-run list --registry
                         --resource-group
                         [--top]

範例

列出容器登錄上的所有管線執行

az acr pipeline-run list --resource-group $MyRG --registry $MyReg

必要參數

--registry -r

登錄的名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

選擇性參數

--top

只列出最後 n 個管線執行。 必須是整數。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az acr pipeline-run show

預覽

命令群組 'acr pipeline-run' 處於預覽狀態，且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

詳細顯示管線執行。

az acr pipeline-run show --name
                         --registry
                         --resource-group

範例

詳細顯示特定管線執行。

az acr pipeline-run show --resource-group $MyRG --registry $MyReg --name $MyPipelineRun

必要參數

--name -n

管線執行的名稱。

--registry -r

登錄的名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

全域參數

--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc

預設值: json

--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。