Приступая к работе с интерфейсом командной строки Azure DevOps

Azure DevOps Services | Azure DevOps Server 2020

С помощью расширения Azure DevOps для интерфейса командной строки Azure (CLI) можно управлять многими службами Azure DevOps Services из командной строки. Команды CLI позволяют оптимизировать задачи с помощью быстрого и гибкого интерактивного холста, минуя рабочие процессы пользовательского интерфейса.

Примечание

Интерфейс командной строки (CLI) Azure DevOps доступен для Azure DevOps Server 2020 и Azure DevOps Services.

Чтобы приступить к использованию расширения Azure DevOps для Azure CLI, выполните следующие действия:

  1. Установите Azure CLI: следуйте инструкциям, приведенным в разделе Установка Azure CLI, чтобы настроить среду Azure CLI. Версия Azure CLI должна быть не ниже 2.10.1. Для проверки можно использовать команду az --version.

  2. Добавьте расширение Azure DevOps:

    az extension add --name azure-devops
    

    Для подтверждения установки можно использовать команды az extension list или az extension show --name azure-devops.

  3. Выполните вход: выполните команду az login, чтобы войти в систему. Обратите внимание, что поддерживается только интерактивный или вход с использованием имени пользователя и пароля с помощью команды az login. Чтобы выполнить вход с помощью личного маркера доступа (PAT), см. статью Вход с помощью личного маркера доступа (PAT) Azure DevOps. При подключении к локальному экземпляру сервера для запуска команд SELECT может потребоваться выполнить вход с использованием PAT.

  4. Настройте значения по умолчанию: рекомендуется задать конфигурацию по умолчанию для организации и проекта. Эту конфигурацию также можно задать, выполнив отдельные команды.

    az devops configure --defaults organization=https://dev.azure.com/contoso project=ContosoWebApp
    

    Если вы подключаетесь к Azure DevOps Server, укажите URL-адрес экземпляра сервера. Пример.

    az devops configure --defaults organization=https://ServerName/CollectionName project=ProjectName
    

Использование команды

При добавлении расширения Azure DevOps добавляются группы devops, pipelines, artifacts, boards и repos. Чтобы получить сведения об использовании и справку для любой команды, используйте параметр -h, например:

$ az devops -h
   
Group
    az devops : Manage Azure DevOps organization level operations.
        Related Groups
        az pipelines: Manage Azure Pipelines
        az boards: Manage Azure Boards
        az repos: Manage Azure Repos
        az artifacts: Manage Azure Artifacts.
   
Subgroups:
    admin            : Manage administration operations.
    extension        : Manage extensions.
    project          : Manage team projects.
    security         : Manage security related operations.
    service-endpoint : Manage service endpoints/service connections.
    team             : Manage teams.
    user             : Manage users.
    wiki             : Manage wikis.

Commands:
    configure        : Configure the Azure DevOps CLI or view your configuration.
    feedback         : Displays information on how to provide feedback to the Azure DevOps CLI team.
    invoke           : This command will invoke request for any DevOps area and resource. Please use
                       only json output as the response of this command is not fixed. Helpful docs -
                       https://docs.microsoft.com/rest/api/azure/devops/.
    login            : Set the credential (PAT) to use for a particular organization.
    logout           : Clear the credential for all or a particular organization.

Открытие элементов в браузере

Используя параметр --open, можно открыть любой артефакт на портале Azure DevOps в браузере по умолчанию.

Например:

az pipelines build show --id 1 --open

Эта команда отображает сведения о сборке с id 1 в командной строке и в браузере по умолчанию.