az acr task

命令

名稱	Description	類型	狀態
az acr task cancel-run	取消 Azure Container Registry 的指定執行。	核心	GA
az acr task create	建立建置、測試和OS和架構修補容器的一系列步驟。 工作支援 Git 認可和基底映射更新的觸發程式。	核心	GA
az acr task credential	管理工作的認證。 如需詳細資訊，請參閱 https://aka.ms/acr/tasks/cross-registry-authentication 。	核心	GA
az acr task credential add	將自訂登錄登入認證新增至工作。	核心	GA
az acr task credential list	列出工作的所有自定義登錄認證。	核心	GA
az acr task credential remove	拿掉工作的認證。	核心	GA
az acr task credential update	更新工作的登錄登入認證。	核心	GA
az acr task delete	從 Azure Container Registry 刪除工作。	核心	GA
az acr task identity	工作的受控識別。 如需詳細資訊，請參閱 https://aka.ms/acr/tasks/task-create-managed-identity 。	核心	GA
az acr task identity assign	更新工作的受控識別。	核心	GA
az acr task identity remove	拿掉工作的受控識別。	核心	GA
az acr task identity show	顯示工作的受控識別。	核心	GA
az acr task list	列出 Azure Container Registry 的工作。	核心	GA
az acr task list-runs	列出 Azure Container Registry 執行的所有執行，並能夠依特定工作進行篩選。	核心	GA
az acr task logs	顯示特定執行的記錄。 如果未提供任何 run-id，則顯示上次建立回合的記錄。	核心	GA
az acr task run	手動觸發可能正在等候 Git 認可或基底映像更新觸發程式的工作。	核心	GA
az acr task show	取得 Azure Container Registry 具名工作的屬性。	核心	GA
az acr task show-run	取得指定之 Azure Container Registry 工作執行的屬性。	核心	GA
az acr task timer	管理工作的定時器觸發程式。	核心	GA
az acr task timer add	將定時器觸發程式新增至工作。	核心	GA
az acr task timer list	列出工作的所有定時器觸發程式。	核心	GA
az acr task timer remove	從工作中移除定時器觸發程式。	核心	GA
az acr task timer update	更新工作的定時器觸發程式。	核心	GA
az acr task update	更新 Azure Container Registry 的工作。	核心	GA
az acr task update-run	修補 Azure Container Registry 工作的執行屬性。	核心	GA

az acr task cancel-run --registry
                       --run-id
                       [--resource-group]

範例

取消執行

az acr task cancel-run -r myregistry --run-id runId

必要參數

選擇性參數

全域參數

--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 task create --name
                   --registry
                   [--agent-pool]
                   [--arg]
                   [--assign-identity]
                   [--auth-mode {Default, None}]
                   [--base-image-trigger-enabled {false, true}]
                   [--base-image-trigger-name]
                   [--base-image-trigger-type {All, Runtime}]
                   [--cmd]
                   [--commit-trigger-enabled {false, true}]
                   [--context]
                   [--cpu]
                   [--file]
                   [--git-access-token]
                   [--image]
                   [--is-system-task]
                   [--log-template]
                   [--no-cache {false, true}]
                   [--no-push {false, true}]
                   [--platform]
                   [--pull-request-trigger-enabled {false, true}]
                   [--resource-group]
                   [--schedule]
                   [--secret-arg]
                   [--set]
                   [--set-secret]
                   [--source-trigger-name]
                   [--status {Disabled, Enabled}]
                   [--target]
                   [--timeout]
                   [--update-trigger-endpoint]
                   [--update-trigger-payload-type {Default, Token}]
                   [--values]

範例

建立沒有來源位置的工作。

az acr task create -n hello-world -r myregistry --cmd '$Registry/myimage' -c /dev/null

使用標準輸入的定義，以及使用預設觸發程式名稱在每小時頂端執行工作的定時器觸發程式，建立工作。 'Ctrl + Z'（Windows） 或 'Ctrl + D'（Linux） 會終止輸入數據流。

cat task.yaml | az acr task create -n hello-world -r myregistry -f - -c /dev/null \
    --schedule "0 */1 * * *"
az acr task create -n hello-world -r myregistry -f - -c /dev/null --schedule "0 */1 * * *"

從公用 GitHub 存放庫建立 Linux 工作，以在沒有觸發程式的情況下建置你好世界映像，並使用組建自變數。

az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry \
    -c https://github.com/Azure/acr-builder.git -f Dockerfile \
    --commit-trigger-enabled false --base-image-trigger-enabled false \
    --arg DOCKER_CLI_BASE_IMAGE=docker:18.03.0-ce-git

使用私人 Azure DevOps 存放庫的特定分支建立 Linux 工作，以在 Arm 架構 （V7 variant） 上建置你好世界映像，並啟用觸發程式。

az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry \
    -c https://msazure.visualstudio.com/DefaultCollection/Project/_git/Repo#Branch:Folder \
    -f Dockerfile --git-access-token <Personal Access Token> --platform linux/arm/v7

從公用 GitHub 存放庫建立 Linux 工作，此存放庫會建置已啟用 git 認可和提取要求觸發程式的你好世界映像。 請注意，此工作不會使用Source Registry （myregistry），因此我們可以明確地將驗證模式設定為 [無]。

az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry  -f Dockerfile \
    --no-push true --auth-mode None -c https://github.com/Azure-Samples/acr-build-helloworld-node.git \
    --pull-request-trigger-enabled true --git-access-token 000000000000000000000000000000000

從公用 GitHub 存放庫建立 Windows 工作，以在 Amd64 架構上建置 Azure Container Builder 映射，且只啟用基底映射觸發程式。

az acr task create -t acb:{{.Run.ID}} -n acb-win -r myregistry \
    -c https://github.com/Azure/acr-builder.git -f Windows.Dockerfile \
    --commit-trigger-enabled false --platform Windows/amd64

使用系統指派和使用者指派的受控識別和基底映射、git 認可、提取要求和定時器觸發程式，從公用 GitHub 存放庫建立 Linux 多步驟工作，以提供定時器觸發程式名稱，於星期一到星期五中午執行工作。

az acr task create -t hello-world:{{.Run.ID}} -n hello-world -r myregistry \
    --pull-request-trigger-enabled true --schedule "dailyTimer:0 12 * * Mon-Fri" \
    -c https://github.com/Azure-Samples/acr-tasks.git#:multipleRegistries -f testtask.yaml \
    --assign-identity [system] "/subscriptions/<subscriptionId>/resourcegroups/<myResourceGroup>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<myUserAssignedIdentitiy>"

必要參數

選擇性參數

全域參數

--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 task delete --name
                   --registry
                   [--resource-group]
                   [--yes]

範例

從 Azure Container Registry 刪除工作。

az acr task delete -n MyTask -r myregistry

必要參數

選擇性參數

全域參數

--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 task list --registry
                 [--resource-group]

範例

列出工作，並在數據表中顯示結果。

az acr task list -r myregistry -o table

必要參數

選擇性參數

全域參數

--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 task list-runs --registry
                      [--image]
                      [--name]
                      [--resource-group]
                      [--run-status {Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout}]
                      [--top]

範例

列出登錄的所有執行，並在數據表中顯示結果。

az acr task list-runs -r myregistry -o table

清單會針對工作執行，並在數據表中顯示結果。

az acr task list-runs -r myregistry -n MyTask -o table

列出登錄的最後 10 次成功執行，並在數據表中顯示結果。

az acr task list-runs -r myregistry --run-status Succeeded --top 10 -o table

列出針對登錄建置映射 『你好-world』 的所有執行，並在數據表中顯示結果。

az acr task list-runs -r myregistry --image hello-world -o table

必要參數

選擇性參數

全域參數

--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 task logs --registry
                 [--image]
                 [--name]
                 [--no-format]
                 [--resource-group]
                 [--run-id]

範例

顯示登錄中上次建立執行的記錄。

az acr task logs -r myregistry

顯示登錄中最後一次建立執行的記錄，並依工作篩選。

az acr task logs -r myregistry -n MyTask

顯示特定執行的記錄。

az acr task logs -r myregistry --run-id runId

在建置映像 『你好-world』 的登錄中顯示上次建立之執行的記錄。

az acr task logs -r myregistry --image hello-world

必要參數

選擇性參數

全域參數

--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 task run --name
                --registry
                [--agent-pool]
                [--arg]
                [--context]
                [--file]
                [--log-template]
                [--no-format]
                [--no-logs]
                [--no-wait]
                [--resource-group]
                [--secret-arg]
                [--set]
                [--set-secret]
                [--target]
                [--update-trigger-token]

範例

觸發工作執行。

az acr task run -n MyTask -r myregistry

使用遠端存放庫覆寫工作建立期間傳遞的內容和檔案，以觸發工作執行。

az acr task run -n MyTask -r myregistry -c https://github.com/Azure-Samples/acr-build-helloworld-node.git -f Dockerfile

使用本機內容覆寫工作建立期間傳遞的內容和檔案，以觸發工作執行。

az acr task run -n MyTask -r myregistry -c . -f Dockerfile

藉由在工作建立期間新增或覆寫建置自變數，以觸發工作執行。

az acr task run -n MyTask -r myregistry --arg DOCKER_CLI_BASE_IMAGE=docker:18.03.0-ce-git

必要參數

選擇性參數

全域參數

--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 task show --name
                 --registry
                 [--resource-group]
                 [--with-secure-properties]

範例

取得工作的屬性，並在數據表中顯示結果。

az acr task show -n MyTask -r myregistry -o table

取得工作的屬性，包括安全屬性。

az acr task show -n MyTask -r myregistry --with-secure-properties

必要參數

選擇性參數

全域參數

--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 task show-run --registry
                     --run-id
                     [--resource-group]

範例

取得執行的詳細數據，並在數據表中顯示結果。

az acr task show-run -r myregistry --run-id runId -o table

必要參數

選擇性參數

全域參數

--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 task update --name
                   --registry
                   [--agent-pool]
                   [--arg]
                   [--auth-mode {Default, None}]
                   [--base-image-trigger-enabled {false, true}]
                   [--base-image-trigger-type {All, Runtime}]
                   [--cmd]
                   [--commit-trigger-enabled {false, true}]
                   [--context]
                   [--cpu]
                   [--file]
                   [--git-access-token]
                   [--image]
                   [--log-template]
                   [--no-cache {false, true}]
                   [--no-push {false, true}]
                   [--platform]
                   [--pull-request-trigger-enabled {false, true}]
                   [--resource-group]
                   [--secret-arg]
                   [--set]
                   [--set-secret]
                   [--status {Disabled, Enabled}]
                   [--target]
                   [--timeout]
                   [--update-trigger-endpoint]
                   [--update-trigger-payload-type {Default, Token}]
                   [--values]

範例

更新基底映射更新，以在多階段 Dockerfile 的所有相依映射上觸發，以及 Azure Container Registry 中工作的狀態。

az acr task update -n MyTask -r myregistry --base-image-trigger-type All --status Disabled

將工作建置步驟的更新平臺更新至 Windows（上一個 Linux）。

az acr task update -n MyTask -r myregistry --platform Windows

更新 Azure Container Registry 的工作觸發程式和內容。

az acr task update -n hello-world -r myregistry -f Dockerfile \
    --commit-trigger-enabled false --pull-request-trigger-enabled true \
    -c https://msazure.visualstudio.com/DefaultCollection/Project/_git/Repo#Branch:Folder

更新 Azure Container Registry 的工作。 （ 自動產生 ）

az acr task update --image MyImage --name MyTask --registry myregistry \
    --context https://github.com/Azure-Samples/acr-build-helloworld-node.git

必要參數

選擇性參數

全域參數

--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 task update-run --registry
                       --run-id
                       [--no-archive {false, true}]
                       [--resource-group]

範例

更新要封存的現有執行。

az acr task update-run -r myregistry --run-id runId --no-archive 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 來取得完整偵錯記錄。