다음을 통해 공유


Azure Pipelines에 대한 YAML 스키마 참조

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

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

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

정의

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

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

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

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

jobs
파이프라인의 작업을 구성하는 작업을 지정합니다.

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
요구 사항(프라이빗 풀의 경우).

홍보
끌어오기 요청 트리거입니다.

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

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.webhooks
웹후크 목록입니다.

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
애플리케이션을 배포하는 단계를 실행하는 데 사용됩니다.

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

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

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

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

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

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

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

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

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

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

YAML 스키마 설명서 규칙

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

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

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

추가 정보

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