az pipelines

Nota:

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 se 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

az pipelines agent	Administrar agentes.
az pipelines agent list	Obtenga una lista de agentes de un grupo.
az pipelines agent show	Mostrar los detalles del agente.
az pipelines build	Administrar compilaciones.
az pipelines build cancel	Cancela si se está ejecutando la compilación.
az pipelines build definition	Administrar definiciones de compilación.
az pipelines build definition list	Enumerar definiciones de compilación.
az pipelines build definition show	Obtenga los detalles de una definición de compilación.
az pipelines build list	Enumerar los resultados de la compilación.
az pipelines build queue	Solicite (cola) una compilación.
az pipelines build show	Obtenga los detalles de una compilación.
az pipelines build tag	Administrar etiquetas de compilación.
az pipelines build tag add	Agregue etiquetas para una compilación.
az pipelines build tag delete	Elimine una etiqueta de compilación.
az pipelines build tag list	Obtenga etiquetas para una compilación.
az pipelines create	Cree una nueva canalización de Azure (basada en YAML).
az pipelines delete	Elimine una canalización.
az pipelines folder	Administrar carpetas para organizar las canalizaciones.
az pipelines folder create	Cree una carpeta.
az pipelines folder delete	Elimine una carpeta.
az pipelines folder list	Enumera todas las carpetas.
az pipelines folder update	Actualice un nombre o una descripción de carpeta.
az pipelines list	Enumerar canalizaciones.
az pipelines pool	Administrar grupos de agentes.
az pipelines pool list	Enumerar grupos de agentes.
az pipelines pool show	Mostrar los detalles del grupo de agentes.
az pipelines queue	Administrar colas de agentes.
az pipelines queue list	Enumerar las colas del agente.
az pipelines queue show	Muestra los detalles de la cola del agente.
az pipelines release	Administrar versiones.
az pipelines release create	Solicite (cree) una versión.
az pipelines release definition	Administrar definiciones de versión.
az pipelines release definition list	Enumera las definiciones de versión.
az pipelines release definition show	Obtenga los detalles de una definición de versión.
az pipelines release list	Enumerar los resultados de la versión.
az pipelines release show	Obtenga los detalles de una versión.
az pipelines run	Cola (ejecución) de una canalización.
az pipelines runs	Administrar ejecuciones de canalización.
az pipelines runs artifact	Administrar artefactos de ejecución de canalización.
az pipelines runs artifact download	Descargue un artefacto de canalización.
az pipelines runs artifact list	Enumerar artefactos asociados a una ejecución.
az pipelines runs artifact upload	Cargue un artefacto de canalización.
az pipelines runs list	Enumere las ejecuciones de canalización en un proyecto.
az pipelines runs show	Mostrar detalles de una ejecución de canalización.
az pipelines runs tag	Administrar etiquetas de ejecución de canalización.
az pipelines runs tag add	Agregue etiquetas para una ejecución de canalización.
az pipelines runs tag delete	Elimine una etiqueta de ejecución de canalización.
az pipelines runs tag list	Obtenga etiquetas para una ejecución de canalización.
az pipelines show	Obtenga los detalles de una canalización.
az pipelines update	Actualizar una canalización.
az pipelines variable	Administrar variables de canalización.
az pipelines variable create	Agregue una variable a una canalización.
az pipelines variable delete	Elimine una variable de la canalización.
az pipelines variable list	Enumere las variables de una canalización.
az pipelines variable update	Actualice una variable en una canalización.
az pipelines variable-group	Administrar grupos de variables.
az pipelines variable-group create	Cree un grupo de variables.
az pipelines variable-group delete	Elimine un grupo de variables.
az pipelines variable-group list	Enumerar grupos de variables.
az pipelines variable-group show	Mostrar los detalles del grupo de variables.
az pipelines variable-group update	Actualice un grupo de variables.
az pipelines variable-group variable	Administrar las variables de un grupo de variables.
az pipelines variable-group variable create	Agregue una variable a un grupo de variables.
az pipelines variable-group variable delete	Elimine una variable del grupo de variables.
az pipelines variable-group variable list	Enumera las variables de un grupo de variables.
az pipelines variable-group variable update	Actualice una variable en un grupo de variables.

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]
                    [--project]
                    [--queue-id]
                    [--repository]
                    [--repository-type {github, tfsgit}]
                    [--service-connection]
                    [--skip-first-run {false, true}]
                    [--yaml-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

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

Detecte automáticamente la organización.

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

valores aceptados: github, tfsgit

--service-connection

Identificador de la conexión de servicio creada para el repositorio 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.

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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az pipelines delete

Elimine una canalización.

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

Parámetros requeridos

--id

Identificador de la canalización.

Parámetros opcionales

--detect

Detecte automáticamente la organización.

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 se recoge 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 se recoge a través de la configuración de Git.

--yes -y

No solicita confirmación.

valor predeterminado: False

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az pipelines list

Enumerar canalizaciones.

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

Parámetros opcionales

--detect

Detecte automáticamente la organización.

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 se recoge 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 se recoge a través de la configuración de Git.

--query-order

Orden de los resultados.

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.

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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az pipelines run

Poner en cola (ejecutar) una canalización.

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

Parámetros opcionales

--branch

Nombre de la rama en la que se va a poner en cola la ejecución de la canalización. Ejemplo: refs/heads/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

Detecte automáticamente la organización.

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.

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 se recoge 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 se recoge 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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az pipelines show

Obtenga los detalles de una canalización.

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

Parámetros opcionales

--detect

Detecte automáticamente la organización.

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 la canalización en el explorador web.

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 se recoge 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 se recoge a través de la configuración de Git.

Parámetros globales

--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az pipelines update

Actualice una canalización.

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

Parámetros requeridos

--id

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

Parámetros opcionales

--branch

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

--description

Nueva descripción de la canalización.

--detect

Detecte automáticamente la organización.

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 se recoge 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 se recoge a través de la configuración de Git.

--queue-id

Identificador de cola del grupo de agentes donde se debe ejecutar 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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

--query

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.