Referencia de esquema DE YAML para Azure Pipelines
La referencia de esquema YAML para Azure Pipelines es una referencia detallada para las canalizaciones YAML que enumera toda la sintaxis YAML admitida y sus opciones disponibles.
Para crear una canalización YAML, comience con la definición de de canalización de. Para obtener más información sobre cómo compilar canalizaciones YAML, consulte Personalización de la canalización.
La referencia de esquema YAML no cubre las tareas. Para más información sobre las tareas, consulte el índice de tareas de Azure Pipelines.
Definiciones
de canalización
Una canalización es una o varias fases que describen un proceso de CI/CD. La definición de canalización contiene la documentación de las propiedades de nivel raíz, como name.
extiende
Extiende una canalización mediante una plantilla.
trabajos
Especifica los trabajos que componen el trabajo de una fase.
jobs.deployment
Un trabajo de implementación es un tipo especial de trabajo. Se trata de una colección de pasos para ejecutarse secuencialmente en el entorno.
jobs.deployment.environment
nombre del entorno de destino y, opcionalmente, un nombre de recurso para registrar el historial de implementación; format: environment-name.resource-name.
jobs.deployment.strategy
estrategia de ejecución para esta implementación.
jobs.deployment.strategy.canary
estrategia de implementación controlada.
jobs.deployment.strategy.rolling
estrategia de implementación gradual.
jobs.deployment.strategy.runOnce
estrategia de implementación de RunOnce.
jobs.job
Un trabajo es una colección de pasos ejecutados por un agente o en un servidor.
jobs.job.container
nombre del recurso contenedor.
jobs.job.strategy
estrategia de ejecución para este trabajo.
jobs.job.uses
Los recursos requeridos por este trabajo que aún no se han hecho referencia.
jobs.template de
un conjunto de trabajos definidos en una plantilla.
parámetros
Especifica los parámetros en tiempo de ejecución pasados a una canalización.
parameters.parameter
parámetros de plantilla de canalización.
de grupo de
El grupo que se va a usar para un trabajo de la canalización.
pool.demand
demandas (para un grupo privado).
pr
desencadenador de solicitud de incorporación de cambios.
recursos
Resources especifica compilaciones, repositorios, canalizaciones y otros recursos usados por la canalización.
resources.builds
Lista de recursos de compilación a los que hace referencia la canalización.
resources.builds.build
un recurso de compilación usado para hacer referencia a artefactos desde una ejecución.
resources.containers
Lista de imágenes de contenedor.
resources.containers.container
un recurso de contenedor usado para hacer referencia a una imagen de contenedor.
resources.containers.container.trigger
Especifique ninguno para deshabilitar, true para desencadenar en todas las etiquetas de imagen o use la sintaxis completa, tal como se describe en los ejemplos siguientes.
resources.packages
Lista de recursos de paquete.
resources.packages.package
un recurso de paquete usado para hacer referencia a un paquete de GitHub de NuGet o npm.
resources.pipelines
Lista de recursos de canalización.
resources.pipelines.pipeline
un recurso de canalización.
resources.pipelines.pipeline.trigger
Especifique ninguno para deshabilitar, true para incluir todas las ramas o use la sintaxis completa como se describe en los ejemplos siguientes.
resources.pipelines.pipeline.trigger.branches
ramas que se van a incluir o excluir para desencadenar una ejecución.
resources.repositories
Lista de recursos del repositorio.
resources.repository.repository
se usa un recurso de repositorio para hacer referencia a un repositorio adicional en la canalización.
resources.webhooks
Lista de webhooks.
resources.webhooks.webhook
un recurso de webhook permite integrar la canalización con un servicio externo para automatizar el flujo de trabajo.
resources.webhooks.webhook.filters
Lista de filtros de desencadenador.
resources.webhooks.webhook.filters.filter
filtro de desencadenador de recursos de Webhook.
programaciones
La lista de programaciones especifica los desencadenadores programados para la canalización.
schedules.cron
Un desencadenador programado especifica una programación en la que se compilan las ramas.
fases
Fases son una colección de trabajos relacionados.
stages.stage
una fase es una colección de trabajos relacionados.
stages.template
Puede definir un conjunto de fases en un archivo y usarlo varias veces en otros archivos.
pasos
Pasos son una secuencia lineal de operaciones que componen un trabajo.
steps.bash
ejecuta un script en Bash en Windows, macOS y Linux.
steps.checkout
Configuración de cómo la canalización desvía el código fuente.
steps.download
Descarga artefactos asociados a la ejecución actual o desde otra canalización de Azure Pipeline asociada como un recurso de canalización.
steps.downloadBuild
descarga artefactos de compilación.
steps.getPackage
Descarga un paquete de una fuente de administración de paquetes en Azure Artifacts o Azure DevOps Server.
steps.powershell
Ejecuta un script con Windows PowerShell (en Windows) o pwsh (Linux y macOS).
steps.publish
Publica (carga) un archivo o carpeta como un artefacto de canalización que pueden consumir otros trabajos y canalizaciones.
steps.pwsh
ejecuta un script en PowerShell Core en Windows, macOS y Linux.
steps.reviewApp
Descargas crea un recurso dinámicamente en un proveedor de fase de implementación.
steps.script
Ejecuta un script mediante cmd.exe en Windows y Bash en otras plataformas.
steps.task
Ejecuta una tarea.
steps.template
Definir un conjunto de pasos en un archivo y usarlo varias veces en otro archivo.
de destino
Tareas se ejecutan en un contexto de ejecución, que es el host del agente o un contenedor.
de desencadenador de
desencadenador de integración continua (inserción).
variables
Definir variables mediante pares nombre-valor.
variables.group
Variables de referencia de un grupo de variables.
variables.name
Definir variables mediante el nombre y la sintaxis completa.
variables.template
Definir variables en una plantilla.
Definiciones auxiliares
Nota:
Las definiciones auxiliares no están diseñadas para su uso directamente en una canalización. Las definiciones auxiliares solo se usan como parte de otras definiciones y se incluyen aquí como referencia.
includeExcludeFilters
Listas de elementos que se van a incluir o excluir.
includeExcludeStringFilters
Elementos que se van a incluir o excluir.
mountReadOnly
Volúmenes para montar solo lectura, el valor predeterminado es false.
onFailureHook
Se usa para ejecutar pasos para las acciones de reversión o la limpieza.
onSuccessHook
Se usa para ejecutar pasos para las acciones de reversión o la limpieza.
onSuccessOrFailureHook
Se usa para ejecutar pasos para las acciones de reversión o la limpieza.
postRouteTrafficHook
Se usa para ejecutar los pasos después de enrutar el tráfico. Normalmente, estas tareas supervisan el estado de la versión actualizada para el intervalo definido.
preDeployHook
Se usa para ejecutar los pasos que inicializan los recursos antes de que se inicie la implementación de la aplicación.
del área de trabajo de
opciones del área de trabajo en el agente.
Convenciones de documentación del esquema YAML
La referencia de esquema YAML es una guía de referencia detallada de las canalizaciones YAML de Azure Pipelines. Incluye un catálogo de todas las funcionalidades de YAML admitidas y las opciones disponibles.
Estas son las convenciones de sintaxis que se usan en la referencia de esquema YAML.
- A la izquierda de
:es una palabra clave literal que se usa en las definiciones de canalización. - A la derecha de
:hay un tipo de dato. El tipo de datos puede ser un tipo primitivo como cadena o una referencia a una estructura enriquecida definida en otra parte de esta referencia. - La notación
[tipo de datos]indica una matriz del tipo de definición mencionado. Por ejemplo,[ string ]es una matriz de cadenas. - La notación
{tipo de datos:tipo de datos}indica una asignación de un tipo de datos a otro. Por ejemplo,{ string: string }es una asignación de cadenas a cadenas. - El símbolo
|indica que hay varios tipos de datos disponibles para la palabra clave . Por ejemplo,job | templatesignifica que se permite una definición de trabajo o una referencia de plantilla.
Consulte también
Esta referencia abarca el esquema de un archivo YAML de Azure Pipelines.
Para obtener información sobre los conceptos básicos de YAML, consulte Learn YAML in Y Minutes.
Azure Pipelines no admite todas las características de YAML.
Entre las características no admitidas se incluyen anclajes, claves complejas y conjuntos.
Además, a diferencia de YAML estándar, Azure Pipelines depende de ver stage, job, tasko un acceso directo de tareas como script como la primera clave de una asignación.