definición de canalización

Una canalización es una o varias fases que describen un proceso de CI/CD.

Implementaciones

Implementación	Descripción
canalización: fases	Canalización con fases.
canalización: extiende	Canalización que extiende una plantilla.
canalización: trabajos	Canalización con trabajos y una fase implícita.
canalización: pasos	Canalización con pasos y un trabajo implícito.

Comentarios

Una canalización es una o varias fases que describen un proceso de CI/CD. Las fases son las divisiones principales de una canalización. Las fases "Compilar esta aplicación", "Ejecutar estas pruebas" e "Implementar en preproducción" son buenos ejemplos.

Una fase cuenta con uno o varios trabajos, que son unidades de trabajo asignables al mismo equipo. Tanto las fases como los trabajos se pueden organizar en gráficos de dependencias. Entre los ejemplos se incluyen "Ejecutar esta fase antes de esa" y "Este trabajo depende de la salida de ese trabajo".

Un trabajo es una serie lineal de pasos. Los pasos pueden ser tareas, scripts o referencias a plantillas externas.

Esta jerarquía se refleja en la estructura de un archivo YAML como:

- Pipeline
  - Stage A
    - Job 1
      - Step 1.1
      - Step 1.2
      - ...
    - Job 2
      - Step 2.1
      - Step 2.2
      - ...
  - Stage B
    - ...

Las canalizaciones simples no requieren todos estos niveles. Por ejemplo, en una compilación de trabajo único, puede omitir los contenedores de las fases y los trabajos porque solo hay pasos. Dado que muchas de las opciones que se muestran en este artículo no son necesarias y tienen buenos valores predeterminados, es poco probable que las definiciones de YAML incluyan todas ellas.

Si tiene una sola fase, puede omitir la stages palabra clave y especificar directamente la palabra clave jobs :

# ... other pipeline-level keywords
jobs: [ job | template ]

Si tiene una sola fase y un único trabajo, puede omitir las palabras clave stages y jobs, y especificar directamente la palabra clave steps:

# ... other pipeline-level keywords
steps: [ script | bash | pwsh | powershell | checkout | task | template | ... ]

Use la name propiedad para configurar el número de ejecución de canalización. Para obtener más información, consulte Configuración de números de compilación o ejecución.

canalización: fases

Canalización con fases.

stages: [ stage | template ] # Required. Stages are groups of jobs that can run without human intervention.
pool: string | pool # Pool where jobs in this pipeline will run unless otherwise specified.
name: string # Pipeline run number.
appendCommitMessageToRunName: boolean # Append the commit message to the build number. The default is true.
trigger: none | trigger | [ string ] # Continuous integration triggers.
parameters: [ parameter ] # Pipeline template parameters.
pr: none | pr | [ string ] # Pull request triggers.
schedules: [ cron ] # Scheduled triggers.
resources: # Containers and repositories used in the build.
  builds: [ build ] # List of build resources referenced by the pipeline.
  containers: [ container ] # List of container images.
  pipelines: [ pipeline ] # List of pipeline resources.
  repositories: [ repository ] # List of repository resources.
  webhooks: [ webhook ] # List of webhooks.
  packages: [ package ] # List of package resources.
variables: variables | [ variable ] # Variables for this pipeline.
lockBehavior: string # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Propiedades

stagesfases. Necesario.
Las fases son grupos de trabajos que se pueden ejecutar sin intervención humana.

poolpool.
Grupo en el que se ejecutarán los trabajos de esta canalización a menos que se especifique lo contrario.

name Cadena.
Número de ejecución de canalización.

appendCommitMessageToRunNamebooleano.
Anexe el mensaje de confirmación al número de compilación. El valor predeterminado es true.

triggerdesencadenador.
Desencadenadores de integración continua.

parametersparámetros.
Parámetros de plantilla de canalización.

prpr.
Desencadenadores de solicitud de incorporación de cambios.

schedulesprogramaciones.
Desencadenadores programados.

resourcesrecursos.
Contenedores y repositorios usados en la compilación.

variablesvariables.
Variables para esta canalización.

lockBehavior Cadena.
Las solicitudes de bloqueo de comportamiento de esta fase deben presentarse en relación con otras solicitudes de bloqueo exclusivas. secuencial | runLatest.

Ejemplos

trigger:
- main

pool: 
  vmImage: ubuntu-latest

stages:
- stage: CI
  jobs:
  - job: CIWork
    steps:
    - script: "Do CI work"

- stage: Test
  jobs:
  - job: TestWork
    steps:
    - script: "Do test work"

canalización: extiende

Canalización que extiende una plantilla.

extends: # Required. Extends a template.
  template: string # The template referenced by the pipeline to extend.
  parameters: # Parameters used in the extend.
pool: string | pool # Pool where jobs in this pipeline will run unless otherwise specified.
name: string # Pipeline run number.
appendCommitMessageToRunName: boolean # Append the commit message to the build number. The default is true.
trigger: none | trigger | [ string ] # Continuous integration triggers.
parameters: [ parameter ] # Pipeline template parameters.
pr: none | pr | [ string ] # Pull request triggers.
schedules: [ cron ] # Scheduled triggers.
resources: # Containers and repositories used in the build.
  builds: [ build ] # List of build resources referenced by the pipeline.
  containers: [ container ] # List of container images.
  pipelines: [ pipeline ] # List of pipeline resources.
  repositories: [ repository ] # List of repository resources.
  webhooks: [ webhook ] # List of webhooks.
  packages: [ package ] # List of package resources.
variables: variables | [ variable ] # Variables for this pipeline.
lockBehavior: string # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Propiedades

extendsextiende. Necesario.
Extiende una plantilla.

poolpool.
Grupo en el que se ejecutarán los trabajos de esta canalización a menos que se especifique lo contrario.

name Cadena.
Número de ejecución de canalización.

appendCommitMessageToRunNamebooleano.
Anexe el mensaje de confirmación al número de compilación. El valor predeterminado es true.

triggerdesencadenador.
Desencadenadores de integración continua.

parametersparámetros.
Parámetros de plantilla de canalización.

prpr.
Desencadenadores de solicitud de incorporación de cambios.

schedulesprogramaciones.
Desencadenadores programados.

resourcesrecursos.
Contenedores y repositorios usados en la compilación.

variablesvariables.
Variables para esta canalización.

lockBehavior Cadena.
Las solicitudes de bloqueo de comportamiento de esta fase deben presentarse en relación con otras solicitudes de bloqueo exclusivas. secuencial | runLatest.

canalización: trabajos

Canalización con trabajos y una fase implícita.

jobs: [ job | deployment | template ] # Required. Jobs represent units of work which can be assigned to a single agent or server.
pool: string | pool # Pool where jobs in this pipeline will run unless otherwise specified.
name: string # Pipeline run number.
appendCommitMessageToRunName: boolean # Append the commit message to the build number. The default is true.
trigger: none | trigger | [ string ] # Continuous integration triggers.
parameters: [ parameter ] # Pipeline template parameters.
pr: none | pr | [ string ] # Pull request triggers.
schedules: [ cron ] # Scheduled triggers.
resources: # Containers and repositories used in the build.
  builds: [ build ] # List of build resources referenced by the pipeline.
  containers: [ container ] # List of container images.
  pipelines: [ pipeline ] # List of pipeline resources.
  repositories: [ repository ] # List of repository resources.
  webhooks: [ webhook ] # List of webhooks.
  packages: [ package ] # List of package resources.
variables: variables | [ variable ] # Variables for this pipeline.
lockBehavior: string # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Propiedades

jobstrabajos. Necesario.
Los trabajos representan unidades de trabajo que se pueden asignar a un único agente o servidor.

poolpool.
Grupo en el que se ejecutarán los trabajos de esta canalización a menos que se especifique lo contrario.

name Cadena.
Número de ejecución de canalización.

appendCommitMessageToRunNamebooleano.
Anexe el mensaje de confirmación al número de compilación. El valor predeterminado es true.

triggerdesencadenador.
Desencadenadores de integración continua.

parametersparámetros.
Parámetros de plantilla de canalización.

prpr.
Desencadenadores de solicitud de incorporación de cambios.

schedulesprogramaciones.
Desencadenadores programados.

resourcesrecursos.
Contenedores y repositorios usados en la compilación.

variablesvariables.
Variables para esta canalización.

lockBehavior Cadena.
Las solicitudes de bloqueo de comportamiento de esta fase deben presentarse en relación con otras solicitudes de bloqueo exclusivas. secuencial | runLatest.

Ejemplos

trigger:
- main

pool: 
  vmImage: ubuntu-latest

jobs:
- job: PreWork
  steps:
  - script: "Do pre-work"

- job: PostWork
  pool: windows-latest
  steps:
  - script: "Do post-work using a different hosted image"

canalización: pasos

Canalización con pasos y un trabajo implícito.

steps: [ task | script | powershell | pwsh | bash | checkout | download | downloadBuild | getPackage | publish | template | reviewApp ] # Required. A list of steps to run in this job.
strategy: strategy # Execution strategy for this job.
continueOnError: string # Continue running even on failure?
pool: string | pool # Pool where jobs in this pipeline will run unless otherwise specified.
container: string | container # Container resource name.
services: # Container resources to run as a service container.
  string: string # Name/value pairs
workspace: # Workspace options on the agent.
  clean: string # Which parts of the workspace should be scorched before fetching.
name: string # Pipeline run number.
appendCommitMessageToRunName: boolean # Append the commit message to the build number. The default is true.
trigger: none | trigger | [ string ] # Continuous integration triggers.
parameters: [ parameter ] # Pipeline template parameters.
pr: none | pr | [ string ] # Pull request triggers.
schedules: [ cron ] # Scheduled triggers.
resources: # Containers and repositories used in the build.
  builds: [ build ] # List of build resources referenced by the pipeline.
  containers: [ container ] # List of container images.
  pipelines: [ pipeline ] # List of pipeline resources.
  repositories: [ repository ] # List of repository resources.
  webhooks: [ webhook ] # List of webhooks.
  packages: [ package ] # List of package resources.
variables: variables | [ variable ] # Variables for this pipeline.
lockBehavior: string # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Propiedades

stepspasos. Necesario.
Lista de pasos para ejecutar en este trabajo.

strategyjobs.job.strategy.
Estrategia de ejecución para este trabajo.

continueOnError Cadena.
¿Sigue ejecutándose incluso en caso de error?

poolpool.
El grupo en el que se ejecutarán los trabajos de esta canalización, a menos que se especifique lo contrario.

containerjobs.job.container.
Nombre del recurso de contenedor.

services diccionario de cadenas.
Recursos de contenedor para ejecutarse como contenedor de servicios.

workspaceárea de trabajo.
Opciones del área de trabajo en el agente.

name Cadena.
Número de ejecución de canalización.

appendCommitMessageToRunNamebooleano.
Anexe el mensaje de confirmación al número de compilación. El valor predeterminado es true.

triggerdesencadenador.
Desencadenadores de integración continua.

parametersparámetros.
Parámetros de plantilla de canalización.

prpr.
Desencadenadores de solicitud de incorporación de cambios.

schedulesprogramaciones.
Desencadenadores programados.

resourcesrecursos.
Contenedores y repositorios usados en la compilación.

variablesvariables.
Variables para esta canalización.

lockBehavior Cadena.
Las solicitudes de bloqueo de comportamiento de esta fase deben mostrarse en relación con otras solicitudes de bloqueo exclusivas. secuencial | runLatest.

Ejemplos

trigger:
- main

pool: 
  vmImage: ubuntu-latest

steps:
- script: "Hello world!"

Vea también

• Canalizaciones con varios trabajos
• Desencadenadores
• Variables
• Formatos de número de compilación