Compartir vía

Inicio rápido: Introducción a la CLI de Azure DevOps

Azure DevOps Services

En este inicio rápido, configurará y empezará a usar la extensión de Azure DevOps para la interfaz de la línea de comandos (CLI) de Azure. Con la CLI de Azure, puede administrar muchos servicios de Azure DevOps desde la línea de comandos. Los comandos de la CLI de Azure permiten simplificar las tareas con un entorno interactivo más rápido y flexible, evitando los procesos de la interfaz de usuario.

Nota:

La CLI de Azure DevOps solo está disponible para su uso con Azure DevOps Services. La extensión de Azure DevOps para la CLI de Azure no admite ninguna versión de Azure DevOps Server.

Para empezar a usar la extensión de Azure DevOps para la CLI de Azure:

  1. Instale la CLI de Azure. Siga las instrucciones de Instalación de la CLI de Azure para configurar el entorno de la CLI de Azure. La versión mínima de la CLI de Azure debe ser la 2.10.1. Puede usar el az --version comando para validar.

  2. Agregue la extensión de Azure DevOps.

    az extension add --name azure-devops

  3. Para confirmar la instalación, ejecute el comando az extension list o az extension show --name azure-devops.

  4. Para iniciar sesión, ejecute el az login comando . La CLI de Azure solo admite el inicio de sesión interactivo mediante el nombre de usuario y la contraseña con az login. Para iniciar sesión con un token de acceso personal (PAT), consulte Inicio de sesión mediante PAT de Azure DevOps.

    Nota:

    La extensión de Azure DevOps no admite actualmente la autenticación mediante identidades administradas.

  5. Se recomienda establecer la configuración predeterminada para la organización y el proyecto. De lo contrario, puede especificar los valores en los propios comandos individuales.

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

Uso de comandos

La adición de la extensión de Azure DevOps también agrega los grupos devops, pipelines, artifacts, boards y repos.

Para el uso y el contenido de ayuda de cualquier comando, especifique el --help parámetro , por ejemplo:

az devops --help

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.

Apertura de elementos en el explorador

Puede usar --open el parámetro para abrir cualquier artefacto en el portal de Azure DevOps en el explorador predeterminado.

az pipelines build show --id 1 --open

Este comando muestra los detalles de la compilación con --id 1 en la ventana de la línea de comandos y lo abre también en el navegador predeterminado.