Поделиться через


az acr task

Управление коллекцией шагов по созданию, тестированию и исправлению образов контейнеров ОС и Платформы с помощью реестров контейнеров Azure.

Команды

Имя Описание Тип Состояние
az acr task cancel-run

Отмена указанного запуска Реестр контейнеров Azure.

Core GA
az acr task create

Создайте ряд шагов по созданию, тестированию и контейнерам исправлений ОС и Платформы. Задачи поддерживают триггеры от фиксаций Git и обновлений базового образа.

Core GA
az acr task credential

Управление учетными данными для задачи. Дополнительные сведения см. по адресу https://aka.ms/acr/connected-registry.

Core GA
az acr task credential add

Добавьте в задачу настраиваемые учетные данные для входа в реестр.

Core GA
az acr task credential list

Список всех пользовательских учетных данных реестра для задачи.

Core GA
az acr task credential remove

Удаление учетных данных для задачи.

Core GA
az acr task credential update

Обновите учетные данные входа реестра для задачи.

Core GA
az acr task delete

Удаление задачи из Реестр контейнеров Azure.

Core GA
az acr task identity

Управляемые удостоверения для задачи. Дополнительные сведения см. по адресу https://aka.ms/acr/connected-registry.

Core GA
az acr task identity assign

Обновите управляемое удостоверение для задачи.

Core GA
az acr task identity remove

Удаление управляемых удостоверений для задачи.

Core GA
az acr task identity show

Отображение управляемых удостоверений для задачи.

Core GA
az acr task list

Вывод списка задач для Реестр контейнеров Azure.

Core GA
az acr task list-runs

Список всех выполняемых запусков для Реестр контейнеров Azure с возможностью фильтрации по определенной задаче.

Core GA
az acr task logs

Отображение журналов для определенного запуска. Если идентификатор запуска не указан, отобразите журналы для последнего созданного запуска.

Core GA
az acr task run

Вручную активируйте задачу, которая может иначе ожидать фиксаций Git или триггеров обновления базового образа.

Core GA
az acr task show

Получение свойств именованной задачи для Реестр контейнеров Azure.

Core GA
az acr task show-run

Получение свойств указанного запуска задачи Реестр контейнеров Azure.

Core GA
az acr task timer

Управление триггерами таймера для задачи.

Core GA
az acr task timer add

Добавьте триггер таймера в задачу.

Core GA
az acr task timer list

Вывод списка всех триггеров таймера для задачи.

Core GA
az acr task timer remove

Удалите триггер таймера из задачи.

Core GA
az acr task timer update

Обновите триггер таймера для задачи.

Core GA
az acr task update

Обновите задачу для Реестр контейнеров Azure.

Core GA
az acr task update-run

Исправление свойств выполнения задачи Реестр контейнеров Azure.

Core 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

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az acr task create

Создайте ряд шагов по созданию, тестированию и контейнерам исправлений ОС и Платформы. Задачи поддерживают триггеры от фиксаций 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-acr-auth-id]
                   [--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 * * *"

Создайте задачу Linux из общедоступного репозитория GitHub, который создает образ hello-world без триггеров и использует аргумент сборки.

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

Создайте задачу Linux с помощью определенной ветви частного репозитория Azure DevOps, который создает образ hello-world в архитектуре Arm (вариант версии 7) и включает триггеры.

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

Создайте задачу Linux из общедоступного репозитория GitHub, который создает образ hello-world с включенным триггером запроса на вытягивание и фиксацию Git. Обратите внимание, что эта задача не использует исходный реестр (myregistry), поэтому для него можно явно задать режим проверки подлинности в качестве None.

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

Создайте задачу Windows из общедоступного репозитория GitHub, который создает образ Конструктора контейнеров Azure на архитектуре Amd64 с включенным триггером базового образа.

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

Создайте многофакторную задачу Linux из общедоступного репозитория GitHub с управляемыми удостоверениями, назначаемыми системой, и назначаемым пользователем управляемыми удостоверениями, а также базовым образом, фиксацией git, запросом на вытягивание и таймером, которые выполняют задачу в полдень по понедельникам по пятницам с указанным именем триггера таймера.

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

Создайте задачу без исходного расположения в реестре разрешений репозитория на основе ABAC и укажите назначаемое системой управляемое удостоверение, используемое для проверки подлинности в исходном реестре.

az acr task create -n hello-world -r myregistry --cmd '$Registry/myimage' -c /dev/null --source-acr-auth-id [system]

Создайте задачу без исходного расположения в реестре разрешений репозитория на основе ABAC и укажите назначаемое пользователем управляемое удостоверение, используемое для проверки подлинности в исходном реестре.

az acr task create -n hello-world -r myregistry --cmd '$Registry/myimage' -c /dev/null --source-acr-auth-id "/subscriptions/<subscriptionId>/resourcegroups/<myResourceGroup>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<myUserAssignedIdentitiy>"

Создайте задачу без исходного расположения в реестре разрешений репозитория на основе ABAC с управляемыми удостоверениями, назначаемыми системой и назначаемыми пользователем, и укажите управляемое удостоверение, назначаемое системой, для проверки подлинности в исходном реестре.

az acr task create -n hello-world -r myregistry --cmd '$Registry/myimage' -c /dev/null --source-acr-auth-id [system]
    --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/connected-registry.

--auth-mode

Режим проверки подлинности исходного реестра.

Свойство Значение
Допустимые значения: Default, None
--base-image-trigger-enabled

Указывает, включен ли триггер базового образа.

Свойство Значение
Группа параметров: Trigger Arguments
Default value: True
Допустимые значения: false, true
--base-image-trigger-name

Имя триггера базового образа.

Свойство Значение
Группа параметров: Trigger Arguments
Default value: defaultBaseimageTriggerName
--base-image-trigger-type

Тип автоматического триггера для обновлений зависимостей базового образа.

Свойство Значение
Группа параметров: Trigger Arguments
Default value: Runtime
Допустимые значения: All, Runtime
--cmd

Команды для выполнения. Это также поддерживает дополнительные параметры запуска Docker (https://docs.docker.com/engine/reference/commandline/run/) или даже другие команды Docker (https://docs.docker.com/engine/reference/commandline/docker/).

--commit-trigger-enabled

Указывает, включен ли триггер фиксации системы управления версиями.

Свойство Значение
Группа параметров: Trigger Arguments
Default value: True
Допустимые значения: false, true
--context -c

Полный URL-адрес репозитория исходного кода (требуется суффикс GIT для репозитория github) или удаленного тарбола (например, "http://server/context.tar.gz" или репозиторий артефакта OCI в реестре контейнеров Azure (например, "oci://myregistry.azurecr.io/myartifact:mytag". Если задано значение "/dev/null", значение будет задано как None и игнорируется. Это обязательный аргумент, если задача не является системной задачей.

--cpu

Конфигурация ЦП с точки зрения количества ядер, необходимых для выполнения.

Свойство Значение
Default value: 2
--file -f

Относительный путь файла task/docker к корневой папке исходного кода. Файлы задач должны быть суффиксированы с помощью yaml или переданы из стандартных входных данных с помощью "-".

--git-access-token

Маркер доступа, используемый для доступа к поставщику системы управления версиями.

Свойство Значение
Группа параметров: Trigger Arguments
--image -t

Имя и тег изображения с помощью формата :-t repo/image:tag. Несколько тегов поддерживаются путем передачи -t несколько раз.

--is-system-task
Предварительный просмотр

Указывает, является ли ресурс задачи системной задачей. Имя задачи должно быть "quicktask". Применимо только к реестру с поддержкой CMK.

Свойство Значение
Default value: False
--log-template
Предварительный просмотр

Шаблон репозитория и тега для артефакта журнала выполнения с помощью формата "log/repo:tag" (например, "acr/logs:{.Run.ID}}". Применимо только к реестру с поддержкой CMK.

--no-cache

Указывает, включен ли кэш изображений.

Свойство Значение
Default value: False
Допустимые значения: false, true
--no-push

Указывает, следует ли отправлять образ в реестр.

Свойство Значение
Default value: False
Допустимые значения: false, true
--platform

Платформа, на которой выполняется сборка или задача, например windows и linux. Если он используется в командах сборки, он также может быть указан в формате os/arch/variant для полученного образа. Например, linux/arm/v7. Части "arch" и "variant" являются необязательными.

--pull-request-trigger-enabled

Указывает, включен ли триггер запроса на вытягивание системы управления версиями. Триггер отключен по умолчанию.

Свойство Значение
Группа параметров: Trigger Arguments
Default value: False
Допустимые значения: false, true
--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--schedule

Планирование триггера таймера, представленного как выражение cron. Необязательное имя триггера можно указать с помощью --schedule name:schedule формата. Несколько раз поддерживаются путем передачи --schedule несколько раз.

Свойство Значение
Группа параметров: Trigger Arguments
--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-acr-auth-id

Назначьте управляемое удостоверение, используемое для входа в исходный реестр. Используйте [system], чтобы ссылаться на удостоверение, назначаемое системой, или идентификатор ресурса, чтобы ссылаться на управляемое удостоверение, назначаемое пользователем.

--source-trigger-name

Имя исходного триггера.

Свойство Значение
Группа параметров: Trigger Arguments
Default value: defaultSourceTriggerName
--status

Текущее состояние задачи.

Свойство Значение
Default value: Enabled
Допустимые значения: Disabled, Enabled
--target

Имя целевой стадии сборки.

--timeout

Время ожидания в секундах.

Свойство Значение
Default value: 3600
--update-trigger-endpoint
Предварительный просмотр

Полный URL-адрес конечной точки для получения уведомлений триггера обновления базового образа.

Свойство Значение
Группа параметров: Trigger Arguments
--update-trigger-payload-type
Предварительный просмотр

Указывает, следует ли включать метаданные о триггере базового образа в полезные данные вместе с маркером триггера обновления при отправке уведомления.

Свойство Значение
Группа параметров: Trigger Arguments
Default value: Default
Допустимые значения: Default, Token
--values

Путь к файлу значений и параметров задачи относительно исходного контекста.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

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

Не запрашивать подтверждение.

Свойство Значение
Default value: False
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

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

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

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

Список всех запусков, создающих образ hello-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

Ограничить количество последних запусков в результатах.

Свойство Значение
Default value: 15
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az acr task logs

Отображение журналов для определенного запуска. Если идентификатор запуска не указан, отобразите журналы для последнего созданного запуска.

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

Отображение журналов для последнего созданного запуска в реестре, создавшего образ hello-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

Указывает, должны ли журналы отображаться в необработанном формате.

Свойство Значение
Default value: False
--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--run-id

Уникальный идентификатор выполнения.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

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-адрес репозитория исходного кода (требуется суффикс GIT для репозитория github) или удаленного тарбола (например, "http://server/context.tar.gz" или репозиторий артефакта OCI в реестре контейнеров Azure (например, "oci://myregistry.azurecr.io/myartifact:mytag". Если задано значение "/dev/null", значение будет задано как None и игнорируется. Это обязательный аргумент, если задача не является системной задачей.

--file -f

Относительный путь файла task/docker к корневой папке исходного кода. Файлы задач должны быть суффиксированы с помощью yaml или переданы из стандартных входных данных с помощью "-".

--log-template
Предварительный просмотр

Шаблон репозитория и тега для артефакта журнала выполнения с помощью формата "log/repo:tag" (например, "acr/logs:{.Run.ID}}". Применимо только к реестру с поддержкой CMK.

--no-format

Указывает, должны ли журналы отображаться в необработанном формате.

Свойство Значение
Default value: False
--no-logs

Не отображайте журналы после успешной очереди сборки.

Свойство Значение
Default value: False
--no-wait

Не подождите, пока выполнение завершится и вернется сразу после очереди выполнения.

Свойство Значение
Default value: 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

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

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

Указывает, следует ли возвращать безопасные свойства задачи.

Свойство Значение
Default value: False
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

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

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

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]
                   [--source-acr-auth-id]
                   [--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. (autogenerated)

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

Обновите задачу с помощью управляемого удостоверения, назначаемого системой, для проверки подлинности с помощью исходного реестра контейнеров в Реестре контейнеров Azure.

az acr task update -n MyTask -r myregistry --source-acr-auth-id [system]

Обновите задачу с помощью управляемого удостоверения, назначаемого пользователем, для проверки подлинности с помощью исходного реестра контейнеров в Реестре контейнеров Azure.

az acr task update -n MyTask -r myregistry --source-acr-auth-id "/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 в целях отладки.

--auth-mode

Режим проверки подлинности исходного реестра.

Свойство Значение
Допустимые значения: Default, None
--base-image-trigger-enabled

Указывает, включен ли триггер базового образа.

Свойство Значение
Группа параметров: Trigger Arguments
Допустимые значения: false, true
--base-image-trigger-type

Тип автоматического триггера для обновлений зависимостей базового образа.

Свойство Значение
Группа параметров: Trigger Arguments
Допустимые значения: All, Runtime
--cmd

Команды для выполнения. Это также поддерживает дополнительные параметры запуска Docker (https://docs.docker.com/engine/reference/commandline/run/) или даже другие команды Docker (https://docs.docker.com/engine/reference/commandline/docker/).

--commit-trigger-enabled

Указывает, включен ли триггер фиксации системы управления версиями.

Свойство Значение
Группа параметров: Trigger Arguments
Допустимые значения: false, true
--context -c

Полный URL-адрес репозитория исходного кода (требуется суффикс GIT для репозитория github) или удаленного тарбола (например, "http://server/context.tar.gz" или репозиторий артефакта OCI в реестре контейнеров Azure (например, "oci://myregistry.azurecr.io/myartifact:mytag". Если задано значение "/dev/null", значение будет задано как None и игнорируется. Это обязательный аргумент, если задача не является системной задачей.

--cpu

Конфигурация ЦП с точки зрения количества ядер, необходимых для выполнения.

--file -f

Относительный путь файла task/docker к корневой папке исходного кода. Файлы задач должны быть суффиксированы с помощью yaml или переданы из стандартных входных данных с помощью "-".

--git-access-token

Маркер доступа, используемый для доступа к поставщику системы управления версиями.

Свойство Значение
Группа параметров: Trigger Arguments
--image -t

Имя и тег изображения с помощью формата :-t repo/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

Указывает, включен ли триггер запроса на вытягивание системы управления версиями. Триггер отключен по умолчанию.

Свойство Значение
Группа параметров: Trigger Arguments
Допустимые значения: 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.

--source-acr-auth-id

Назначьте управляемое удостоверение, используемое для входа в исходный реестр. Используйте [system], чтобы ссылаться на удостоверение, назначаемое системой, или идентификатор ресурса, чтобы ссылаться на управляемое удостоверение, назначаемое пользователем.

--status

Текущее состояние задачи.

Свойство Значение
Допустимые значения: Disabled, Enabled
--target

Имя целевой стадии сборки.

--timeout

Время ожидания в секундах.

--update-trigger-endpoint
Предварительный просмотр

Полный URL-адрес конечной точки для получения уведомлений триггера обновления базового образа.

Свойство Значение
Группа параметров: Trigger Arguments
--update-trigger-payload-type
Предварительный просмотр

Указывает, следует ли включать метаданные о триггере базового образа в полезные данные вместе с маркером триггера обновления при отправке уведомления.

Свойство Значение
Группа параметров: Trigger Arguments
Допустимые значения: Default, Token
--values

Путь к файлу значений и параметров задачи относительно исходного контекста.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

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

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False