Compartir a través de

az pipelines build

  • Referencia

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 instalará automáticamente la primera vez que ejecute un comando az pipelines build . Obtenga más información sobre las extensiones.

Administrar compilaciones.

Comandos

Nombre Description Tipo Estado
az pipelines build cancel

Cancela si se está ejecutando la compilación.

 Extensión GA
az pipelines build definition

Administrar definiciones de compilación.

 Extensión GA
az pipelines build definition list

Enumerar definiciones de compilación.

 Extensión GA
az pipelines build definition show

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

 Extensión GA
az pipelines build list

Enumerar los resultados de la compilación.

 Extensión GA
az pipelines build queue

Solicite (cola) una compilación.

 Extensión GA
az pipelines build show

Obtenga los detalles de una compilación.

 Extensión GA
az pipelines build tag

Administrar etiquetas de compilación.

 Extensión GA
az pipelines build tag add

Agregue etiquetas para una compilación.

 Extensión GA
az pipelines build tag delete

Elimine una etiqueta de compilación.

 Extensión GA
az pipelines build tag list

Obtiene etiquetas para una compilación.

 Extensión GA

az pipelines build cancel

Cancela si se está ejecutando la compilación.

az pipelines build cancel --build-id
                          [--detect {false, true}]
                          [--open]
                          [--org]
                          [--project]

Parámetros requeridos

--build-id

Id. de la compilación.

Parámetros opcionales

--detect

Detecta automáticamente la organización.

Valores aceptados: false, true
--open

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

Valor predeterminado: False
--org --organization

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 mediante la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

Nombre o id. 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.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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 build list

Enumerar los resultados de la compilación.

az pipelines build list [--branch]
                        [--definition-ids]
                        [--detect {false, true}]
                        [--org]
                        [--project]
                        [--reason {all, batchedCI, buildCompletion, checkInShelveset, individualCI, manual, pullRequest, schedule, triggered, userCreated, validateShelveset}]
                        [--requested-for]
                        [--result {canceled, failed, none, partiallySucceeded, succeeded}]
                        [--status {all, cancelling, completed, inProgress, none, notStarted, postponed}]
                        [--tags]
                        [--top]

Parámetros opcionales

--branch

Filtre por compilaciones para esta rama.

--definition-ids

Identificadores (separados por espacios) de definiciones para las que se enumeran las compilaciones.

--detect

Detecta automáticamente la organización.

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

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 mediante la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

Nombre o id. 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.

--reason

Limite las compilaciones con este motivo.

Valores aceptados: all, batchedCI, buildCompletion, checkInShelveset, individualCI, manual, pullRequest, schedule, triggered, userCreated, validateShelveset
--requested-for

Límite de compilaciones solicitadas para este usuario o grupo.

--result

Limite las compilaciones con este resultado.

Valores aceptados: canceled, failed, none, partiallySucceeded, succeeded
--status

Limite las compilaciones con este estado.

Valores aceptados: all, cancelling, completed, inProgress, none, notStarted, postponed
--tags

Limite las compilaciones con cada una de las etiquetas especificadas. Separados por espacios.

--top

Número máximo de compilaciones 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.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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 build queue

Solicite (cola) una compilación.

az pipelines build queue [--branch]
                         [--commit-id]
                         [--definition-id]
                         [--definition-name]
                         [--detect {false, true}]
                         [--open]
                         [--org]
                         [--project]
                         [--queue-id]
                         [--variables]

Parámetros opcionales

--branch

Rama que se va a compilar. Obligatorio si no hay una rama predeterminada configurada en la definición. Ejemplo: refs/head/master o master o refs/pull/1/merge o refs/tags/tag.

--commit-id

Identificador de confirmación de la rama que se va a compilar.

--definition-id

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

--definition-name

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

--detect

Detecta automáticamente la organización.

Valores aceptados: false, true
--open

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

Valor predeterminado: False
--org --organization

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 mediante la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

Nombre o id. 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

Id. de cola del grupo que se usará para poner en cola la compilación.

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

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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 build show

Obtenga los detalles de una compilación.

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

Parámetros requeridos

--id

Id. de la compilación.

Parámetros opcionales

--detect

Detecta automáticamente la organización.

Valores aceptados: false, true
--open

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

Valor predeterminado: False
--org --organization

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 mediante la configuración de Git. Ejemplo: https://dev.azure.com/MyOrganizationName/.

--project -p

Nombre o id. 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.

Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
Valor predeterminado: json
--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.