Prise en main d’Azure DevOps CLI

  • Article

Azure DevOps Services

Avec l’extension Azure DevOps pour Azure Command Line Interface (CLI), vous pouvez gérer de nombreuses Azure DevOps Services à partir de la ligne de commande. Les commandes CLI vous permettent de rationaliser vos tâches avec un canevas interactif plus rapide et flexible, en contournant les workflows d’interface utilisateur.

Notes

L’interface de ligne de commande (CLI) Azure DevOps n’est disponible qu’avec Azure DevOps Services. L’extension Azure DevOps pour Azure CLI ne prend en charge aucune version de Azure DevOps Server.

Pour commencer à utiliser l’extension Azure DevOps pour Azure CLI, procédez comme suit :

  1. Installer Azure CLI : suivez les instructions fournies dans Installer Azure CLI pour configurer votre environnement Azure CLI. Au minimum, votre version d’Azure CLI doit être 2.10.1. Vous pouvez utiliser az --version pour valider.

  2. Ajoutez l’extension Azure DevOps :

     az extension add --name azure-devops

    Vous pouvez utiliser az extension list ou az extension show --name azure-devops pour confirmer l’installation.

  3. Connexion : exécutez az login pour vous connecter. Notez que nous prenons en charge uniquement l’interaction ou la connexion à l’aide du nom d’utilisateur et du mot de passe avec az login. Pour vous connecter à l’aide d’un jeton d’accès personnel (PAT), consultez Se connecter via Le jeton d’accès personnel (PAT) Azure DevOps.

  4. Configurer les valeurs par défaut : nous vous recommandons de définir la configuration par défaut pour votre organization et votre projet. Sinon, vous pouvez les définir dans les commandes individuelles elles-mêmes.

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

Utilisation de commande

L’ajout de l’extension Azure DevOps ajoute devops, pipelines, artifactsboardset repos des groupes. Pour l’utilisation et le contenu d’aide pour n’importe quelle commande, entrez le paramètre -h , par exemple :

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.

Ouvrir des éléments dans le navigateur

Vous pouvez utiliser --open switch pour ouvrir n’importe quel artefact dans le portail Azure DevOps dans votre navigateur par défaut.

Par exemple :

az pipelines build show --id 1 --open

Cette commande affiche les détails de build avec id 1 sur la ligne de commande et l’ouvre également dans le navigateur par défaut.