Partilhar via


Introdução à CLI do Azure DevOps

Serviços de DevOps do Azure

Com a extensão Azure DevOps para CLI (Interface de Linha de Comando) do Azure, você pode gerenciar muitos Serviços de DevOps do Azure a partir da linha de comando. 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 CLI (Interface de Linha de Comando) do Azure DevOps só está disponível para uso 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 usar a extensão Azure DevOps para CLI do Azure, execute as seguintes etapas:

  1. Instalar a CLI do Azure: siga as instruções fornecidas em Instalar a CLI do Azure para configurar seu ambiente da CLI do Azure. No mínimo, sua versão da CLI do Azure deve ser 2.10.1. Você pode usar az --version para validar.

  2. Adicione a extensão Azure DevOps:

     az extension add --name azure-devops
    

    Você pode usar az extension list ou az extension show --name azure-devops confirmar a instalação.

  3. Iniciar sessão: Executar az login para iniciar sessão. Observe que suportamos apenas interativo ou login usando nome de usuário e senha com az login. Para iniciar sessão utilizando um Token de Acesso Pessoal (PAT), consulte Iniciar sessão através do Token de Acesso Pessoal (PAT) do Azure DevOps.

Nota

Atualmente, a extensão do Azure DevOps não oferece suporte à autenticação com Identidades Gerenciadas.

  1. Configurar padrões: recomendamos que você defina a configuração padrão para sua organização e projeto. Caso contrário, você pode defini-los dentro dos próprios comandos individuais.

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

Uso do comando

Adicionar a Extensão de DevOps do Azure adiciona devops, pipelines, artifacts, boardse repos grupos. Para conteúdo de uso e ajuda para qualquer comando, insira 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 navegador

Você pode usar --open a opção para abrir qualquer artefato no portal do Azure DevOps em seu navegador padrão.

Por exemplo:

az pipelines build show --id 1 --open

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