az pipelines
Nota:
Esta referencia forma parte de la extensión de 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. 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. |
Extensión | Disponibilidad general |
az pipelines agent list |
Obtenga una lista de agentes de un grupo. |
Extensión | Disponibilidad general |
az pipelines agent show |
Mostrar los detalles del agente. |
Extensión | Disponibilidad general |
az pipelines build |
Administrar compilaciones. |
Extensión | Disponibilidad general |
az pipelines build cancel |
Cancela si se está ejecutando la compilación. |
Extensión | Disponibilidad general |
az pipelines build definition |
Administrar definiciones de compilación. |
Extensión | Disponibilidad general |
az pipelines build definition list |
Enumerar definiciones de compilación. |
Extensión | Disponibilidad general |
az pipelines build definition show |
Obtenga los detalles de una definición de compilación. |
Extensión | Disponibilidad general |
az pipelines build list |
Enumerar los resultados de la compilación. |
Extensión | Disponibilidad general |
az pipelines build queue |
Solicite (cola) una compilación. |
Extensión | Disponibilidad general |
az pipelines build show |
Obtenga los detalles de una compilación. |
Extensión | Disponibilidad general |
az pipelines build tag |
Administrar etiquetas de compilación. |
Extensión | Disponibilidad general |
az pipelines build tag add |
Agregue etiquetas para una compilación. |
Extensión | Disponibilidad general |
az pipelines build tag delete |
Elimine una etiqueta de compilación. |
Extensión | Disponibilidad general |
az pipelines build tag list |
Obtiene etiquetas para una compilación. |
Extensión | Disponibilidad general |
az pipelines create |
Cree una nueva canalización de Azure (basada en YAML). |
Extensión | Disponibilidad general |
az pipelines delete |
Elimine una canalización. |
Extensión | Disponibilidad general |
az pipelines folder |
Administrar carpetas para organizar canalizaciones. |
Extensión | Disponibilidad general |
az pipelines folder create |
Cree una carpeta. |
Extensión | Disponibilidad general |
az pipelines folder delete |
Elimine una carpeta. |
Extensión | Disponibilidad general |
az pipelines folder list |
Enumera todas las carpetas. |
Extensión | Disponibilidad general |
az pipelines folder update |
Actualice un nombre de carpeta o una descripción. |
Extensión | Disponibilidad general |
az pipelines list |
Enumerar canalizaciones. |
Extensión | Disponibilidad general |
az pipelines pool |
Administrar grupos de agentes. |
Extensión | Disponibilidad general |
az pipelines pool list |
Enumera los grupos de agentes. |
Extensión | Disponibilidad general |
az pipelines pool show |
Mostrar los detalles del grupo de agentes. |
Extensión | Disponibilidad general |
az pipelines queue |
Administrar colas de agentes. |
Extensión | Disponibilidad general |
az pipelines queue list |
Enumerar las colas del agente. |
Extensión | Disponibilidad general |
az pipelines queue show |
Mostrar detalles de la cola del agente. |
Extensión | Disponibilidad general |
az pipelines release |
Administrar versiones. |
Extensión | Disponibilidad general |
az pipelines release create |
Solicite (cree) una versión. |
Extensión | Disponibilidad general |
az pipelines release definition |
Administrar definiciones de versión. |
Extensión | Disponibilidad general |
az pipelines release definition list |
Enumera las definiciones de versión. |
Extensión | Disponibilidad general |
az pipelines release definition show |
Obtenga los detalles de una definición de versión. |
Extensión | Disponibilidad general |
az pipelines release list |
Enumerar los resultados de la versión. |
Extensión | Disponibilidad general |
az pipelines release show |
Obtenga los detalles de una versión. |
Extensión | Disponibilidad general |
az pipelines run |
Cola (ejecución) de una canalización. |
Extensión | Disponibilidad general |
az pipelines runs |
Administrar ejecuciones de canalización. |
Extensión | Disponibilidad general |
az pipelines runs artifact |
Administrar artefactos de ejecución de canalización. |
Extensión | Disponibilidad general |
az pipelines runs artifact download |
Descargue un artefacto de canalización. |
Extensión | Disponibilidad general |
az pipelines runs artifact list |
Enumerar artefactos asociados a una ejecución. |
Extensión | Disponibilidad general |
az pipelines runs artifact upload |
Cargue un artefacto de canalización. |
Extensión | Disponibilidad general |
az pipelines runs list |
Enumerar las ejecuciones de canalización en un proyecto. |
Extensión | Disponibilidad general |
az pipelines runs show |
Mostrar detalles de una ejecución de canalización. |
Extensión | Disponibilidad general |
az pipelines runs tag |
Administrar etiquetas de ejecución de canalización. |
Extensión | Disponibilidad general |
az pipelines runs tag add |
Agregue etiquetas para una ejecución de canalización. |
Extensión | Disponibilidad general |
az pipelines runs tag delete |
Elimine una etiqueta de ejecución de canalización. |
Extensión | Disponibilidad general |
az pipelines runs tag list |
Obtiene etiquetas para una ejecución de canalización. |
Extensión | Disponibilidad general |
az pipelines show |
Obtenga los detalles de una canalización. |
Extensión | Disponibilidad general |
az pipelines update |
Actualizar una canalización. |
Extensión | Disponibilidad general |
az pipelines variable |
Administrar variables de canalización. |
Extensión | Disponibilidad general |
az pipelines variable-group |
Administrar grupos de variables. |
Extensión | Disponibilidad general |
az pipelines variable-group create |
Cree un grupo de variables. |
Extensión | Disponibilidad general |
az pipelines variable-group delete |
Elimine un grupo de variables. |
Extensión | Disponibilidad general |
az pipelines variable-group list |
Enumerar grupos de variables. |
Extensión | Disponibilidad general |
az pipelines variable-group show |
Mostrar los detalles del grupo de variables. |
Extensión | Disponibilidad general |
az pipelines variable-group update |
Actualice un grupo de variables. |
Extensión | Disponibilidad general |
az pipelines variable-group variable |
Administrar variables en un grupo de variables. |
Extensión | Disponibilidad general |
az pipelines variable-group variable create |
Agregue una variable a un grupo de variables. |
Extensión | Disponibilidad general |
az pipelines variable-group variable delete |
Elimine una variable del grupo de variables. |
Extensión | Disponibilidad general |
az pipelines variable-group variable list |
Enumere las variables de un grupo de variables. |
Extensión | Disponibilidad general |
az pipelines variable-group variable update |
Actualice una variable en un grupo de variables. |
Extensión | Disponibilidad general |
az pipelines variable create |
Agregue una variable a una canalización. |
Extensión | Disponibilidad general |
az pipelines variable delete |
Elimine una variable de la canalización. |
Extensión | Disponibilidad general |
az pipelines variable list |
Enumere las variables de una canalización. |
Extensión | Disponibilidad general |
az pipelines variable update |
Actualice una variable en una canalización. |
Extensión | Disponibilidad general |
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
Nombre de la nueva canalización.
Parámetros opcionales
Nombre de rama para el que se configurará la canalización. Si se omite, se detectará automáticamente desde el repositorio local.
Descripción de la nueva canalización.
Detectar automáticamente la organización.
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".
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/
.
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.
Identificador de la cola en los grupos de agentes disponibles. Se detectará automáticamente si no se especifica.
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.
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.
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.
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.
Ruta de acceso del archivo yaml de canalizaciones en el repositorio (si yaml ya está presente en el repositorio).
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
az pipelines delete
Elimine una canalización.
az pipelines delete --id
[--detect {false, true}]
[--org --organization]
[--project]
[--yes]
Parámetros requeridos
Identificador de la canalización.
Parámetros opcionales
Detectar automáticamente la organización.
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/
.
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.
No solicita confirmación.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
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
Detectar automáticamente la organización.
Si se especifica, filtra por definiciones en esta carpeta.
Limite los resultados a las canalizaciones con este nombre o empezando por este nombre. Ejemplos: "FabCI" o "Fab*".
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/
.
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.
Orden de los resultados.
Limite los resultados a las canalizaciones asociadas a este repositorio.
Limite los resultados a las canalizaciones asociadas a este tipo de repositorio. Es obligatorio pasar el argumento "repository" junto con este argumento.
Número máximo de canalizaciones que se van a enumerar.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
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
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 en el que se va a poner en cola la ejecución de la canalización.
Detectar automáticamente la organización.
Ruta de acceso de carpeta de la canalización. El valor predeterminado es la carpeta de nivel raíz.
Identificador de la canalización que se va a poner en cola. Obligatorio si no se proporciona --name.
Nombre de la canalización que se va a poner en cola. Se omite si se proporciona --id.
Abra la página de resultados de la canalización en el explorador web.
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/
.
Pares "name=value" separados por espacios para los parámetros que desea establecer.
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.
Pares "name=value" separados por espacios para las variables que desea establecer.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Usa --debug para ver 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 --organization]
[--project]
Parámetros opcionales
Detectar automáticamente la organización.
Ruta de acceso de carpeta de la canalización. El valor predeterminado es la carpeta de nivel raíz.
Identificador de la canalización.
Nombre de la canalización. Se omite si se proporciona --id.
Abra la página de resumen de canalización en el explorador web.
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/
.
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
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.
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
Identificador de la canalización que se va a actualizar.
Parámetros opcionales
Nombre de rama para el que se configurará la canalización.
Nueva descripción de la canalización.
Detectar automáticamente la organización.
Nueva ruta de acceso completa de la carpeta a la que se va a mover la canalización. Por ejemplo, "user1/production_pipelines".
Nuevo nombre actualizado de la canalización.
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/
.
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.
Id. de cola del grupo de agentes donde debe ejecutarse la canalización.
Ruta de acceso del archivo yaml de canalizaciones en el repositorio.
Parámetros globales
Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.
Mostrar este mensaje de ayuda y salir.
Solo se muestran errores, suprimiendo advertencias.
Formato de salida.
Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.
Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID
.
Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.