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


az pipelines

Примечание.

Эта ссылка является частью расширения azure-devops для Azure CLI (версия 2.30.0 или более поздней). Расширение автоматически установит команду az pipelines при первом запуске команды 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 из локального контекста репозитория проверка out

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
значение по умолчанию: 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

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

значение по умолчанию: False
Глобальные параметры
--debug

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: 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
значение по умолчанию: 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

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

значение по умолчанию: 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
значение по умолчанию: 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

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

значение по умолчанию: 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
значение по умолчанию: 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
значение по умолчанию: json
--query

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

--subscription

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

--verbose

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