파이프라인 정의

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

구현

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

비고

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

단계는 하나 이상의 작업으로, 동일한 컴퓨터에 할당할 수 있는 작업 단위입니다. 단계와 작업을 모두 종속성 그래프에 배열할 수 있습니다. 예를 들면 "이 단계 전에 다른 단계 실행" 및 "이 작업은 다른 작업의 출력에 따라 달라집니다."가 있습니다.

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

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

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

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

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

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

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

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

속성

stages 단계. 필수 사항입니다.
단계는 사람의 개입 없이 실행할 수 있는 작업 그룹입니다.

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

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

부울appendCommitMessageToRunName.
빌드 번호에 커밋 메시지를 추가합니다. 기본값은 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: sequential | runLatest # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

속성

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

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

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

부울appendCommitMessageToRunName.
빌드 번호에 커밋 메시지를 추가합니다. 기본값은 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: sequential | runLatest # Behavior lock requests from this stage should exhibit in relation to other exclusive lock requests.

속성

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

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

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

부울appendCommitMessageToRunName.
빌드 번호에 커밋 메시지를 추가합니다. 기본값은 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: 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.

속성

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

jobs.job.strategystrategy.
이 작업에 대한 실행 전략입니다.

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

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

jobs.job.containercontainer.
컨테이너 리소스 이름입니다.

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

작업 영역workspace.
에이전트의 작업 영역 옵션을 .

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

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

trigger 트리거.
연속 통합 트리거를 .

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

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

일정을 schedules.
예약된 트리거를 .

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

변수variables.
이 파이프라인에 대한 변수를 .

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

예시

trigger:
- main

pool: 
  vmImage: ubuntu-latest

steps:
- script: "Hello world!"

참고하십시오

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