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 de : fases	Canalización con fases.
canalización de : amplía	Canalización que extiende una plantilla.
canalización de : de trabajos	Canalización con trabajos y una fase implícita.
canalización de : pasos	Canalización con pasos y un trabajo implícito.

Observaciones

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 es uno o varios trabajos, que son unidades de trabajo asignables a la misma máquina. 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 un solo trabajo, puede omitir los contenedores de fases y trabajos porque solo hay pasos. Y dado que muchas 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 palabra clave stages y especificar directamente la palabra clave trabajos:

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

Si tiene una sola fase y un solo trabajo, puede omitir las palabras clave stages y jobs y especificar directamente los pasos de palabra clave:

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

Use la propiedad name para configurar el número de ejecución de la canalización. Para obtener más información, consulte Configurar números de ejecución o compilació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: sequential | runLatest # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Propiedades

stages fases. Obligatorio.
Fases son grupos de trabajos que se pueden ejecutar sin intervención humana.

pool grupo de.
Grupo donde 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.

appendCommitMessageToRunName booleano .
Anexar el mensaje de confirmación al número de compilación. El valor predeterminado es true.

trigger desencadenador.
desencadenadores de integración continua.

parameters parámetros.
parámetros de plantilla de canalización.

pr pr.
desencadenadores de solicitud de incorporación de cambios.

schedules programa.
desencadenadores programados.

resources recursos.
contenedores y repositorios usados en la compilación.

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

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: sequential | runLatest # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Propiedades

extends extiende. Obligatorio.
Extiende una plantilla.

pool grupo de.
Grupo donde 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.

appendCommitMessageToRunName booleano .
Anexar el mensaje de confirmación al número de compilación. El valor predeterminado es true.

trigger desencadenador.
desencadenadores de integración continua.

parameters parámetros.
parámetros de plantilla de canalización.

pr pr.
desencadenadores de solicitud de incorporación de cambios.

schedules programa.
desencadenadores programados.

resources recursos.
contenedores y repositorios usados en la compilación.

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

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: sequential | runLatest # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Propiedades

jobs trabajos. Obligatorio.
Trabajos representan unidades de trabajo que se pueden asignar a un único agente o servidor.

pool grupo de.
Grupo donde 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.

appendCommitMessageToRunName booleano .
Anexar el mensaje de confirmación al número de compilación. El valor predeterminado es true.

trigger desencadenador.
desencadenadores de integración continua.

parameters parámetros.
parámetros de plantilla de canalización.

pr pr.
desencadenadores de solicitud de incorporación de cambios.

schedules programa.
desencadenadores programados.

resources recursos.
contenedores y repositorios usados en la compilación.

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

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: outputs | resources | all # 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: sequential | runLatest # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

Propiedades

steps pasos. Obligatorio.
lista de pasos que se van a ejecutar en este trabajo.

strategy jobs.job.strategy.
estrategia de ejecución para este trabajo.

continueOnError cadena.
Continuar ejecutándose incluso en caso de error?

pool grupo de.
Grupo donde se ejecutarán los trabajos de esta canalización a menos que se especifique lo contrario.

container jobs.job.container.
nombre del recurso contenedor.

services diccionario de cadenas.
recursos de contenedor para ejecutarse como un 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.

appendCommitMessageToRunName booleano .
Anexar el mensaje de confirmación al número de compilación. El valor predeterminado es true.

trigger desencadenador.
desencadenadores de integración continua.

parameters parámetros.
parámetros de plantilla de canalización.

pr pr.
desencadenadores de solicitud de incorporación de cambios.

schedules programa.
desencadenadores programados.

resources recursos.
contenedores y repositorios usados en la compilación.

variables variables.
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!"

Consulte también

• Canalizaciones con varios trabajos
• desencadenadores
• variables de
• formatos de número de compilación