Introdução à CLI do Azure DevOps
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:
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.Adicione a extensão do Azure DevOps:
az extension add --name azure-devops
Pode utilizar
az extension list
ouaz extension show --name azure-devops
confirmar a instalação.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 comaz 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.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
, boards
e 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.