Introdução à CLI do Azure DevOps

  • Artigo

Azure DevOps Services

Com a extensão do Azure DevOps para a Interface de Linha de Comandos (CLI) do Azure, pode gerir muitos Serviços do Azure DevOps a partir da linha de comandos. Os comandos da CLI permitem-lhe simplificar as suas tarefas com telas interativas mais rápidas e flexíveis, ignorando os fluxos de trabalho da interface de utilizador.

Nota

A Interface de Linha de Comandos (CLI) do Azure DevOps só está disponível para utilização com os Serviços de DevOps do Azure. A extensão do Azure DevOps para a CLI do Azure não suporta nenhuma versão do Azure DevOps Server.

Para começar a utilizar a extensão do Azure DevOps para a CLI do Azure, execute os seguintes passos:

  1. Instalar a CLI do Azure: siga as instruções fornecidas em Instalar a CLI do Azure para configurar o ambiente da CLI do Azure. No mínimo, a versão da CLI do Azure tem de ser 2.10.1. Pode utilizar az --version para validar.

  2. Adicione a extensão do Azure DevOps:

     az extension add --name azure-devops

    Pode utilizar az extension list ou az extension show --name azure-devops confirmar a instalação.

  3. Iniciar sessão: execute az login para iniciar sessão. Tenha em atenção que só suportamos o início de sessão interativo ou com o nome de utilizador e a palavra-passe com az login. Para iniciar sessão com um Token de Acesso Pessoal (PAT), veja Iniciar sessão através do Token de Acesso Pessoal (PAT) do Azure DevOps.

  4. Configurar predefinições: recomendamos que defina a configuração predefinida para a sua organização e projeto. Caso contrário, pode defini-los nos próprios comandos individuais.

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

Utilização de comandos

Adicionar a Extensão de DevOps do Azure adiciona devops, pipelines, artifacts, boardse repos grupos. Para conteúdos de utilização e ajuda para qualquer comando, introduza o parâmetro -h , por exemplo:

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.

Abrir itens no browser

Pode utilizar --open o comutador para abrir qualquer artefacto no portal do Azure DevOps no browser predefinido.

Por exemplo:

az pipelines build show --id 1 --open

Este comando mostra os detalhes da compilação com id 1 na linha de comandos e também o abre no browser predefinido.