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
Обязательные параметры
Имя реестра контейнеров. Он должен быть указан в нижнем регистре. Имя реестра по умолчанию можно настроить с помощью az configure --defaults acr=<registry name>.
Уникальный идентификатор выполнения.
Необязательные параметры
Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --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>"
Обязательные параметры
Имя задачи.
Имя реестра контейнеров. Он должен быть указан в нижнем регистре. Имя реестра по умолчанию можно настроить с помощью az configure --defaults acr=<registry name>.
Необязательные параметры
Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.
Имя пула агентов.
Выполните сборку аргумента в формате "-arg name[=value]". Несколько вариантов поддерживаются путем передачи "-arg name[=value]" несколько раз. ВАЖНО. Этот параметр не должен включать пароли, маркеры доступа или конфиденциальную информацию любого типа. Это значение параметра будет отображаться команде ACR в целях отладки.
Назначьте управляемые удостоверения задаче. Используйте [system], чтобы ссылаться на удостоверение, назначаемое системой, или идентификатор ресурса, чтобы ссылаться на удостоверение, назначаемое пользователем. Дополнительные сведения см. по адресу https://aka.ms/acr/connected-registry.
Режим проверки подлинности исходного реестра.
| Свойство | Значение |
|---|---|
| Допустимые значения: | Default, None |
Указывает, включен ли триггер базового образа.
| Свойство | Значение |
|---|---|
| Группа параметров: | Trigger Arguments |
| Default value: | True |
| Допустимые значения: | false, true |
Имя триггера базового образа.
| Свойство | Значение |
|---|---|
| Группа параметров: | Trigger Arguments |
| Default value: | defaultBaseimageTriggerName |
Тип автоматического триггера для обновлений зависимостей базового образа.
| Свойство | Значение |
|---|---|
| Группа параметров: | Trigger Arguments |
| Default value: | Runtime |
| Допустимые значения: | All, Runtime |
Команды для выполнения. Это также поддерживает дополнительные параметры запуска Docker (https://docs.docker.com/engine/reference/commandline/run/) или даже другие команды Docker (https://docs.docker.com/engine/reference/commandline/docker/).
Указывает, включен ли триггер фиксации системы управления версиями.
| Свойство | Значение |
|---|---|
| Группа параметров: | Trigger Arguments |
| Default value: | True |
| Допустимые значения: | false, true |
Полный URL-адрес репозитория исходного кода (требуется суффикс GIT для репозитория github) или удаленного тарбола (например, "http://server/context.tar.gz" или репозиторий артефакта OCI в реестре контейнеров Azure (например, "oci://myregistry.azurecr.io/myartifact:mytag". Если задано значение "/dev/null", значение будет задано как None и игнорируется. Это обязательный аргумент, если задача не является системной задачей.
Конфигурация ЦП с точки зрения количества ядер, необходимых для выполнения.
| Свойство | Значение |
|---|---|
| Default value: | 2 |
Относительный путь файла task/docker к корневой папке исходного кода. Файлы задач должны быть суффиксированы с помощью yaml или переданы из стандартных входных данных с помощью "-".
Маркер доступа, используемый для доступа к поставщику системы управления версиями.
| Свойство | Значение |
|---|---|
| Группа параметров: | Trigger Arguments |
Имя и тег изображения с помощью формата :-t repo/image:tag. Несколько тегов поддерживаются путем передачи -t несколько раз.
Указывает, является ли ресурс задачи системной задачей. Имя задачи должно быть "quicktask". Применимо только к реестру с поддержкой CMK.
| Свойство | Значение |
|---|---|
| Default value: | False |
Шаблон репозитория и тега для артефакта журнала выполнения с помощью формата "log/repo:tag" (например, "acr/logs:{.Run.ID}}". Применимо только к реестру с поддержкой CMK.
Указывает, включен ли кэш изображений.
| Свойство | Значение |
|---|---|
| Default value: | False |
| Допустимые значения: | false, true |
Указывает, следует ли отправлять образ в реестр.
| Свойство | Значение |
|---|---|
| Default value: | False |
| Допустимые значения: | false, true |
Платформа, на которой выполняется сборка или задача, например windows и linux. Если он используется в командах сборки, он также может быть указан в формате os/arch/variant для полученного образа. Например, linux/arm/v7. Части "arch" и "variant" являются необязательными.
Указывает, включен ли триггер запроса на вытягивание системы управления версиями. Триггер отключен по умолчанию.
| Свойство | Значение |
|---|---|
| Группа параметров: | Trigger Arguments |
| Default value: | False |
| Допустимые значения: | false, true |
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.
Планирование триггера таймера, представленного как выражение cron. Необязательное имя триггера можно указать с помощью --schedule name:schedule формата. Несколько раз поддерживаются путем передачи --schedule несколько раз.
| Свойство | Значение |
|---|---|
| Группа параметров: | Trigger Arguments |
Аргумент секретной сборки в формате "-secret-arg name[=value]". Несколько вариантов поддерживаются путем передачи "-secret-arg name[=value]" несколько раз. Это значение параметра не отображается в команде ACR и более подходит для конфиденциальной информации.
Значение задачи в формате "-set name[=value]". Несколько, поддерживаемых путем передачи --set несколько раз.
Значение секретной задачи в формате "-set-secret name[=value]". Несколько раз поддерживаются путем передачи секрета --set-secret.
Назначьте управляемое удостоверение, используемое для входа в исходный реестр. Используйте [system], чтобы ссылаться на удостоверение, назначаемое системой, или идентификатор ресурса, чтобы ссылаться на управляемое удостоверение, назначаемое пользователем.
Имя исходного триггера.
| Свойство | Значение |
|---|---|
| Группа параметров: | Trigger Arguments |
| Default value: | defaultSourceTriggerName |
Текущее состояние задачи.
| Свойство | Значение |
|---|---|
| Default value: | Enabled |
| Допустимые значения: | Disabled, Enabled |
Имя целевой стадии сборки.
Время ожидания в секундах.
| Свойство | Значение |
|---|---|
| Default value: | 3600 |
Полный URL-адрес конечной точки для получения уведомлений триггера обновления базового образа.
| Свойство | Значение |
|---|---|
| Группа параметров: | Trigger Arguments |
Указывает, следует ли включать метаданные о триггере базового образа в полезные данные вместе с маркером триггера обновления при отправке уведомления.
| Свойство | Значение |
|---|---|
| Группа параметров: | Trigger Arguments |
| Default value: | Default |
| Допустимые значения: | Default, Token |
Путь к файлу значений и параметров задачи относительно исходного контекста.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --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
Обязательные параметры
Имя задачи.
Имя реестра контейнеров. Он должен быть указан в нижнем регистре. Имя реестра по умолчанию можно настроить с помощью az configure --defaults acr=<registry name>.
Необязательные параметры
Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.
Не запрашивать подтверждение.
| Свойство | Значение |
|---|---|
| Default value: | False |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
| Свойство | Значение |
|---|---|
| Default value: | False |
az acr task list
Вывод списка задач для Реестр контейнеров Azure.
az acr task list --registry
[--resource-group]
Примеры
Вывод списка задач и отображение результатов в таблице.
az acr task list -r myregistry -o table
Обязательные параметры
Имя реестра контейнеров. Он должен быть указан в нижнем регистре. Имя реестра по умолчанию можно настроить с помощью az configure --defaults acr=<registry name>.
Необязательные параметры
Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --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
Обязательные параметры
Имя реестра контейнеров. Он должен быть указан в нижнем регистре. Имя реестра по умолчанию можно настроить с помощью az configure --defaults acr=<registry name>.
Необязательные параметры
Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.
Имя изображения. Может содержать тег в формате "name:tag" или дайджест в формате "name@digest".
Имя задачи.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.
Текущее состояние выполнения.
| Свойство | Значение |
|---|---|
| Допустимые значения: | Canceled, Error, Failed, Queued, Running, Started, Succeeded, Timeout |
Ограничить количество последних запусков в результатах.
| Свойство | Значение |
|---|---|
| Default value: | 15 |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --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
Обязательные параметры
Имя реестра контейнеров. Он должен быть указан в нижнем регистре. Имя реестра по умолчанию можно настроить с помощью az configure --defaults acr=<registry name>.
Необязательные параметры
Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.
Имя изображения. Может содержать тег в формате "name:tag" или дайджест в формате "name@digest".
Имя задачи.
Указывает, должны ли журналы отображаться в необработанном формате.
| Свойство | Значение |
|---|---|
| Default value: | False |
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.
Уникальный идентификатор выполнения.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --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
Обязательные параметры
Имя задачи.
Имя реестра контейнеров. Он должен быть указан в нижнем регистре. Имя реестра по умолчанию можно настроить с помощью az configure --defaults acr=<registry name>.
Необязательные параметры
Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.
Имя пула агентов.
Выполните сборку аргумента в формате "-arg name[=value]". Несколько вариантов поддерживаются путем передачи "-arg name[=value]" несколько раз. ВАЖНО. Этот параметр не должен включать пароли, маркеры доступа или конфиденциальную информацию любого типа. Это значение параметра будет отображаться команде ACR в целях отладки.
Полный URL-адрес репозитория исходного кода (требуется суффикс GIT для репозитория github) или удаленного тарбола (например, "http://server/context.tar.gz" или репозиторий артефакта OCI в реестре контейнеров Azure (например, "oci://myregistry.azurecr.io/myartifact:mytag". Если задано значение "/dev/null", значение будет задано как None и игнорируется. Это обязательный аргумент, если задача не является системной задачей.
Относительный путь файла task/docker к корневой папке исходного кода. Файлы задач должны быть суффиксированы с помощью yaml или переданы из стандартных входных данных с помощью "-".
Шаблон репозитория и тега для артефакта журнала выполнения с помощью формата "log/repo:tag" (например, "acr/logs:{.Run.ID}}". Применимо только к реестру с поддержкой CMK.
Указывает, должны ли журналы отображаться в необработанном формате.
| Свойство | Значение |
|---|---|
| Default value: | False |
Не отображайте журналы после успешной очереди сборки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Не подождите, пока выполнение завершится и вернется сразу после очереди выполнения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.
Аргумент секретной сборки в формате "-secret-arg name[=value]". Несколько вариантов поддерживаются путем передачи "-secret-arg name[=value]" несколько раз. Это значение параметра не отображается в команде ACR и более подходит для конфиденциальной информации.
Значение задачи в формате "-set name[=value]". Несколько, поддерживаемых путем передачи --set несколько раз.
Значение секретной задачи в формате "-set-secret name[=value]". Несколько раз поддерживаются путем передачи секрета --set-secret.
Имя целевой стадии сборки.
Полезные данные, которые будут переданы обратно вместе с уведомлением триггера базового образа.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --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
Обязательные параметры
Имя задачи.
Имя реестра контейнеров. Он должен быть указан в нижнем регистре. Имя реестра по умолчанию можно настроить с помощью az configure --defaults acr=<registry name>.
Необязательные параметры
Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.
Указывает, следует ли возвращать безопасные свойства задачи.
| Свойство | Значение |
|---|---|
| Default value: | False |
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --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
Обязательные параметры
Имя реестра контейнеров. Он должен быть указан в нижнем регистре. Имя реестра по умолчанию можно настроить с помощью az configure --defaults acr=<registry name>.
Уникальный идентификатор выполнения.
Необязательные параметры
Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --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>"
Обязательные параметры
Имя задачи.
Имя реестра контейнеров. Он должен быть указан в нижнем регистре. Имя реестра по умолчанию можно настроить с помощью az configure --defaults acr=<registry name>.
Необязательные параметры
Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.
Имя пула агентов.
Выполните сборку аргумента в формате "-arg name[=value]". Несколько вариантов поддерживаются путем передачи "-arg name[=value]" несколько раз. ВАЖНО. Этот параметр не должен включать пароли, маркеры доступа или конфиденциальную информацию любого типа. Это значение параметра будет отображаться команде ACR в целях отладки.
Режим проверки подлинности исходного реестра.
| Свойство | Значение |
|---|---|
| Допустимые значения: | Default, None |
Указывает, включен ли триггер базового образа.
| Свойство | Значение |
|---|---|
| Группа параметров: | Trigger Arguments |
| Допустимые значения: | false, true |
Тип автоматического триггера для обновлений зависимостей базового образа.
| Свойство | Значение |
|---|---|
| Группа параметров: | Trigger Arguments |
| Допустимые значения: | All, Runtime |
Команды для выполнения. Это также поддерживает дополнительные параметры запуска Docker (https://docs.docker.com/engine/reference/commandline/run/) или даже другие команды Docker (https://docs.docker.com/engine/reference/commandline/docker/).
Указывает, включен ли триггер фиксации системы управления версиями.
| Свойство | Значение |
|---|---|
| Группа параметров: | Trigger Arguments |
| Допустимые значения: | false, true |
Полный URL-адрес репозитория исходного кода (требуется суффикс GIT для репозитория github) или удаленного тарбола (например, "http://server/context.tar.gz" или репозиторий артефакта OCI в реестре контейнеров Azure (например, "oci://myregistry.azurecr.io/myartifact:mytag". Если задано значение "/dev/null", значение будет задано как None и игнорируется. Это обязательный аргумент, если задача не является системной задачей.
Конфигурация ЦП с точки зрения количества ядер, необходимых для выполнения.
Относительный путь файла task/docker к корневой папке исходного кода. Файлы задач должны быть суффиксированы с помощью yaml или переданы из стандартных входных данных с помощью "-".
Маркер доступа, используемый для доступа к поставщику системы управления версиями.
| Свойство | Значение |
|---|---|
| Группа параметров: | Trigger Arguments |
Имя и тег изображения с помощью формата :-t repo/image:tag. Несколько тегов поддерживаются путем передачи -t несколько раз.
Шаблон репозитория и тега для артефакта журнала выполнения с помощью формата "log/repo:tag" (например, "acr/logs:{.Run.ID}}". Применимо только к реестру с поддержкой CMK.
Указывает, включен ли кэш изображений.
| Свойство | Значение |
|---|---|
| Допустимые значения: | false, true |
Указывает, следует ли отправлять образ в реестр.
| Свойство | Значение |
|---|---|
| Допустимые значения: | false, true |
Платформа, на которой выполняется сборка или задача, например windows и linux. Если он используется в командах сборки, он также может быть указан в формате os/arch/variant для полученного образа. Например, linux/arm/v7. Части "arch" и "variant" являются необязательными.
Указывает, включен ли триггер запроса на вытягивание системы управления версиями. Триггер отключен по умолчанию.
| Свойство | Значение |
|---|---|
| Группа параметров: | Trigger Arguments |
| Допустимые значения: | false, true |
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.
Аргумент секретной сборки в формате "-secret-arg name[=value]". Несколько вариантов поддерживаются путем передачи "-secret-arg name[=value]" несколько раз. Это значение параметра не отображается в команде ACR и более подходит для конфиденциальной информации.
Значение задачи в формате "-set name[=value]". Несколько, поддерживаемых путем передачи --set несколько раз.
Значение секретной задачи в формате "-set-secret name[=value]". Несколько раз поддерживаются путем передачи секрета --set-secret.
Назначьте управляемое удостоверение, используемое для входа в исходный реестр. Используйте [system], чтобы ссылаться на удостоверение, назначаемое системой, или идентификатор ресурса, чтобы ссылаться на управляемое удостоверение, назначаемое пользователем.
Текущее состояние задачи.
| Свойство | Значение |
|---|---|
| Допустимые значения: | Disabled, Enabled |
Имя целевой стадии сборки.
Время ожидания в секундах.
Полный URL-адрес конечной точки для получения уведомлений триггера обновления базового образа.
| Свойство | Значение |
|---|---|
| Группа параметров: | Trigger Arguments |
Указывает, следует ли включать метаданные о триггере базового образа в полезные данные вместе с маркером триггера обновления при отправке уведомления.
| Свойство | Значение |
|---|---|
| Группа параметров: | Trigger Arguments |
| Допустимые значения: | Default, Token |
Путь к файлу значений и параметров задачи относительно исходного контекста.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --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
Обязательные параметры
Имя реестра контейнеров. Он должен быть указан в нижнем регистре. Имя реестра по умолчанию можно настроить с помощью az configure --defaults acr=<registry name>.
Уникальный идентификатор выполнения.
Необязательные параметры
Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.
Указывает, следует ли архивировать выполнение.
| Свойство | Значение |
|---|---|
| Допустимые значения: | false, true |
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.
Глобальные параметры
Повышение уровня детализации журнала для включения всех журналов отладки.
| Свойство | Значение |
|---|---|
| Default value: | False |
Показать это сообщение справки и выйти.
Отображать только ошибки, не показывая предупреждения.
| Свойство | Значение |
|---|---|
| Default value: | False |
Формат вывода.
| Свойство | Значение |
|---|---|
| Default value: | json |
| Допустимые значения: | json, jsonc, none, table, tsv, yaml, yamlc |
Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.
Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.
| Свойство | Значение |
|---|---|
| Default value: | False |