Udostępnij za pośrednictwem

Szybki start: rozpoczynanie pracy z interfejsem wiersza polecenia usługi Azure DevOps

Azure DevOps Services

W tym szybkim przewodniku skonfigurujesz i zaczniesz korzystać z rozszerzenia Azure DevOps dla Azure Command Line Interface (CLI). Za pomocą interfejsu wiersza polecenia platformy Azure można zarządzać wieloma usługami Azure DevOps Services z poziomu wiersza polecenia. Polecenia Azure CLI umożliwiają usprawnić realizację zadań dzięki szybszemu i elastycznemu interaktywnemu środowisku, pomijając procesy związane z interfejsem użytkownika.

Uwaga

Interfejs wiersza polecenia usługi Azure DevOps jest dostępny tylko do użycia z usługami Azure DevOps Services. Rozszerzenie Azure DevOps dla interfejsu wiersza polecenia platformy Azure nie obsługuje żadnej wersji Azure DevOps Server.

Aby rozpocząć korzystanie z rozszerzenia Usługi Azure DevOps dla interfejsu wiersza polecenia platformy Azure:

  1. Zainstaluj interfejs wiersza polecenia platformy Azure. Postępuj zgodnie z instrukcjami w temacie Instalowanie interfejsu wiersza polecenia platformy Azure , aby skonfigurować środowisko interfejsu wiersza polecenia platformy Azure. Co najmniej wersja interfejsu wiersza polecenia platformy Azure musi mieć wartość 2.10.1. Aby sprawdzić poprawność, możesz użyć az --version polecenia .

  2. Dodaj rozszerzenie Usługi Azure DevOps.

    az extension add --name azure-devops

  3. Aby potwierdzić instalację, uruchom polecenie az extension list lub az extension show --name azure-devops.

  4. Aby się zalogować, uruchom az login polecenie . Interfejs wiersza polecenia platformy Azure obsługuje tylko logowanie interakcyjne przy użyciu nazwy użytkownika i hasła przy użyciu polecenia az login. Aby zalogować się przy użyciu osobistego tokenu dostępu (PAT), zobacz Logowanie za pośrednictwem osobistego tokenu dostępu usługi Azure DevOps.

    Uwaga

    Rozszerzenie Usługi Azure DevOps nie obsługuje obecnie uwierzytelniania przy użyciu tożsamości zarządzanych.

  5. Zalecamy ustawienie domyślnej konfiguracji dla organizacji i projektu. W przeciwnym razie można ustawić wartości w poszczególnych poleceniach.

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

Używanie poleceń

Dodanie rozszerzenia Azure DevOps dodaje grupy devops, pipelines, artifacts, boards i repos.

Aby uzyskać informacje o użyciu i zawartości pomocy dla dowolnego polecenia, określ --help parametr, na przykład:

az devops --help

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://learn.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.

Otwieranie elementów w przeglądarce

Możesz użyć --open parametru , aby otworzyć dowolny artefakt w portalu usługi Azure DevOps w domyślnej przeglądarce.

az pipelines build show --id 1 --open

To polecenie wyświetla w oknie wiersza polecenia szczegóły kompilacji związane z --id 1 i otwiera je również w domyślnej przeglądarce.