파이프라인 정의

파이프라인은 CI/CD 프로세스를 설명하는 하나 이상의 단계입니다.

구현

구현	설명
파이프라인: 단계	단계가 있는 파이프라인.
파이프라인: 확장	템플릿을 확장하는 파이프라인입니다.
파이프라인: 작업	작업과 하나의 암시적 단계가 있는 파이프라인.
파이프라인: 단계	단계와 하나의 암시적 작업이 있는 파이프라인입니다.

설명

파이프라인은 CI/CD 프로세스를 설명하는 하나 이상의 단계입니다. 단계는 파이프라인의 주요 부서입니다. "이 앱 빌드", "이러한 테스트 실행" 및 "사전 프로덕션에 배포" 단계가 좋은 예입니다.

단계는 동일한 머신에 할당할 수 있는 작업(work) 단위인 작업(job)이 하나 이상으로 이루어진 것입니다. 단계와 작업을 모두 종속성 그래프에 배열할 수 있습니다. 예를 들면 "이 단계 전에 다른 단계 실행" 및 "이 작업은 다른 작업의 출력에 따라 달라집니다."가 있습니다.

작업은 일련의 단계가 선형으로 연결된 것입니다. 작업, 스크립트 또는 외부 템플릿 참조가 단계가 될 수 있습니다.

이 계층 구조는 다음과 같은 YAML 파일의 구조에 반영됩니다.

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

간단한 파이프라인에는 이러한 수준이 모두 필요하지 않습니다. 예를 들어 단일 작업 빌드에서는 단계만 있으므로 단계 및 작업에 대한 컨테이너를 생략할 수 있습니다. 또한 이 문서에 표시된 많은 옵션이 필요하지 않고 좋은 기본값을 갖기 때문에 YAML 정의에 모든 옵션이 포함될 가능성은 낮습니다.

단일 단계가 있는 경우 키워드(keyword) 생략 stages 하고 키워드(keyword) 작업을 직접 지정할 수 있습니다.

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

단일 단계와 단일 작업이 있는 경우 및 키워드를 stages 생략하고 jobs 키워드(keyword) 단계를 직접 지정할 수 있습니다.

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

사용 된 name 파이프라인 실행 번호를 구성 하는 속성입니다. 자세한 내용은 실행 또는 빌드 번호 구성을 참조하세요.

파이프라인: 단계

단계가 있는 파이프라인.

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.

속성

stages스테이지를 선택합니다. 필수 사항입니다.
단계는 사람의 개입 없이 실행할 수 있는 작업 그룹입니다.

pool풀.
달리 지정하지 않는 한 이 파이프라인의 작업이 실행되는 풀입니다.

name 문자열.
파이프라인 실행 번호입니다.

appendCommitMessageToRunNameboolean입니다.
빌드 번호에 커밋 메시지 추가합니다. 기본값은 true입니다.

trigger트리거합니다.
연속 통합 트리거.

parameters매개 변수.
파이프라인 템플릿 매개 변수.

prpr.
끌어오기 요청 트리거.

schedules일정.
예약된 트리거.

resources리소스.
빌드에 사용되는 컨테이너 및 리포지토리입니다.

variables변수.
이 파이프라인의 변수입니다.

lockBehavior 문자열.
이 단계의 동작 잠금 요청은 다른 배타적 잠금 요청과 관련하여 표시되어야 합니다. 순차 | runLatest.

예제

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"

파이프라인: 확장

템플릿을 확장하는 파이프라인입니다.

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.

속성

extends확장합니다. 필수 사항입니다.
템플릿을 확장합니다.

pool풀.
달리 지정하지 않는 한 이 파이프라인의 작업이 실행되는 풀입니다.

name 문자열.
파이프라인 실행 번호입니다.

appendCommitMessageToRunNameboolean입니다.
빌드 번호에 커밋 메시지 추가합니다. 기본값은 true입니다.

trigger트리거합니다.
연속 통합 트리거.

parameters매개 변수.
파이프라인 템플릿 매개 변수.

prpr.
끌어오기 요청 트리거.

schedules일정.
예약된 트리거.

resources리소스.
빌드에 사용되는 컨테이너 및 리포지토리입니다.

variables변수.
이 파이프라인의 변수입니다.

lockBehavior 문자열.
이 단계의 동작 잠금 요청은 다른 배타적 잠금 요청과 관련하여 표시되어야 합니다. 순차 | runLatest.

파이프라인: 작업

작업과 하나의 암시적 단계가 있는 파이프라인.

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.

속성

jobs작업. 필수 사항입니다.
작업은 단일 에이전트 또는 서버에 할당할 수 있는 작업 단위를 나타냅니다.

pool풀.
달리 지정하지 않는 한 이 파이프라인의 작업이 실행되는 풀입니다.

name 문자열.
파이프라인 실행 번호입니다.

appendCommitMessageToRunNameboolean입니다.
빌드 번호에 커밋 메시지 추가합니다. 기본값은 true입니다.

trigger트리거합니다.
연속 통합 트리거.

parameters매개 변수.
파이프라인 템플릿 매개 변수.

prpr.
끌어오기 요청 트리거.

schedules일정.
예약된 트리거.

resources리소스.
빌드에 사용되는 컨테이너 및 리포지토리입니다.

variables변수.
이 파이프라인의 변수입니다.

lockBehavior 문자열.
이 단계의 동작 잠금 요청은 다른 배타적 잠금 요청과 관련하여 표시되어야 합니다. 순차 | runLatest.

예제

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"

파이프라인: 단계

단계와 하나의 암시적 작업이 있는 파이프라인입니다.

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.

속성

steps단계. 필수 사항입니다.
이 작업에서 실행할 단계 목록입니다.

strategyjobs.job.strategy.
이 작업에 대한 실행 전략입니다.

continueOnError 문자열.
실패하더라도 계속 실행하시겠습니까?

pool풀.
달리 지정하지 않는 한 이 파이프라인의 작업이 실행되는 풀입니다.

containerjobs.job.container.
컨테이너 리소스 이름입니다.

services 문자열 사전입니다.
서비스 컨테이너로 실행할 컨테이너 리소스입니다.

workspace작업 영역.
에이전트의 작업 영역 옵션입니다.

name 문자열.
파이프라인 실행 번호입니다.

appendCommitMessageToRunNameboolean입니다.
빌드 번호에 커밋 메시지 추가합니다. 기본값은 true입니다.

trigger트리거합니다.
연속 통합 트리거.

parameters매개 변수.
파이프라인 템플릿 매개 변수.

prpr.
끌어오기 요청 트리거.

schedules일정.
예약된 트리거.

resources리소스.
빌드에 사용되는 컨테이너 및 리포지토리입니다.

variables변수.
이 파이프라인의 변수입니다.

lockBehavior 문자열.
이 단계의 동작 잠금 요청은 다른 배타적 잠금 요청과 관련하여 표시되어야 합니다. 순차 | runLatest.

예

trigger:
- main

pool: 
  vmImage: ubuntu-latest

steps:
- script: "Hello world!"

참고 항목

• 여러 작업이 있는 파이프라인
• 트리거
• 변수
• 빌드 번호 형식