템플릿 매개 변수

템플릿에서 매개 변수 및 해당 데이터 형식을 지정하고 파이프라인에서 해당 매개 변수를 참조할 수 있습니다. templateContext를 사용하면 템플릿에서 매개 변수로 사용되는 단계, 단계 및 작업에 속성을 전달할 수도 있습니다.

템플릿 외부에서 매개 변수를 사용할 수도 있습니다. 매개 변수 기본값에 대해서만 리터럴을 사용할 수 있습니다. YAML 스키마의 매개 변수에 대해 자세히 알아봅니다.

매개 변수 전달

매개 변수는 이름 및 데이터 형식을 포함해야 합니다. 에서 azure-pipelines.yml매개 변수 yesNo 를 부울 값으로 설정하면 빌드가 성공합니다. 같은 apples문자열로 설정되면 yesNo 빌드가 실패합니다.

# File: simple-param.yml
parameters:
- name: yesNo # name of the parameter; required
  type: boolean # data type of the parameter; required
  default: false

steps:
- script: echo ${{ parameters.yesNo }}

# File: azure-pipelines.yml
trigger:
- main

extends:
  template: simple-param.yml
  parameters:
      yesNo: false # set to a non-boolean value to have the build fail

templateContext를 사용하여 템플릿에 속성 전달

템플릿에서 매개 변수로 사용되는 단계, 단계 및 작업에 더 많은 속성을 전달하는 데 사용할 templateContext 수 있습니다. 특히 , deploymentList또는 stageList 매개 변수 데이터 형식 내에서 jobList지정할 templateContext 수 있습니다.

각 작업을 처리할 때 환경을 더 쉽게 설정할 수 있도록 할 수 templateContext 있습니다. 작업 및 해당 환경 속성 개체를 함께 templateContext 묶으면 YAML을 더 쉽게 이해할 수 기본.

이 예제에서 매개 변수 testSettesting-template.yml 에는 데이터 형식이 있습니다 jobList. 템플릿 testing-template.yml 은 각 키워드(keyword) 사용하여 새 변수 testJob 를 만듭니다. 그런 다음 템플릿은 설정되고 템플릿에 azure-pipeline.yml 전달되는 을 참조testJob.templateContext.expectedHTTPResponseCode합니다.

응답 코드가 200이면 템플릿이 REST 요청을 만듭니다. 응답 코드가 500이면 템플릿은 디버깅을 위해 모든 환경 변수를 출력합니다.

templateContext 는 속성을 포함할 수 있습니다.

#testing-template.yml

parameters: 
- name: testSet
  type: jobList

jobs:
- ${{ each testJob in parameters.testSet }}:
  - ${{ if eq(testJob.templateContext.expectedHTTPResponseCode, 200) }}:
    - job:
      steps: 
      - powershell: 'Invoke-RestMethod -Uri https://blogs.msdn.microsoft.com/powershell/feed/ | Format-Table -Property Title, pubDate'
      - ${{ testJob.steps }}    
  - ${{ if eq(testJob.templateContext.expectedHTTPResponseCode, 500) }}:
    - job:
      steps:
      - powershell: 'Get-ChildItem -Path Env:\'
      - ${{ testJob.steps }}

#azure-pipeline.yml

trigger: none

pool:
  vmImage: ubuntu-latest

extends:
  template: testing-template.yml
  parameters:
    testSet:
    - job: positive_test
      templateContext:
        expectedHTTPResponseCode: 200
      steps:
      - script: echo "Run positive test" 
    - job: negative_test
      templateContext:
        expectedHTTPResponseCode: 500
      steps:
      - script: echo "Run negative test" 

런타임에 템플릿을 선택하는 매개 변수

조건에 따라 파이프라인 YAML에서 다른 템플릿을 호출할 수 있습니다. 이 예제에서는 매개 변수 experimentalTemplate 가 experimental.yml true일 때 YAML이 실행됩니다.

#azure-pipeline.yml
parameters:
- name: experimentalTemplate
  displayName: 'Use experimental build process?'
  type: boolean
  default: false

steps:
- ${{ if eq(parameters.experimentalTemplate, true) }}:
  - template: experimental.yml
- ${{ if not(eq(parameters.experimentalTemplate, true)) }}:
  - template: stable.yml

매개 변수 데이터 형식

데이터 형식	주의
string	string
number	로 제한될 수 있습니다. values:그렇지 않으면 숫자와 유사한 문자열이 허용됩니다.
boolean	true 또는 false
object	YAML 구조체
step	단일 단계
stepList	단계 시 퀀스
job	단일 작업
jobList	작업 시퀀스
deployment	단일 배포 작업
deploymentList	배포 작업 시퀀스
stage	단일 단계
stageList	단계 시퀀스

단계, stepList, 작업, jobList, 배포, deploymentList, stage 및 stageList 데이터 형식은 모두 표준 YAML 스키마 형식을 사용합니다. 이 예제에는 문자열, 숫자, 부울, 개체, 단계 및 stepList가 포함됩니다.

parameters:
- name: myString
  type: string
  default: a string
- name: myMultiString
  type: string
  default: default
  values:
  - default
  - ubuntu
- name: myNumber
  type: number
  default: 2
  values:
  - 1
  - 2
  - 4
  - 8
  - 16
- name: myBoolean
  type: boolean
  default: true
- name: myObject
  type: object
  default:
    foo: FOO
    bar: BAR
    things:
    - one
    - two
    - three
    nested:
      one: apple
      two: pear
      count: 3
- name: myStep
  type: step
  default:
    script: echo my step
- name: mySteplist
  type: stepList
  default:
    - script: echo step one
    - script: echo step two

trigger: none

jobs: 
- job: stepList
  steps: ${{ parameters.mySteplist }}
- job: myStep
  steps:
    - ${{ parameters.myStep }}

개체를 반복하고 개체의 각 문자열을 인쇄할 수 있습니다.

parameters:
- name: listOfStrings
  type: object
  default:
  - one
  - two

steps:
- ${{ each value in parameters.listOfStrings }}:
  - script: echo ${{ value }}

또한 개체 내의 중첩된 요소를 반복할 수 있습니다.

parameters:
- name: listOfFruits
  type: object
  default:
  - fruitName: 'apple'
    colors: ['red','green']
  - fruitName: 'lemon'
    colors: ['yellow']

steps:
- ${{ each fruit in parameters.listOfFruits }} :
  - ${{ each fruitColor in fruit.colors}} :
    - script: echo ${{ fruit.fruitName}} ${{ fruitColor }}

필수 매개 변수

템플릿의 시작 부분에 유효성 검사 단계를 추가하여 필요한 매개 변수를 검사 수 있습니다.

다음은 Bash를 사용하여 매개 변수를 solution 검사 예제입니다(모든 플랫폼에서 작동할 수 있음).

# File: steps/msbuild.yml

parameters:
- name: 'solution'
  default: ''
  type: string

steps:
- bash: |
    if [ -z "$SOLUTION" ]; then
      echo "##vso[task.logissue type=error;]Missing template parameter \"solution\""
      echo "##vso[task.complete result=Failed;]"
    fi
  env:
    SOLUTION: ${{ parameters.solution }}
  displayName: Check for required parameters
- task: msbuild@1
  inputs:
    solution: ${{ parameters.solution }}
- task: vstest@2
  inputs:
    solution: ${{ parameters.solution }}

필요한 매개 변수가 누락된 경우 템플릿이 실패했음을 표시하려면 다음을 수행합니다.

# File: azure-pipelines.yml

# This will fail since it doesn't set the "solution" parameter to anything,
# so the template will use its default of an empty string
steps:
- template: steps/msbuild.yml