definição de pipeline

Um pipeline é um ou mais estágios que descrevem um processo de CI/CD.

Implementações

Implementação	Descrição
pipeline: estágios	Pipeline com estágios.
pipeline: estende	Pipeline que estende um modelo.
pipeline: trabalhos	Pipeline com trabalhos e um estágio implícito.
pipeline: etapas	Pipeline com etapas e um trabalho implícito.

Comentários

Um pipeline é um ou mais estágios que descrevem um processo de CI/CD. As fases são as divisões principais em um pipeline. As fases "Criar este aplicativo", "Executar esses testes" e "Implantar em pré-produção" são bons exemplos.

Um estágio é um ou mais trabalhos, que são unidades de trabalho atribuíveis ao mesmo computador. Você pode organizar as fases e trabalhos em grafos de dependência. Os exemplos incluem "Executar este estágio antes desse" e "Esse trabalho depende da saída desse trabalho".

Um trabalho é uma série linear de etapas. As etapas podem ser tarefas, scripts ou referências a modelos externos.

Essa hierarquia é refletida na estrutura de um arquivo YAML, como:

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

Pipelines simples não exigem todos esses níveis. Por exemplo, em uma compilação de trabalho único, você pode omitir os contêineres para estágios e trabalhos porque há apenas etapas. E como muitas opções mostradas neste artigo não são necessárias e têm padrões adequados, é improvável que suas definições YAML incluam todas elas.

Se você tiver um único estágio, poderá omitir o stages palavra-chave e especificar diretamente os trabalhos palavra-chave:

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

Se você tiver uma fase única e um trabalho único, poderá omitir as palavras-chave stages e jobs, e especificar diretamente a palavra-chave steps:

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

Use a name propriedade para configurar o número de execução do pipeline. Para obter mais informações, consulte Configurar números de execução ou de build.

pipeline: estágios

Pipeline com estágios.

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.

Propriedades

stagesestágios. Obrigatórios.
Estágios são grupos de trabalhos que podem ser executados sem intervenção humana.

poolpool.
Pool em que os trabalhos neste pipeline serão executados, a menos que seja especificado de outra forma.

name String.
Número de execução do pipeline.

appendCommitMessageToRunNamebooliano.
Acrescente o mensagem do commit ao número de build. O padrão é true.

triggergatilho.
Gatilhos de integração contínua.

parametersparâmetros.
Parâmetros de modelo de pipeline.

prpr.
Gatilhos de solicitação de pull.

schedulesagendas.
Gatilhos agendados.

resourcesrecursos.
Contêineres e repositórios usados no build.

variablesvariáveis.
Variáveis para esse pipeline.

lockBehavior String.
As solicitações de bloqueio de comportamento desse estágio devem ser exibidas em relação a outras solicitações de bloqueio exclusivas. sequencial | runLatest.

Exemplos

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"

pipeline: estende

Pipeline que estende um modelo.

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.

Propriedades

extendsestende. Obrigatórios.
Estende um modelo.

poolpool.
Pool em que os trabalhos neste pipeline serão executados, a menos que especificado de outra forma.

name String.
Número de execução do pipeline.

appendCommitMessageToRunNamebooliano.
Acrescente o mensagem do commit ao número de build. O padrão é true.

triggergatilho.
Gatilhos de integração contínua.

parametersparâmetros.
Parâmetros de modelo de pipeline.

prpr.
Gatilhos de solicitação de pull.

schedulesagendas.
Gatilhos agendados.

resourcesrecursos.
Contêineres e repositórios usados no build.

variablesvariáveis.
Variáveis para este pipeline.

lockBehavior String.
As solicitações de bloqueio de comportamento desse estágio devem ser exibidas em relação a outras solicitações de bloqueio exclusivas. sequencial | runLatest.

pipeline: trabalhos

Pipeline com trabalhos e um estágio implícito.

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.

Propriedades

jobstrabalhos. Obrigatórios.
Os trabalhos representam unidades de trabalho que podem ser atribuídas a um único agente ou servidor.

poolpool.
Pool em que os trabalhos neste pipeline serão executados, a menos que especificado de outra forma.

name String.
Número de execução do pipeline.

appendCommitMessageToRunNamebooliano.
Acrescente o mensagem do commit ao número de build. O padrão é true.

triggergatilho.
Gatilhos de integração contínua.

parametersparâmetros.
Parâmetros de modelo de pipeline.

prpr.
Gatilhos de solicitação de pull.

schedulesagendas.
Gatilhos agendados.

resourcesrecursos.
Contêineres e repositórios usados no build.

variablesvariáveis.
Variáveis para este pipeline.

lockBehavior String.
As solicitações de bloqueio de comportamento desse estágio devem ser exibidas em relação a outras solicitações de bloqueio exclusivas. sequencial | runLatest.

Exemplos

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"

pipeline: etapas

Pipeline com etapas e um trabalho 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.

Propriedades

stepsetapas. Obrigatórios.
Uma lista de etapas a serem executadas neste trabalho.

strategyjobs.job.strategy.
Estratégia de execução para este trabalho.

continueOnError String.
Continuar em execução mesmo em caso de falha?

poolpool.
Pool em que os trabalhos neste pipeline serão executados, a menos que especificado de outra forma.

containerjobs.job.container.
Nome do recurso de contêiner.

services dicionário de cadeia de caracteres.
Recursos de contêiner para serem executados como um contêiner de serviço.

workspaceworkspace.
Opções de workspace no agente.

name String.
Número de execução do pipeline.

appendCommitMessageToRunNamebooliano.
Acrescente o mensagem do commit ao número de build. O padrão é true.

triggergatilho.
Gatilhos de integração contínua.

parametersparâmetros.
Parâmetros de modelo de pipeline.

prpr.
Gatilhos de solicitação de pull.

schedulesagendas.
Gatilhos agendados.

resourcesrecursos.
Contêineres e repositórios usados no build.

variablesvariáveis.
Variáveis para este pipeline.

lockBehavior String.
As solicitações de bloqueio de comportamento desse estágio devem ser exibidas em relação a outras solicitações de bloqueio exclusivas. sequencial | runLatest.

Exemplos

trigger:
- main

pool: 
  vmImage: ubuntu-latest

steps:
- script: "Hello world!"

Confira também

• Pipelines com vários trabalhos
• Gatilhos
• Variáveis
• Formatos de número de build