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

az pipelines

  • Ссылка

Примечание.

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

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

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

Команды

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

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

 Расширение ГА
az pipelines agent list

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

 Расширение ГА
az pipelines agent show

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

 Расширение ГА
az pipelines build

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

 Расширение ГА
az pipelines build cancel

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

 Расширение ГА
az pipelines build definition

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

 Расширение ГА
az pipelines build definition list

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

 Расширение ГА
az pipelines build definition show

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

 Расширение ГА
az pipelines build list

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

 Расширение ГА
az pipelines build queue

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

 Расширение ГА
az pipelines build show

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

 Расширение ГА
az pipelines build tag

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

 Расширение ГА
az pipelines build tag add

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

 Расширение ГА
az pipelines build tag delete

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

 Расширение ГА
az pipelines build tag list

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

 Расширение ГА
az pipelines create

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

 Расширение ГА
az pipelines delete

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

 Расширение ГА
az pipelines folder

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

 Расширение ГА
az pipelines folder create

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

 Расширение ГА
az pipelines folder delete

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

 Расширение ГА
az pipelines folder list

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

 Расширение ГА
az pipelines folder update

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

 Расширение ГА
az pipelines list

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

 Расширение ГА
az pipelines pool

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

 Расширение ГА
az pipelines pool list

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

 Расширение ГА
az pipelines pool show

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

 Расширение ГА
az pipelines queue

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

 Расширение ГА
az pipelines queue list

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

 Расширение ГА
az pipelines queue show

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

 Расширение ГА
az pipelines release

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

 Расширение ГА
az pipelines release create

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

 Расширение ГА
az pipelines release definition

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

 Расширение ГА
az pipelines release definition list

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

 Расширение ГА
az pipelines release definition show

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

 Расширение ГА
az pipelines release list

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

 Расширение ГА
az pipelines release show

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

 Расширение ГА
az pipelines run

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

 Расширение ГА
az pipelines runs

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

 Расширение ГА
az pipelines runs artifact

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

 Расширение ГА
az pipelines runs artifact download

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

 Расширение ГА
az pipelines runs artifact list

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

 Расширение ГА
az pipelines runs artifact upload

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

 Расширение ГА
az pipelines runs list

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

 Расширение ГА
az pipelines runs show

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

 Расширение ГА
az pipelines runs tag

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

 Расширение ГА
az pipelines runs tag add

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

 Расширение ГА
az pipelines runs tag delete

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

 Расширение ГА
az pipelines runs tag list

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

 Расширение ГА
az pipelines show

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

 Расширение ГА
az pipelines update

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

 Расширение ГА
az pipelines variable

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

 Расширение ГА
az pipelines variable-group

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

 Расширение ГА
az pipelines variable-group create

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

 Расширение ГА
az pipelines variable-group delete

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

 Расширение ГА
az pipelines variable-group list

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

 Расширение ГА
az pipelines variable-group show

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

 Расширение ГА
az pipelines variable-group update

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

 Расширение ГА
az pipelines variable-group variable

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

 Расширение ГА
az pipelines variable-group variable create

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

 Расширение ГА
az pipelines variable-group variable delete

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

 Расширение ГА
az pipelines variable-group variable list

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

 Расширение ГА
az pipelines variable-group variable update

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

 Расширение ГА
az pipelines variable create

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

 Расширение ГА
az pipelines variable delete

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

 Расширение ГА
az pipelines variable list

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

 Расширение ГА
az pipelines variable update

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

 Расширение ГА

az pipelines create

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

az pipelines create --name
                    [--branch]
                    [--description]
                    [--detect {false, true}]
                    [--folder-path]
                    [--org]
                    [--project]
                    [--queue-id]
                    [--repository]
                    [--repository-type {github, tfsgit}]
                    [--service-connection]
                    [--skip-first-run {false, true}]
                    [--yaml-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

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

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

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

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

--help -h

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

--only-show-errors

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

--output -o

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

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

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

--subscription

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

--verbose

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

az pipelines delete

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

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

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

--id

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

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

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

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

--help -h

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

--only-show-errors

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

--output -o

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

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

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

--subscription

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

--verbose

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

az pipelines list

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

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

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

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

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

--help -h

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

--only-show-errors

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

--output -o

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

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

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

--subscription

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

--verbose

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

az pipelines run

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

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

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

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

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

--help -h

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

--only-show-errors

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

--output -o

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

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

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

--subscription

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

--verbose

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

az pipelines show

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

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

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

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

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

--help -h

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

--only-show-errors

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

--output -o

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

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

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

--subscription

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

--verbose

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

az pipelines update

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

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

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

--id

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

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

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

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

--help -h

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

--only-show-errors

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

--output -o

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

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

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

--subscription

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

--verbose

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