Introducción a la CLI de Azure DevOps

  • Artículo
  • Tiempo de lectura: 2 minutos

Azure DevOps Services | Azure DevOps Server 2020

Con la Azure DevOps para la interfaz de la línea de comandos (CLI) de Azure, puede administrar muchos Azure DevOps Services desde 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 está disponible para Azure DevOps Server 2020 y Azure DevOps Services.

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. Al conectarse a una instancia de servidor local, es posible que sea necesario iniciar sesión con un PAT para ejecutar determinados comandos.

  4. 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

    Si quiere conectarse a una instancia de Azure DevOps Server, especifique la URL de la instancia del servidor. Por ejemplo:

     az devops configure --defaults organization=https://ServerName/CollectionName project=ProjectName

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://docs.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.