Compartir a través de


Introducción a la CLI de Azure DevOps

Azure DevOps Services

Con la extensión de Azure DevOps para la interfaz de la línea de comandos (CLI) de Azure, puede administrar diversas instancias de Azure DevOps Services mediante la línea de comandos. Los comandos de la CLI le permiten simplificar las tareas con lienzos interactivos más rápidos y flexibles, y omitir los flujos de trabajo de la interfaz de usuario.

Nota:

La interfaz de la línea de comandos (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, siga estos pasos:

  1. Instale la CLI de Azure. Para configurar el entorno de la CLI de Azure, siga las instrucciones que encontrará en Instalación de la CLI de Azure. La versión mínima de la CLI de Azure debe ser la 2.10.1. Puede usar az --version para llevar a cabo la validación.

  2. Agregue la extensión de Azure DevOps:

     az extension add --name azure-devops
    

    Puede usar az extension list o az extension show --name azure-devops para confirmar la instalación.

  3. Inicie sesión; para ello, ejecute az login. Tenga en cuenta que solo se admite el inicio de sesión interactivo, o mediante nombre de usuario y contraseña con az login. Para iniciar sesión con un token de acceso personal (PAT), consulte Inicio de sesión con un token de acceso personal (PAT) de Azure DevOps.

Nota:

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

  1. Configure los valores predeterminados; se recomienda establecer la configuración predeterminada para la organización y el proyecto. De lo contrario, puede definir dichos valores predeterminados con los comandos individuales.

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

Uso de los comandos

La adición de la extensión de Azure DevOps también agrega los grupos devops, pipelines, artifacts, boards y repos. Para acceder a contenido de ayuda y sobre el uso de algún comando, escriba el parámetro -h, por ejemplo:

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.

Apertura de elementos en el explorador

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

Por ejemplo:

az pipelines build show --id 1 --open

Este comando muestra los detalles de la compilación con id 1 en la línea de comandos. También se abre en el explorador predeterminado.