Azure Pipelines에 대한 YAML 스키마 참조

Azure Pipelines에 대한 YAML 스키마 참조는 지원되는 모든 YAML 구문과 사용 가능한 옵션을 나열하는 YAML 파이프라인에 대한 자세한 참조입니다.

YAML 파이프라인을 만들려면 파이프라인 정의로 시작합니다. YAML 파이프라인 빌드에 대한 자세한 내용은 파이프라인 사용자 지정참조하세요.

YAML 스키마 참조는 작업을 다루지 않습니다. 작업에 대한 자세한 내용은 Azure Pipelines 작업 인덱스참조하세요.

정의

파이프라인
파이프라인은 CI/CD 프로세스를 설명하는 하나 이상의 단계입니다. 파이프라인 정의에는 name같은 루트 수준 속성에 대한 설명서가 포함되어 있습니다.

확장
템플릿을 사용하여 파이프라인을 확장합니다.

작업
스테이지의 작업을 구성하는 작업을 지정합니다.

jobs.deployment
배포 작업은 특별한 유형의 작업입니다. 환경에 대해 순차적으로 실행하는 단계의 컬렉션입니다.

jobs.deployment.environment
대상 환경 이름 및 필요에 따라 배포 기록을 기록할 리소스 이름을 . format: environment-name.resource-name.

jobs.deployment.strategy
이 배포에 대한 실행 전략입니다.

jobs.deployment.strategy.canary
카나리아 배포 전략을 .

jobs.deployment.strategy.rolling
롤링 배포 전략을 .

jobs.deployment.strategy.runOnce
RunOnce 배포 전략을 .

jobs.job
작업은 에이전트 또는 서버에서 실행하는 단계의 컬렉션입니다.

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

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

jobs.job.uses
아직 참조되지 않은 이 작업에 필요한 모든 리소스입니다.

jobs.template
템플릿에 정의된 작업 집합입니다.

매개 변수
파이프라인에 전달된 런타임 매개 변수를 지정합니다.

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

풀
파이프라인 작업에 사용할 풀입니다.

pool.demands
요구 사항(프라이빗 풀의 경우).

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

리소스
리소스는 파이프라인에서 사용하는 빌드, 리포지토리, 파이프라인 및 기타 리소스를 지정합니다.

resources.builds
파이프라인에서 참조하는 빌드 리소스 목록입니다.

resources.builds.build
실행에서 아티팩트를 참조하는 데 사용되는 빌드 리소스입니다.

resources.containers
컨테이너 이미지 목록입니다.

resources.containers.container
컨테이너 이미지를 참조하는 데 사용되는 컨테이너 리소스입니다.

resources.containers.container.trigger
사용하지 않도록 설정하거나, 모든 이미지 태그에서 트리거하려면 true를 지정하거나, 다음 예제에 설명된 대로 전체 구문을 사용합니다.

resources.packages
패키지 리소스 목록입니다.

resources.packages.package
NuGet 또는 npm GitHub 패키지를 참조하는 데 사용되는 패키지 리소스입니다.

resources.pipelines
파이프라인 리소스 목록입니다.

resources.pipelines.pipeline
파이프라인 리소스입니다.

resources.pipelines.pipeline.trigger
사용하지 않도록 설정하거나, 모든 분기를 포함하려면 true를 지정하거나, 다음 예제에 설명된 대로 전체 구문을 사용합니다.

resources.pipelines.pipeline.trigger.branches
실행을 트리거하기 위해 포함하거나 제외할 분기를 .

resources.repositories
리포지토리 리소스 목록입니다.

resources.repositories.repository
리포지토리 리소스는 파이프라인의 추가 리포지토리를 참조하는 데 사용됩니다.

resources.webhook
웹후크 목록입니다.

resources.webhooks.webhook
웹후크 리소스를 사용하면 파이프라인을 외부 서비스와 통합하여 워크플로를 자동화할 수 있습니다.

resources.webhooks.webhook.filters
트리거 필터 목록입니다.

resources.webhooks.webhook.filters.filter
웹후크 리소스 트리거 필터입니다.

일정
일정 목록은 파이프라인에 대한 예약된 트리거를 지정합니다.

schedules.cron
예약된 트리거는 분기가 빌드되는 일정을 지정합니다.

단계
스테이지는 관련 작업의 컬렉션입니다.

stage.stage
스테이지는 관련 작업의 컬렉션입니다.

stages.template
한 파일에서 스테이지 집합을 정의하고 다른 파일에서 여러 번 사용할 수 있습니다.

단계
단계는 작업을 구성하는 연산의 선형 시퀀스입니다.

steps.bash
Windows, macOS 및 Linux의 Bash에서 스크립트를 실행합니다.

steps.checkout
파이프라인이 소스 코드를 체크 아웃하는 방법을 구성합니다.

steps.download
현재 실행과 연결된 아티팩트 또는 파이프라인 리소스로 연결된 다른 Azure Pipeline에서 아티팩트를 다운로드합니다.

steps.downloadBuild
빌드 아티팩트가 다운로드됩니다.

steps.getPackage
Azure Artifacts 또는 Azure DevOps Server의 패키지 관리 피드에서 패키지를 다운로드합니다.

steps.powershell
Windows PowerShell(Windows) 또는 pwsh(Linux 및 macOS)를 사용하여 스크립트를 실행합니다.

steps.publish
파일 또는 폴더를 다른 작업 및 파이프라인에서 사용할 수 있는 파이프라인 아티팩트로 게시(업로드)합니다.

steps.pwsh
Windows, macOS 및 Linux의 PowerShell Core에서 스크립트를 실행합니다.

steps.reviewApp
다운로드는 배포 단계 공급자 아래에 동적으로 리소스를 만듭니다.

steps.script
다른 플랫폼의 Windows 및 Bash에서 cmd.exe 사용하여 스크립트를 실행합니다.

steps.task
작업을 실행합니다.

steps.template
한 파일에서 단계 집합을 정의하고 다른 파일에서 여러 번 사용합니다.

대상
작업은 에이전트 호스트 또는 컨테이너인 실행 컨텍스트에서 실행됩니다.

target.settableVariables
설정할 수 있는 변수에 대한 제한 사항입니다.

트리거
연속 통합(푸시) 트리거입니다.

변수
이름/값 쌍을 사용하여 변수를 정의합니다.

variables.group
변수 그룹의 참조 변수입니다.

variables.name
이름 및 전체 구문을 사용하여 변수를 정의합니다.

variables.template
템플릿에서 변수를 정의합니다.

지원 정의

비고

지원 정의는 파이프라인에서 직접 사용하기 위한 것이 아닙니다. 지원 정의는 다른 정의의 일부로만 사용되며 참조를 위해 여기에 포함됩니다.

deployHook
애플리케이션을 배포하는 단계를 실행하는 데 사용됩니다.

포함ExcludeFilters
포함하거나 제외할 항목 목록입니다.

포함ExcludeStringFilters
포함하거나 제외할 항목을 .

mountReadOnly
읽기 전용을 탑재할 볼륨을 기본값은 모두 false입니다.

onFailureHook
롤백 작업 또는 정리 단계를 실행하는 데 사용됩니다.

onSuccessHook
롤백 작업 또는 정리 단계를 실행하는 데 사용됩니다.

onSuccessOrFailureHook
롤백 작업 또는 정리 단계를 실행하는 데 사용됩니다.

postRouteTrafficHook
트래픽이 라우팅된 후 단계를 실행하는 데 사용됩니다. 일반적으로 이러한 작업은 정의된 간격에 대해 업데이트된 버전의 상태를 모니터링합니다.

preDeployHook
애플리케이션 배포가 시작되기 전에 리소스를 초기화하는 단계를 실행하는 데 사용됩니다.

routeTrafficHook
업데이트된 버전에 트래픽을 제공하는 단계를 실행하는 데 사용됩니다.

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

YAML 스키마 설명서 규칙

YAML 스키마 참조는 Azure Pipelines YAML 파이프라인에 대한 자세한 참조 가이드입니다. 여기에는 지원되는 모든 YAML 기능의 카탈로그와 사용 가능한 옵션이 포함됩니다.

YAML 스키마 참조에 사용되는 구문 규칙은 다음과 같습니다.

• : 왼쪽에는 파이프라인 정의에 사용되는 리터럴 키워드가 있습니다.
• : 오른쪽에는 데이터 형식이 있습니다. 데이터 형식은 문자열 같은 기본 형식이거나 이 참조의 다른 위치에 정의된 풍부한 구조체에 대한 참조일 수 있습니다.
• 표기법 [데이터 형식] 언급된 정의 형식의 배열을 나타냅니다. 예를 들어 [ string ] 문자열 배열입니다.
• 하나의 데이터 형식을 다른 데이터 형식으로 매핑하는 것을 나타내는 표기법 {데이터 형식:데이터 형식}입니다. 예를 들어 { string: string } 문자열을 문자열에 매핑하는 것입니다.
• 기호 | 키워드에 사용할 수 있는 여러 데이터 형식이 있음을 나타냅니다. 예를 들어 job | template 작업 정의 또는 템플릿 참조가 허용됨을 의미합니다.

참고하십시오

이 참조는 Azure Pipelines YAML 파일의 스키마를 다룹니다. YAML의 기본 사항을 알아보려면 Y분YAML 학습을 참조하세요. Azure Pipelines는 모든 YAML 기능을 지원하지 않습니다. 지원되지 않는 기능에는 앵커, 복잡한 키 및 집합이 포함됩니다. 또한 표준 YAML과 달리 Azure Pipelines는 stage, job, task또는 매핑의 첫 번째 키로 script 같은 작업 바로 가기를 보는 데 의존합니다.