共用方式為


az acr task

使用 Azure 容器登錄管理建置、測試和 OS 和架構修補容器映像的步驟集合。

命令

名稱 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

取消 Azure Container Registry 的指定執行。

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

範例

取消執行

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

必要參數

--registry -r

容器登錄的名稱。 它應該以小寫指定。 您可以使用 來設定預設登錄名稱 az configure --defaults acr=<registry name>

--run-id

唯一的執行標識碼。

選擇性參數

--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 task create

建立建置、測試和OS和架構修補容器的一系列步驟。 工作支援 Git 認可和基底映射更新的觸發程式。

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

必要參數

--name -n

工作的名稱。

--registry -r

容器登錄的名稱。 它應該以小寫指定。 您可以使用 來設定預設登錄名稱 az configure --defaults acr=<registry name>

選擇性參數

--agent-pool
預覽

代理程式集區的名稱。

--arg

'--arg name[=value]' 格式的組建自變數。 多次傳遞 '--arg name[=value]' 來支援倍數。 重要:此參數不應包含任何種類的密碼、存取令牌或敏感性資訊。 ACR 小組將會看見此參數值以供偵錯之用。

--assign-identity

將受控識別指派給工作。 使用 '[system]' 來參考系統指派的身分識別或資源標識符,以參考使用者指派的身分識別。 如需詳細資訊,請參閱 https://aka.ms/acr/tasks/task-create-managed-identity

--auth-mode

來源登錄的驗證模式。

接受的值: Default, None
--base-image-trigger-enabled

指出是否啟用基底映像觸發程式。

接受的值: false, true
預設值: True
--base-image-trigger-name

基底映像觸發程序的名稱。

預設值: defaultBaseimageTriggerName
--base-image-trigger-type

基底映像相依性更新的自動觸發程序類型。

接受的值: All, Runtime
預設值: Runtime
--cmd

要執行的命令。 這也支援其他 Docker 執行參數 (https://docs.docker.com/engine/reference/commandline/run/) 或甚至其他 Docker 命令 (https://docs.docker.com/engine/reference/commandline/docker/)。

--commit-trigger-enabled

指出是否啟用原始檔控制認可觸發程式。

接受的值: false, true
預設值: True
--context -c

原始程式碼存放庫的完整 URL(需要 github 存放庫的 '.git' 後綴)或遠端 tarball(例如 ''http://server/context.tar.gz),或 Azure 容器登錄中 OCI 成品的存放庫(例如'oci://myregistry.azurecr.io/myartifact:mytag')。 如果指定 『/dev/null』,則值會設定為 None 並忽略。 如果工作不是系統工作,則這是必要的自變數。

--cpu

針對執行所需的核心數目,CPU 組態。

預設值: 2
--file -f

工作/docker 檔案至原始程式碼根資料夾的相對路徑。 工作檔案必須以 『.yaml』 後綴,或使用 『-』 從標準輸入使用管道傳送。

--git-access-token

用來存取原始檔控制提供者的存取令牌。

--image -t

影像的名稱和標記,其格式為:『-t 存放庫/image:tag』。 傳遞 -t 多次支援多個標記。

--is-system-task
預覽

指出工作資源是否為系統工作。 工作的名稱必須是 『quicktask』。 僅適用於已啟用 CMK 的登錄。

預設值: False
--log-template
預覽

使用 'log/repo:tag' 格式執行記錄成品的存放庫和標記範本(例如 'acr/logs:{{.Run.ID}}')。 僅適用於已啟用 CMK 的登錄。

--no-cache

指出是否啟用映像快取。

接受的值: false, true
預設值: False
--no-push

指出建置的映像是否應該推送至登錄。

接受的值: false, true
預設值: False
--platform

執行建置/工作的平臺,例如'windows' 和 'linux'。 在建置命令中使用時,也可以針對產生的影像指定 『os/arch/variant』 格式。 例如 linux/arm/v7。 'arch' 和 'variant' 元件是選擇性的。

--pull-request-trigger-enabled

指出是否啟用原始檔控制提取要求觸發程式。 預設會停用觸發程式。

接受的值: false, true
預設值: False
--resource-group -g

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

--schedule

以cron表示式表示的定時器觸發程式的排程。 您可以使用格式指定 --schedule name:schedule 選擇性的觸發程式名稱。 傳遞 --schedule 多次來支援的倍數。

--secret-arg

'--secret-arg name[=value]' 格式的秘密組建自變數。 多次傳遞 '--secret-arg name[=value]' 支援多個。 此參數值不會浮出給 ACR 小組,而且更適合敏感性資訊。

--set

'--set name[=value]' 格式的工作值。 傳遞 --set 多次來支援的倍數。

--set-secret

'--set-secret name[=value]' 格式的秘密工作值。 傳遞 --set-secret 多次支援的倍數。

--source-trigger-name

來源觸發程式的名稱。

預設值: defaultSourceTriggerName
--status

工作的目前狀態。

接受的值: Disabled, Enabled
預設值: Enabled
--target

目標建置階段的名稱。

--timeout

以秒為單位的逾時。

預設值: 3600
--update-trigger-endpoint
預覽

要接收基底映像更新觸發程式通知之端點的完整 URL。

--update-trigger-payload-type
預覽

指出在傳送通知時,是否要在承載中包含有關基底映像觸發程式的元數據,以及更新觸發程式令牌。

接受的值: Default, Token
預設值: Default
--values

相對於來源內容的工作值/參數檔案路徑。

全域參數
--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

從 Azure Container Registry 刪除工作。

az acr task delete --name
                   --registry
                   [--resource-group]
                   [--yes]

範例

從 Azure Container Registry 刪除工作。

az acr task delete -n MyTask -r myregistry

必要參數

--name -n

工作的名稱。

--registry -r

容器登錄的名稱。 它應該以小寫指定。 您可以使用 來設定預設登錄名稱 az configure --defaults acr=<registry name>

選擇性參數

--resource-group -g

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

--yes -y

不提示確認。

預設值: 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 task list

列出 Azure Container Registry 的工作。

az acr task list --registry
                 [--resource-group]

範例

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

az acr task list -r myregistry -o table

必要參數

--registry -r

容器登錄的名稱。 它應該以小寫指定。 您可以使用 來設定預設登錄名稱 az configure --defaults acr=<registry name>

選擇性參數

--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 task list-runs

列出 Azure Container Registry 執行的所有執行,並能夠依特定工作進行篩選。

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

必要參數

--registry -r

容器登錄的名稱。 它應該以小寫指定。 您可以使用 來設定預設登錄名稱 az configure --defaults acr=<registry name>

選擇性參數

--image -t

影像的名稱。 可以包含格式為 『name:tag』 的標記,或格式為 『name@digest』 的摘要。

--name -n

工作的名稱。

--resource-group -g

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

--run-status

執行的目前狀態。

接受的值: Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout
--top

限制結果中最新的執行次數。

預設值: 15
全域參數
--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

顯示特定執行的記錄。 如果未提供任何 run-id,則顯示上次建立回合的記錄。

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

必要參數

--registry -r

容器登錄的名稱。 它應該以小寫指定。 您可以使用 來設定預設登錄名稱 az configure --defaults acr=<registry name>

選擇性參數

--image -t

影像的名稱。 可以包含格式為 『name:tag』 的標記,或格式為 『name@digest』 的摘要。

--name -n

工作的名稱。

--no-format

指出記錄是否應該以原始格式顯示。

預設值: False
--resource-group -g

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

--run-id

唯一的執行標識碼。

全域參數
--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

手動觸發可能正在等候 Git 認可或基底映像更新觸發程式的工作。

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

必要參數

--name -n

工作的名稱。

--registry -r

容器登錄的名稱。 它應該以小寫指定。 您可以使用 來設定預設登錄名稱 az configure --defaults acr=<registry name>

選擇性參數

--agent-pool
預覽

代理程式集區的名稱。

--arg

'--arg name[=value]' 格式的組建自變數。 多次傳遞 '--arg name[=value]' 來支援倍數。 重要:此參數不應包含任何種類的密碼、存取令牌或敏感性資訊。 ACR 小組將會看見此參數值以供偵錯之用。

--context -c

原始程式碼存放庫的完整 URL(需要 github 存放庫的 '.git' 後綴)或遠端 tarball(例如 ''http://server/context.tar.gz),或 Azure 容器登錄中 OCI 成品的存放庫(例如'oci://myregistry.azurecr.io/myartifact:mytag')。 如果指定 『/dev/null』,則值會設定為 None 並忽略。 如果工作不是系統工作,則這是必要的自變數。

--file -f

工作/docker 檔案至原始程式碼根資料夾的相對路徑。 工作檔案必須以 『.yaml』 後綴,或使用 『-』 從標準輸入使用管道傳送。

--log-template
預覽

使用 'log/repo:tag' 格式執行記錄成品的存放庫和標記範本(例如 'acr/logs:{{.Run.ID}}')。 僅適用於已啟用 CMK 的登錄。

--no-format

指出記錄是否應該以原始格式顯示。

預設值: False
--no-logs

成功佇列組建之後,請勿顯示記錄。

預設值: False
--no-wait

請勿等候執行完成,並在佇列執行之後立即返回。

預設值: False
--resource-group -g

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

--secret-arg

'--secret-arg name[=value]' 格式的秘密組建自變數。 多次傳遞 '--secret-arg name[=value]' 支援多個。 此參數值不會浮出給 ACR 小組,而且更適合敏感性資訊。

--set

'--set name[=value]' 格式的工作值。 傳遞 --set 多次來支援的倍數。

--set-secret

'--set-secret name[=value]' 格式的秘密工作值。 傳遞 --set-secret 多次支援的倍數。

--target

目標建置階段的名稱。

--update-trigger-token
預覽

將隨基底映像觸發程式通知一起傳回的承載。

全域參數
--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

取得 Azure Container Registry 具名工作的屬性。

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

必要參數

--name -n

工作的名稱。

--registry -r

容器登錄的名稱。 它應該以小寫指定。 您可以使用 來設定預設登錄名稱 az configure --defaults acr=<registry name>

選擇性參數

--resource-group -g

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

--with-secure-properties

指出是否應該傳回工作的安全屬性。

預設值: 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 task show-run

取得指定之 Azure Container Registry 工作執行的屬性。

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

範例

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

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

必要參數

--registry -r

容器登錄的名稱。 它應該以小寫指定。 您可以使用 來設定預設登錄名稱 az configure --defaults acr=<registry name>

--run-id

唯一的執行標識碼。

選擇性參數

--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 task update

更新 Azure Container Registry 的工作。

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

必要參數

--name -n

工作的名稱。

--registry -r

容器登錄的名稱。 它應該以小寫指定。 您可以使用 來設定預設登錄名稱 az configure --defaults acr=<registry name>

選擇性參數

--agent-pool
預覽

代理程式集區的名稱。

--arg

'--arg name[=value]' 格式的組建自變數。 多次傳遞 '--arg name[=value]' 來支援倍數。 重要:此參數不應包含任何種類的密碼、存取令牌或敏感性資訊。 ACR 小組將會看見此參數值以供偵錯之用。

--auth-mode

來源登錄的驗證模式。

接受的值: Default, None
--base-image-trigger-enabled

指出是否啟用基底映像觸發程式。

接受的值: false, true
--base-image-trigger-type

基底映像相依性更新的自動觸發程序類型。

接受的值: All, Runtime
--cmd

要執行的命令。 這也支援其他 Docker 執行參數 (https://docs.docker.com/engine/reference/commandline/run/) 或甚至其他 Docker 命令 (https://docs.docker.com/engine/reference/commandline/docker/)。

--commit-trigger-enabled

指出是否啟用原始檔控制認可觸發程式。

接受的值: false, true
--context -c

原始程式碼存放庫的完整 URL(需要 github 存放庫的 '.git' 後綴)或遠端 tarball(例如 ''http://server/context.tar.gz),或 Azure 容器登錄中 OCI 成品的存放庫(例如'oci://myregistry.azurecr.io/myartifact:mytag')。 如果指定 『/dev/null』,則值會設定為 None 並忽略。 如果工作不是系統工作,則這是必要的自變數。

--cpu

針對執行所需的核心數目,CPU 組態。

--file -f

工作/docker 檔案至原始程式碼根資料夾的相對路徑。 工作檔案必須以 『.yaml』 後綴,或使用 『-』 從標準輸入使用管道傳送。

--git-access-token

用來存取原始檔控制提供者的存取令牌。

--image -t

影像的名稱和標記,其格式為:『-t 存放庫/image:tag』。 傳遞 -t 多次支援多個標記。

--log-template
預覽

使用 'log/repo:tag' 格式執行記錄成品的存放庫和標記範本(例如 'acr/logs:{{.Run.ID}}')。 僅適用於已啟用 CMK 的登錄。

--no-cache

指出是否啟用映像快取。

接受的值: false, true
--no-push

指出建置的映像是否應該推送至登錄。

接受的值: false, true
--platform

執行建置/工作的平臺,例如'windows' 和 'linux'。 在建置命令中使用時,也可以針對產生的影像指定 『os/arch/variant』 格式。 例如 linux/arm/v7。 'arch' 和 'variant' 元件是選擇性的。

--pull-request-trigger-enabled

指出是否啟用原始檔控制提取要求觸發程式。 預設會停用觸發程式。

接受的值: false, true
--resource-group -g

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

--secret-arg

'--secret-arg name[=value]' 格式的秘密組建自變數。 多次傳遞 '--secret-arg name[=value]' 支援多個。 此參數值不會浮出給 ACR 小組,而且更適合敏感性資訊。

--set

'--set name[=value]' 格式的工作值。 傳遞 --set 多次來支援的倍數。

--set-secret

'--set-secret name[=value]' 格式的秘密工作值。 傳遞 --set-secret 多次支援的倍數。

--status

工作的目前狀態。

接受的值: Disabled, Enabled
--target

目標建置階段的名稱。

--timeout

以秒為單位的逾時。

--update-trigger-endpoint
預覽

要接收基底映像更新觸發程式通知之端點的完整 URL。

--update-trigger-payload-type
預覽

指出在傳送通知時,是否要在承載中包含有關基底映像觸發程式的元數據,以及更新觸發程式令牌。

接受的值: Default, Token
--values

相對於來源內容的工作值/參數檔案路徑。

全域參數
--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

修補 Azure Container Registry 工作的執行屬性。

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

必要參數

--registry -r

容器登錄的名稱。 它應該以小寫指定。 您可以使用 來設定預設登錄名稱 az configure --defaults acr=<registry name>

--run-id

唯一的執行標識碼。

選擇性參數

--no-archive

指出是否應該封存執行。

接受的值: false, true
--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 來取得完整偵錯記錄。