Compartir a través de

az pipelines

Note

Esta referencia forma parte de la extensión azure-devops para la CLI de Azure (versión 2.30.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az pipelines . Obtenga más información sobre las extensiones.

Administrar Azure Pipelines.

Este grupo de comandos forma parte de la extensión azure-devops.

Comandos

Nombre Description Tipo Estado
az pipelines agent

Administrar agentes.

 Extension GA
az pipelines agent list

Obtenga una lista de agentes de un grupo.

 Extension GA
az pipelines agent show

Mostrar los detalles del agente.

 Extension GA
az pipelines build

Administrar compilaciones.

 Extension GA
az pipelines build cancel

Cancela si se está ejecutando la compilación.

 Extension GA
az pipelines build definition

Administrar definiciones de compilación.

 Extension GA
az pipelines build definition list

Enumerar definiciones de compilación.

 Extension GA
az pipelines build definition show

Obtenga los detalles de una definición de compilación.

 Extension GA
az pipelines build list

Enumerar los resultados de la compilación.

 Extension GA
az pipelines build queue

Solicite (cola) una compilación.

 Extension GA
az pipelines build show

Obtenga los detalles de una compilación.

 Extension GA
az pipelines build tag

Administrar etiquetas de compilación.

 Extension GA
az pipelines build tag add

Agregue etiquetas para una compilación.

 Extension GA
az pipelines build tag delete

Elimine una etiqueta de compilación.

 Extension GA
az pipelines build tag list

Obtiene etiquetas para una compilación.

 Extension GA
az pipelines create

Cree una nueva canalización de Azure (basada en YAML).

 Extension GA
az pipelines delete

Elimine una canalización.

 Extension GA
az pipelines folder

Administrar carpetas para organizar canalizaciones.

 Extension GA
az pipelines folder create

Cree una carpeta.

 Extension GA
az pipelines folder delete

Elimine una carpeta.

 Extension GA
az pipelines folder list

Enumera todas las carpetas.

 Extension GA
az pipelines folder update

Actualice un nombre de carpeta o una descripción.

 Extension GA
az pipelines list

Enumerar canalizaciones.

 Extension GA
az pipelines pool

Administrar grupos de agentes.

 Extension GA
az pipelines pool list

Enumera los grupos de agentes.

 Extension GA
az pipelines pool show

Mostrar los detalles del grupo de agentes.

 Extension GA
az pipelines queue

Administrar colas de agentes.

 Extension GA
az pipelines queue list

Enumerar las colas del agente.

 Extension GA
az pipelines queue show

Mostrar detalles de la cola del agente.

 Extension GA
az pipelines release

Administrar versiones.

 Extension GA
az pipelines release create

Solicite (cree) una versión.

 Extension GA
az pipelines release definition

Administrar definiciones de versión.

 Extension GA
az pipelines release definition list

Enumera las definiciones de versión.

 Extension GA
az pipelines release definition show

Obtenga los detalles de una definición de versión.

 Extension GA
az pipelines release list

Enumerar los resultados de la versión.

 Extension GA
az pipelines release show

Obtenga los detalles de una versión.

 Extension GA
az pipelines run

Cola (ejecución) de una canalización.

 Extension GA
az pipelines runs

Administrar ejecuciones de canalización.

 Extension GA
az pipelines runs artifact

Administrar artefactos de ejecución de canalización.

 Extension GA
az pipelines runs artifact download

Descargue un artefacto de canalización.

 Extension GA
az pipelines runs artifact list

Enumerar artefactos asociados a una ejecución.

 Extension GA
az pipelines runs artifact upload

Cargue un artefacto de canalización.

 Extension GA
az pipelines runs list

Enumerar las ejecuciones de canalización en un proyecto.

 Extension GA
az pipelines runs show

Mostrar detalles de una ejecución de canalización.

 Extension GA
az pipelines runs tag

Administrar etiquetas de ejecución de canalización.

 Extension GA
az pipelines runs tag add

Agregue etiquetas para una ejecución de canalización.

 Extension GA
az pipelines runs tag delete

Elimine una etiqueta de ejecución de canalización.

 Extension GA
az pipelines runs tag list

Obtiene etiquetas para una ejecución de canalización.

 Extension GA
az pipelines show

Obtenga los detalles de una canalización.

 Extension GA
az pipelines update

Actualizar una canalización.

 Extension GA
az pipelines variable

Administrar variables de canalización.

 Extension GA
az pipelines variable-group

Administrar grupos de variables.

 Extension GA
az pipelines variable-group create

Cree un grupo de variables.

 Extension GA
az pipelines variable-group delete

Elimine un grupo de variables.

 Extension GA
az pipelines variable-group list

Enumerar grupos de variables.

 Extension GA
az pipelines variable-group show

Mostrar los detalles del grupo de variables.

 Extension GA
az pipelines variable-group update

Actualice un grupo de variables.

 Extension GA
az pipelines variable-group variable

Administrar variables en un grupo de variables.

 Extension GA
az pipelines variable-group variable create

Agregue una variable a un grupo de variables.

 Extension GA
az pipelines variable-group variable delete

Elimine una variable del grupo de variables.

 Extension GA
az pipelines variable-group variable list

Enumere las variables de un grupo de variables.

 Extension GA
az pipelines variable-group variable update

Actualice una variable en un grupo de variables.

 Extension GA
az pipelines variable create

Agregue una variable a una canalización.

 Extension GA
az pipelines variable delete

Elimine una variable de la canalización.

 Extension GA
az pipelines variable list

Enumere las variables de una canalización.

 Extension GA
az pipelines variable update

Actualice una variable en una canalización.

 Extension GA

az pipelines create

Cree una nueva canalización de Azure (basada en YAML).

az pipelines create --name
                    [--branch]
                    [--description]
                    [--detect {false, true}]
                    [--folder-path]
                    [--org --organization]
                    [--project]
                    [--queue-id]
                    [--repository]
                    [--repository-type {github, tfsgit}]
                    [--service-connection]
                    [--skip-first-run --skip-run {false, true}]
                    [--yaml-path --yml-path]

Ejemplos

Creación de una canalización de Azure desde el contexto del repositorio de desprotección local

Repository name/url (--repository), type (--repository-type) and branch name (--branch) will be detected from the local git repository
az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'

Creación de una canalización de Azure para un repositorio hospedado en Github mediante la dirección URL de clonación

az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository https://github.com/SampleOrg/SampleRepo --branch master

Creación de una canalización de Azure para un repositorio hospedado en la organización de Github SampleOrg, nombre del repositorio SampleRepo

az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository SampleOrg/SampleRepoName --branch master --repository-type github

Creación de una canalización de Azure para un repositorio hospedado en Azure Repo en el mismo proyecto

az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository SampleRepoName --branch master --repository-type tfsgit

Creación de una canalización de Azure para un repositorio con el yaml de canalización ya protegido en el repositorio

Service connection required for non Azure Repos can be optionally provided in the command to run it non interatively
az pipelines create --name 'ContosoBuild' --description 'Pipeline for contoso project'
--repository https://github.com/SampleOrg/SampleRepo --branch master --yml-path azure-pipelines.yml [--service-connection SERVICE_CONNECTION]

Parámetros requeridos

--name

Nombre de la nueva canalización.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--branch

Nombre de rama para el que se configurará la canalización. Si se omite, se detectará automáticamente desde el repositorio local.

--description

Descripción de la nueva canalización.

--detect

Detectar automáticamente la organización.

Propiedad Valor
Valores aceptados: false, true
--folder-path

Ruta de acceso de la carpeta donde se debe crear la canalización. El valor predeterminado es la carpeta raíz. Por ejemplo, "user1/test_pipelines".

--org --organization

Dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

Nombre o identificador del proyecto. Puede configurar el proyecto predeterminado mediante az devops configure -d project=NAME_OR_ID. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git.

--queue-id

Identificador de la cola en los grupos de agentes disponibles. Se detectará automáticamente si no se especifica.

--repository

Repositorio para el que se debe configurar la canalización. Puede clonar la dirección URL del repositorio de Git o el nombre del repositorio para azure Repos o Owner/RepoName en el caso del repositorio de GitHub. Si se omite, se detectará automáticamente desde la dirección URL remota del repositorio git local. Si se menciona name en lugar de url, también se requiere el argumento --repository-type.

--repository-type

Tipo de repositorio. Si se omite, se detectará automáticamente desde la dirección URL remota del repositorio local. "tfsgit" para Azure Repos, "github" para el repositorio de GitHub.

Propiedad Valor
Valores aceptados: github, tfsgit
--service-connection

Identificador de la conexión de servicio creada para el repositorio de GitHub. Use el comando az devops service-endpoint -h para crear o enumerar service_connections. No es necesario para Azure Repos.

--skip-first-run --skip-run

Especifique esta marca para evitar que el comando desencadene la primera ejecución. El comando devolverá una canalización si se omite la ejecución; de lo contrario, generará una ejecución de canalización.

Propiedad Valor
Valores aceptados: false, true
--yaml-path --yml-path

Ruta de acceso del archivo yaml de canalizaciones en el repositorio (si yaml ya está presente en el repositorio).

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az pipelines delete

Elimine una canalización.

az pipelines delete --id
                    [--detect {false, true}]
                    [--org --organization]
                    [--project]
                    [--yes]

Parámetros requeridos

--id

Identificador de la canalización.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--detect

Detectar automáticamente la organización.

Propiedad Valor
Valores aceptados: false, true
--org --organization

Dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

Nombre o identificador del proyecto. Puede configurar el proyecto predeterminado mediante az devops configure -d project=NAME_OR_ID. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git.

--yes -y

No solicita confirmación.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az pipelines list

Enumerar canalizaciones.

az pipelines list [--detect {false, true}]
                  [--folder-path]
                  [--name]
                  [--org --organization]
                  [--project]
                  [--query-order {ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None}]
                  [--repository]
                  [--repository-type {bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol}]
                  [--top]

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--detect

Detectar automáticamente la organización.

Propiedad Valor
Valores aceptados: false, true
--folder-path

Si se especifica, filtra por definiciones en esta carpeta.

--name

Limite los resultados a las canalizaciones con este nombre o empezando por este nombre. Ejemplos: "FabCI" o "Fab*".

--org --organization

Dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

Nombre o identificador del proyecto. Puede configurar el proyecto predeterminado mediante az devops configure -d project=NAME_OR_ID. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git.

--query-order

Orden de los resultados.

Propiedad Valor
Valores aceptados: ModifiedAsc, ModifiedDesc, NameAsc, NameDesc, None
--repository

Limite los resultados a las canalizaciones asociadas a este repositorio.

--repository-type

Limite los resultados a las canalizaciones asociadas a este tipo de repositorio. Es obligatorio pasar el argumento "repository" junto con este argumento.

Propiedad Valor
Valores aceptados: bitbucket, git, github, githubenterprise, svn, tfsgit, tfsversioncontrol
--top

Número máximo de canalizaciones que se van a enumerar.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az pipelines run

Cola (ejecución) de una canalización.

az pipelines run [--branch]
                 [--commit-id]
                 [--detect {false, true}]
                 [--folder-path]
                 [--id]
                 [--name]
                 [--open]
                 [--org --organization]
                 [--parameters]
                 [--project]
                 [--variables]

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--branch

Nombre de la rama en la que se va a poner en cola la ejecución de la canalización. Ejemplo: refs/head/master o master o refs/pull/1/merge o refs/tags/tag.

--commit-id

Commit-id en el que se va a poner en cola la ejecución de la canalización.

--detect

Detectar automáticamente la organización.

Propiedad Valor
Valores aceptados: false, true
--folder-path

Ruta de acceso de carpeta de la canalización. El valor predeterminado es la carpeta de nivel raíz.

--id

Identificador de la canalización que se va a poner en cola. Obligatorio si no se proporciona --name.

--name

Nombre de la canalización que se va a poner en cola. Se omite si se proporciona --id.

--open

Abra la página de resultados de la canalización en el explorador web.

Propiedad Valor
Valor predeterminado: False
--org --organization

Dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--parameters

Pares "name=value" separados por espacios para los parámetros que desea establecer.

--project -p

Nombre o identificador del proyecto. Puede configurar el proyecto predeterminado mediante az devops configure -d project=NAME_OR_ID. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git.

--variables

Pares "name=value" separados por espacios para las variables que desea establecer.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az pipelines show

Obtenga los detalles de una canalización.

az pipelines show [--detect {false, true}]
                  [--folder-path]
                  [--id]
                  [--name]
                  [--open]
                  [--org --organization]
                  [--project]

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--detect

Detectar automáticamente la organización.

Propiedad Valor
Valores aceptados: false, true
--folder-path

Ruta de acceso de carpeta de la canalización. El valor predeterminado es la carpeta de nivel raíz.

--id

Identificador de la canalización.

--name

Nombre de la canalización. Se omite si se proporciona --id.

--open

Abra la página de resumen de canalización en el explorador web.

Propiedad Valor
Valor predeterminado: False
--org --organization

Dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

Nombre o identificador del proyecto. Puede configurar el proyecto predeterminado mediante az devops configure -d project=NAME_OR_ID. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az pipelines update

Actualizar una canalización.

az pipelines update --id
                    [--branch]
                    [--description]
                    [--detect {false, true}]
                    [--new-folder-path]
                    [--new-name]
                    [--org --organization]
                    [--project]
                    [--queue-id]
                    [--yaml-path --yml-path]

Parámetros requeridos

--id

Identificador de la canalización que se va a actualizar.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--branch

Nombre de rama para el que se configurará la canalización.

--description

Nueva descripción de la canalización.

--detect

Detectar automáticamente la organización.

Propiedad Valor
Valores aceptados: false, true
--new-folder-path

Nueva ruta de acceso completa de la carpeta a la que se va a mover la canalización. Por ejemplo, "user1/production_pipelines".

--new-name

Nuevo nombre actualizado de la canalización.

--org --organization

Dirección URL de la organización de Azure DevOps. Puede configurar la organización predeterminada mediante az devops configure -d organization=ORG_URL. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

Nombre o identificador del proyecto. Puede configurar el proyecto predeterminado mediante az devops configure -d project=NAME_OR_ID. Obligatorio si no está configurado como predeterminado o seleccionado a través de la configuración de Git.

--queue-id

Id. de cola del grupo de agentes donde debe ejecutarse la canalización.

--yaml-path --yml-path

Ruta de acceso del archivo yaml de canalizaciones en el repositorio.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False