Udostępnij za pośrednictwem

Rozpoczynanie pracy z interfejsem wiersza polecenia usługi Azure DevOps

  • Artykuł

Azure DevOps Services

Rozszerzenie Azure DevOps dla interfejsu wiersza polecenia platformy Azure umożliwia zarządzanie wieloma usługami Azure DevOps Services z poziomu wiersza polecenia. Polecenia interfejsu wiersza polecenia umożliwiają optymalizację zadań dzięki szybszej i elastycznej interaktywnej kanwie z pominięciem przepływów pracy interfejsu użytkownika.

Uwaga

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

Aby rozpocząć korzystanie z rozszerzenia Usługi Azure DevOps dla interfejsu wiersza polecenia platformy Azure, wykonaj następujące kroki:

  1. Instalowanie interfejsu wiersza polecenia platformy Azure: postępuj zgodnie z instrukcjami podanymi w artykule 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. Możesz użyć az --version polecenia , aby zweryfikować.

  2. Dodaj rozszerzenie Usługi Azure DevOps:

     az extension add --name azure-devops

    Możesz użyć polecenia az extension list lub az extension show --name azure-devops potwierdzić instalację.

  3. Logowanie: uruchom polecenie az login , aby się zalogować. Należy pamiętać, że obsługujemy tylko interakcyjne lub logujemy się przy użyciu nazwy użytkownika i hasła za pomocą polecenia az login. Aby zalogować się przy użyciu osobistego tokenu dostępu (PAT), zobacz Logowanie się za pośrednictwem osobistego tokenu dostępu (PAT) usługi Azure DevOps.

Uwaga

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

  1. Skonfiguruj wartości domyślne: zalecamy ustawienie domyślnej konfiguracji dla organizacji i projektu. W przeciwnym razie można ustawić je w obrębie poszczególnych poleceń.

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

Użycie poleceń

Dodanie rozszerzenia Usługi Azure DevOps powoduje dodanie devopsgrup , , pipelinesartifacts, boardsi repos . Aby uzyskać informacje o użyciu i zawartości pomocy dla dowolnego polecenia, wprowadź parametr -h , na przykład:

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://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 przełącznika, aby otworzyć dowolny artefakt w portalu usługi Azure DevOps w domyślnej przeglądarce.

Na przykład:

az pipelines build show --id 1 --open

To polecenie wyświetla szczegóły kompilacji id 1 w wierszu polecenia, a także otwiera je w domyślnej przeglądarce.