Compartilhar via


Introdução à CLI do Azure DevOps

Azure DevOps Services

Com a extensão do Azure DevOps para CLI (Interface de Linha de Comando) do Azure, você pode gerenciar muitos Azure DevOps Services na linha de comando. Os comandos da CLI permitem simplificar suas tarefas com tela interativa mais rápida e flexível, ignorando fluxos de trabalho da interface do usuário.

Observação

A CLI (Interface de Linha de Comando) do Azure DevOps só está disponível para uso com Azure DevOps Services. A extensão do Azure DevOps para a CLI do Azure não dá suporte a nenhuma versão do Azure DevOps Server.

Para começar a usar a extensão do 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 do Azure DevOps:

     az extension add --name azure-devops
    

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

  3. Entrar: Executar az login para entrar. Observe que oferecemos suporte apenas interativo ou login usando nome de usuário e senha com az login. Para entrar usando um PAT (Token de Acesso Pessoal), consulte Entrar por meio do PAT (Token de Acesso Pessoal) do Azure DevOps.

Observação

No momento, a extensão do Azure DevOps não dá 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 de comando

Adicionar a extensão do Azure DevOps adiciona devops, pipelines, artifacts, boardse repos grupos. Para uso e conteúdo de 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 switch para abrir qualquer artefato no portal do Azure DevOps em seu navegador padrão.

Por exemplo:

az pipelines build show --id 1 --open

Esse comando mostra os detalhes de build with id 1 na linha de comando e também o abre no navegador padrão.