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

az pipelines

Note

Эта ссылка является частью расширения azure-devops для Azure CLI (версия 2.30.0 или более поздней). Расширение автоматически установит команду az pipelines при первом запуске команды az pipelines . Подробнее о расширениях.

Управление Azure Pipelines.

Эта группа команд является частью расширения azure-devops.

Команды

Имя Описание Тип Состояние
az pipelines agent

Управление агентами.

 Extension GA
az pipelines agent list

Получение списка агентов в пуле.

 Extension GA
az pipelines agent show

Отображение сведений об агенте.

 Extension GA
az pipelines build

Управление сборками.

 Extension GA
az pipelines build cancel

Отменяется при выполнении сборки.

 Extension GA
az pipelines build definition

Управление определениями сборки.

 Extension GA
az pipelines build definition list

Перечисление определений сборки.

 Extension GA
az pipelines build definition show

Получение сведений об определении сборки.

 Extension GA
az pipelines build list

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

 Extension GA
az pipelines build queue

Запрос (очередь) сборки.

 Extension GA
az pipelines build show

Получение сведений о сборке.

 Extension GA
az pipelines build tag

Управление тегами сборки.

 Extension GA
az pipelines build tag add

Добавление тегов для сборки.

 Extension GA
az pipelines build tag delete

Удаление тега сборки.

 Extension GA
az pipelines build tag list

Получение тегов для сборки.

 Extension GA
az pipelines create

Создайте azure Pipeline (на основе YAML).

 Extension GA
az pipelines delete

Удаление конвейера.

 Extension GA
az pipelines folder

Управление папками для организации конвейеров.

 Extension GA
az pipelines folder create

Создайте папку.

 Extension GA
az pipelines folder delete

Удаление папки.

 Extension GA
az pipelines folder list

Вывод списка всех папок.

 Extension GA
az pipelines folder update

Обновите имя или описание папки.

 Extension GA
az pipelines list

Вывод списка конвейеров.

 Extension GA
az pipelines pool

Управление пулами агентов.

 Extension GA
az pipelines pool list

Вывод списка пулов агентов.

 Extension GA
az pipelines pool show

Отображение сведений о пуле агентов.

 Extension GA
az pipelines queue

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

 Extension GA
az pipelines queue list

Вывод списка очередей агента.

 Extension GA
az pipelines queue show

Отображение сведений о очереди агента.

 Extension GA
az pipelines release

Управление выпусками.

 Extension GA
az pipelines release create

Запрос (создание) выпуска.

 Extension GA
az pipelines release definition

Управление определениями выпуска.

 Extension GA
az pipelines release definition list

Вывод списка определений выпуска.

 Extension GA
az pipelines release definition show

Получение сведений о определении выпуска.

 Extension GA
az pipelines release list

Вывод списка результатов выпуска.

 Extension GA
az pipelines release show

Получение сведений о выпуске.

 Extension GA
az pipelines run

Очередь (запуск) конвейера.

 Extension GA
az pipelines runs

Управление выполнением конвейера.

 Extension GA
az pipelines runs artifact

Управление артефактами запуска конвейера.

 Extension GA
az pipelines runs artifact download

Скачайте артефакт конвейера.

 Extension GA
az pipelines runs artifact list

Вывод списка артефактов, связанных с выполнением.

 Extension GA
az pipelines runs artifact upload

Отправка артефакта конвейера.

 Extension GA
az pipelines runs list

Вывод списка запусков конвейера в проекте.

 Extension GA
az pipelines runs show

Отображение сведений о выполнении конвейера.

 Extension GA
az pipelines runs tag

Управление тегами запуска конвейера.

 Extension GA
az pipelines runs tag add

Добавление тегов для выполнения конвейера.

 Extension GA
az pipelines runs tag delete

Удаление тега запуска конвейера.

 Extension GA
az pipelines runs tag list

Получение тегов для выполнения конвейера.

 Extension GA
az pipelines show

Получение сведений о конвейере.

 Extension GA
az pipelines update

Обновление конвейера.

 Extension GA
az pipelines variable

Управление переменными конвейера.

 Extension GA
az pipelines variable-group

Управление группами переменных.

 Extension GA
az pipelines variable-group create

Создайте группу переменных.

 Extension GA
az pipelines variable-group delete

Удаление группы переменных.

 Extension GA
az pipelines variable-group list

Вывод списка групп переменных.

 Extension GA
az pipelines variable-group show

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

 Extension GA
az pipelines variable-group update

Обновите группу переменных.

 Extension GA
az pipelines variable-group variable

Управление переменными в группе переменных.

 Extension GA
az pipelines variable-group variable create

Добавьте переменную в группу переменных.

 Extension GA
az pipelines variable-group variable delete

Удалите переменную из группы переменных.

 Extension GA
az pipelines variable-group variable list

Вывод списка переменных в группе переменных.

 Extension GA
az pipelines variable-group variable update

Обновите переменную в группе переменных.

 Extension GA
az pipelines variable create

Добавьте переменную в конвейер.

 Extension GA
az pipelines variable delete

Удаление переменной из конвейера.

 Extension GA
az pipelines variable list

Вывод списка переменных в конвейере.

 Extension GA
az pipelines variable update

Обновите переменную в конвейере.

 Extension GA

az pipelines create

Создайте azure Pipeline (на основе YAML).

az pipelines create --name
                    [--branch]
                    [--description]
                    [--detect {false, true}]
                    [--folder-path]
                    [--org --organization]
                    [--project]
                    [--queue-id]
                    [--repository]
                    [--repository-type {github, tfsgit}]
                    [--service-connection]
                    [--skip-first-run --skip-run {false, true}]
                    [--yaml-path --yml-path]

Примеры

Создание Azure Pipeline из контекста локального репозитория извлечений

Repository name/url (--repository), type (--repository-type) and branch name (--branch) will be detected from the local git repository
az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'

Создание Azure Pipeline для репозитория, размещенного на Github, с помощью URL-адреса клонирования

az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository https://github.com/SampleOrg/SampleRepo --branch master

Создание Azure Pipeline для репозитория, размещенного в организации Github SampleOrg, имя репозитория SampleRepo

az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository SampleOrg/SampleRepoName --branch master --repository-type github

Создание Azure Pipeline для репозитория, размещенного в репозитории Azure в том же проекте

az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository SampleRepoName --branch master --repository-type tfsgit

Создание Azure Pipeline для репозитория с помощью yaml конвейера, уже зарегистрированного в репозитории.

Service connection required for non Azure Repos can be optionally provided in the command to run it non interatively
az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository https://github.com/SampleOrg/SampleRepo --branch master --yml-path azure-pipelines.yml [--service-connection SERVICE_CONNECTION]

Обязательные параметры

--name

Имя нового конвейера.

Необязательные параметры

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--branch

Имя ветви, для которой будет настроен конвейер. Если опущено, он будет автоматически обнаружен из локального репозитория.

--description

Описание нового конвейера.

--detect

Автоматическое определение организации.

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

Путь к папке, в которой необходимо создать конвейер. По умолчанию используется корневая папка. Например, "user1/test_pipelines".

--org --organization

URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.

--project -p

Имя или идентификатор проекта. Проект по умолчанию можно настроить с помощью az devops configure -d project=NAME_OR_ID. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git.

--queue-id

Идентификатор очереди в доступных пулах агентов. Будет автоматически обнаружен, если он не указан.

--repository

Репозиторий, для которого необходимо настроить конвейер. Можно клонировать URL-адрес репозитория Git или имя репозитория для репозитория Azure Repos или Owner/RepoName в случае репозитория GitHub. Если опущено, он будет автоматически обнаружен из удаленного URL-адреса локального репозитория Git. Если имя указано вместо URL-адреса, аргумент --repository-type также является обязательным.

--repository-type

Тип репозитория. Если опущено, он будет автоматически обнаружен из удаленного URL-адреса локального репозитория. Tfsgit для Azure Repos, github для репозитория GitHub.

Свойство Значение
Допустимые значения: github, tfsgit
--service-connection

Идентификатор подключения службы, созданного для репозитория для репозитория GitHub. Используйте команду az devops service-endpoint -h для создания и перечисления service_connections. Не требуется для Azure Repos.

--skip-first-run --skip-run

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

Свойство Значение
Допустимые значения: false, true
--yaml-path --yml-path

Путь к файлу yaml конвейеров в репозитории (если yaml уже присутствует в репозитории).

Глобальные параметры
--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 pipelines delete

Удаление конвейера.

az pipelines delete --id
                    [--detect {false, true}]
                    [--org --organization]
                    [--project]
                    [--yes]

Обязательные параметры

--id

Идентификатор конвейера.

Необязательные параметры

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--detect

Автоматическое определение организации.

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

URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.

--project -p

Имя или идентификатор проекта. Проект по умолчанию можно настроить с помощью az devops configure -d project=NAME_OR_ID. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git.

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

Вывод списка конвейеров.

az pipelines list [--detect {false, true}]
                  [--folder-path]
                  [--name]
                  [--org --organization]
                  [--project]
                  [--query-order {ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None}]
                  [--repository]
                  [--repository-type {bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol}]
                  [--top]

Необязательные параметры

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--detect

Автоматическое определение организации.

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

При указании фильтрует определения в этой папке.

--name

Ограничить результаты конвейерами с таким именем или начиная с этого имени. Примеры: FabCI или Fab*.

--org --organization

URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.

--project -p

Имя или идентификатор проекта. Проект по умолчанию можно настроить с помощью az devops configure -d project=NAME_OR_ID. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git.

--query-order

Порядок результатов.

Свойство Значение
Допустимые значения: ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None
--repository

Ограничить результаты конвейерами, связанными с этим репозиторием.

--repository-type

Ограничить результаты конвейерами, связанными с этим типом репозитория. Необходимо передать аргумент "репозиторий" вместе с этим аргументом.

Свойство Значение
Допустимые значения: bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol
--top

Максимальное количество конвейеров для списка.

Глобальные параметры
--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 pipelines run

Очередь (запуск) конвейера.

az pipelines run [--branch]
                 [--commit-id]
                 [--detect {false, true}]
                 [--folder-path]
                 [--id]
                 [--name]
                 [--open]
                 [--org --organization]
                 [--parameters]
                 [--project]
                 [--variables]

Необязательные параметры

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--branch

Имя ветви, в которой выполняется конвейер, должна быть поставлена в очередь. Пример: refs/heads/master или master или refs/pull/1/merge или refs/tags/tag.

--commit-id

Идентификатор фиксации, в котором выполняется конвейер, должен быть помещен в очередь.

--detect

Автоматическое определение организации.

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

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

--id

Идентификатор конвейера в очередь. Требуется, если --name не задано.

--name

Имя конвейера в очередь. Игнорируется, если указан идентификатор -id.

--open

Откройте страницу результатов конвейера в веб-браузере.

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

URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.

--parameters

Пробелы разделены парами "name=value" для параметров, которые вы хотите задать.

--project -p

Имя или идентификатор проекта. Проект по умолчанию можно настроить с помощью az devops configure -d project=NAME_OR_ID. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git.

--variables

Пробелы разделены парами "name=value" для переменных, которые вы хотите задать.

Глобальные параметры
--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 pipelines show

Получение сведений о конвейере.

az pipelines show [--detect {false, true}]
                  [--folder-path]
                  [--id]
                  [--name]
                  [--open]
                  [--org --organization]
                  [--project]

Необязательные параметры

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--detect

Автоматическое определение организации.

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

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

--id

Идентификатор конвейера.

--name

Имя конвейера. Игнорируется, если указан идентификатор -id.

--open

Откройте страницу сводки конвейера в веб-браузере.

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

URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.

--project -p

Имя или идентификатор проекта. Проект по умолчанию можно настроить с помощью az devops configure -d project=NAME_OR_ID. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git.

Глобальные параметры
--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 pipelines update

Обновление конвейера.

az pipelines update --id
                    [--branch]
                    [--description]
                    [--detect {false, true}]
                    [--new-folder-path]
                    [--new-name]
                    [--org --organization]
                    [--project]
                    [--queue-id]
                    [--yaml-path --yml-path]

Обязательные параметры

--id

Идентификатор конвейера для обновления.

Необязательные параметры

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--branch

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

--description

Новое описание конвейера.

--detect

Автоматическое определение организации.

Свойство Значение
Допустимые значения: false, true
--new-folder-path

Новый полный путь к папке для перемещения конвейера в. Например, "user1/production_pipelines".

--new-name

Новое обновленное имя конвейера.

--org --organization

URL-адрес организации Azure DevOps. Вы можете настроить организацию по умолчанию с помощью az devops configure -d organization=ORG_URL. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git. Пример: https://dev.azure.com/MyOrganizationName/.

--project -p

Имя или идентификатор проекта. Проект по умолчанию можно настроить с помощью az devops configure -d project=NAME_OR_ID. Требуется, если не настроено как по умолчанию или выбрано с помощью конфигурации Git.

--queue-id

Идентификатор очереди пула агентов, в котором должен выполняться конвейер.

--yaml-path --yml-path

Путь к yaml-файлу конвейеров в репозитории.

Глобальные параметры
--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