你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

az acr task

使用 Azure 容器注册表管理生成、测试和 OS 和框架修补容器映像的步骤集合。

命令

名称 说明 类型 Status
az acr task cancel-run

取消指定的Azure 容器注册表运行。

核心 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 容器注册表中删除任务。

核心 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 容器注册表的任务。

核心 GA
az acr task list-runs

列出Azure 容器注册表执行的所有运行,并能够按特定任务进行筛选。

核心 GA
az acr task logs

显示特定运行的日志。 如果未提供运行 ID,则显示上次创建的运行的日志。

核心 GA
az acr task run

手动触发可能正在等待 git 提交或基础映像更新触发器的任务。

核心 GA
az acr task show

获取Azure 容器注册表的命名任务的属性。

核心 GA
az acr task show-run

获取Azure 容器注册表任务的指定运行的属性。

核心 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 容器注册表的任务。

核心 GA
az acr task update-run

修补Azure 容器注册表任务的运行属性。

核心 GA

az acr task cancel-run

取消指定的Azure 容器注册表运行。

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

订阅的名称或 ID。 可以使用 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 变体)上生成你好世界映像,并启用了触发器。

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 提交和拉取请求触发器生成你好世界映像。 请注意,此任务不使用源注册表(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 容器生成器映像,仅启用基本映像触发器。

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]”来引用系统分配的标识或资源 ID 来引用用户分配的标识。 有关详细信息,请参阅 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”,该值将设置为“无”并忽略。 如果任务不是系统任务,则这是必需参数。

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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az acr task delete

从Azure 容器注册表中删除任务。

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

示例

从Azure 容器注册表中删除任务。

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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az acr task list

列出Azure 容器注册表的任务。

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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az acr task list-runs

列出Azure 容器注册表执行的所有运行,并能够按特定任务进行筛选。

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

列出为注册表生成映像“你好世界”的所有运行,并在表中显示结果。

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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az acr task logs

显示特定运行的日志。 如果未提供运行 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

订阅的名称或 ID。 可以使用 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”,该值将设置为“无”并忽略。 如果任务不是系统任务,则这是必需参数。

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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az acr task show

获取Azure 容器注册表的命名任务的属性。

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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az acr task show-run

获取Azure 容器注册表任务的指定运行的属性。

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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az acr task update

更新Azure 容器注册表的任务。

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 容器注册表中任务的状态触发。

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 容器注册表的任务触发器和上下文。

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 容器注册表的任务。 (自动生成)

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”,该值将设置为“无”并忽略。 如果任务不是系统任务,则这是必需参数。

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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。

az acr task update-run

修补Azure 容器注册表任务的运行属性。

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

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

提高日志记录详细程度。 使用 --debug 获取完整的调试日志。