표현

# Expressions are used to define conditions for a step, job, or stage
steps:
- task: ...
  condition: <expression>

식의 또 다른 일반적인 사용은 변수를 정의하는 것입니다. 컴파일 시점에 식을 평가할 수 있으며, 런타임에 식을 평가할 수 있습니다. 컴파일 시간 식은 어디서나 사용할 수 있습니다. 런타임 식은 변수 및 조건에서 사용할 수 있습니다. 런타임 식은 변수 및 상태의 내용을 계산하는 방법으로 사용됩니다(예: condition).

# Two examples of expressions used to define variables
# The first one, a, is evaluated when the YAML file is compiled into a plan.
# The second one, b, is evaluated at runtime.
# Note the syntax ${{}} for compile time and $[] for runtime expressions.
variables:
  a: ${{ <expression> }}
  b: $[ <expression> ]

런타임과 컴파일 시간 식 구문의 차이점은 주로 사용 가능한 컨텍스트입니다. 컴파일 시 표현식(${{ <expression> }})에서는 parameters와 정적으로 정의된 variables에 접근할 수 있습니다. 런타임 식($[ <expression> ])에서는 매개 변수를 제외한 더 많은 variables 항목에 액세스할 수 있습니다.

이 예제에서 런타임 식은 의 값을 $(isMain)설정합니다. 컴파일 식의 정적 변수는 의 값을 $(compileVar)설정합니다.

variables:
  staticVar: 'my value' # static variable
  compileVar: ${{ variables.staticVar }} # compile time expression
  isMain: $[eq(variables['Build.SourceBranch'], 'refs/heads/main')] # runtime expression

steps:
  - script: |
      echo ${{variables.staticVar}} # outputs my value
      echo $(compileVar) # outputs my value
      echo $(isMain) # outputs True

합치다

• 매개 변수를 순서대로 계산하고(왼쪽에서 오른쪽) null 또는 빈 문자열과 같지 않은 첫 번째 값을 반환합니다.
• 매개 변수 값이 모두 null이거나 빈 문자열이면 값이 반환되지 않습니다.
• 최소 매개 변수: 2. 최대 매개 변수: N
• 예: coalesce(variables.couldBeNull, variables.couldAlsoBeNull, 'literal so it always works')

convertToJson(변환하기)

• 복잡한 개체를 가져와 JSON으로 출력합니다.
• 최소 매개 변수: 1. 최대 매개 변수: 1.

parameters:
  - name: listOfValues
    type: object
    default:
      this_is:
        a_complex: object
        with:
          - one
          - two

steps:
- script: |
    echo "${MY_JSON}"
  env:
    MY_JSON: ${{ convertToJson(parameters.listOfValues) }}

스크립트 출력:

{
  "this_is": {
    "a_complex": "object",
    "with": [
      "one",
      "two"
    ]
  }
}

계산대

• 이 함수는 변수를 정의하는 식에서만 사용할 수 있습니다. 단계, 작업 또는 스테이지에 대한 조건의 일부로 사용할 수 없습니다.
• 파이프라인의 각 실행에 따라 증가하는 숫자를 평가합니다.
• 매개 변수: 2. prefix 및 seed.
• 접두사는 문자열 식입니다. 접두사 고유 값마다 별도의 카운터 값이 추적됩니다. prefix은 UTF-16 문자를 사용해야 합니다.
• 시드는 카운터의 시작 값입니다.

파이프라인의 각 실행에서 하나씩 자동으로 증가되는 카운터를 만들 수 있습니다. 카운터를 정의할 때 prefix와 seed를 제공합니다. 이를 보여 주는 예제는 다음과 같습니다.

variables:
  major: 1
  # define minor as a counter with the prefix as variable major, and seed as 100.
  minor: $[counter(variables['major'], 100)]

steps:
- bash: echo $(minor)

파이프라인의 minor 첫 번째 실행에서 위의 예제의 값은 100입니다. 두 번째 실행에서는 값 major 이 여전히 1인 경우 101입니다.

YAML 파일을 편집하고 변수 major 값을 2로 업데이트하는 경우 파이프라인의 다음 실행에서 값 minor 은 100이 됩니다. 이후 실행에서는 카운터가 101, 102, 103으로 계속 증가합니다.

나중에 YAML 파일을 편집하고 값을 major 다시 1로 설정하면 카운터 값이 해당 접두사에 대해 중단된 위치에서 다시 시작됩니다. 이 예제에서는 102에서 다시 시작합니다.

다음은 100에서 시작하여 매 실행마다 1씩 증가하며 매일 100으로 다시 설정되는 카운터 역할을 하도록 변수를 설정하는 또 다른 예입니다.

jobs:
- job:
  variables:
    a: $[counter(format('{0:yyyyMMdd}', pipeline.startTime), 100)]
  steps:
  - bash: echo $(a)

다음은 PR 및 CI 실행에 대해 별도의 값을 유지하는 카운터를 사용하는 예제입니다.

variables:
  patch: $[counter(variables['build.reason'], 0)]

카운터는 파이프라인의 범위 내에 있습니다. 즉, 해당 파이프라인의 각 실행에 대해 해당 값이 증가합니다. 프로젝트 범위의 카운터가 없습니다.

형식

• 후행 매개 변수를 평가하고 선행 매개 변수 문자열에 삽입합니다.
• 최소 매개 변수: 1. 최대 매개 변수: N
• 예: format('Hello {0} {1}', 'John', 'Doe')
• 날짜 서식 지정에 .NET 사용자 지정 날짜 및 시간 형식 지정자를 사용합니다(, , , yyyyyy, MMM, dd, dHH, Hm, mmsss, ) fffffffK
• 예: format('{0:yyyyMMdd}', pipeline.startTime) 이 경우 pipeline.startTime 특별한 날짜 시간 개체 변수입니다.
• 중괄호를 두 배로 늘려 이스케이프합니다. 예: format('literal left brace {{ and literal right brace }}')

IIF는

• 첫 번째 매개 변수가 계산되면 두 번째 매개 변수를 True반환하고, 그렇지 않으면 세 번째 매개 변수를 반환합니다.
• 최소 매개 변수: 1. 최대 매개 변수: 3
• 첫 번째 매개 변수는 조건이어야 합니다.
• 예: iif(eq(variables['Build.Reason'], 'PullRequest'), 'ManagedDevOpsPool', 'Azure Pipelines') PR에 대한 응답으로 파이프라인이 실행될 때 'ManagedDevOpsPool'을 반환합니다.

참여하다

• 오른쪽 매개 변수 배열의 모든 요소를 왼쪽 매개 변수 문자열로 구분하여 연결합니다.
• 최소 매개 변수: 2. 최대 매개 변수: 2
• 배열의 각 요소는 문자열로 변환됩니다. 복합 개체는 빈 문자열로 변환됩니다.
• 올바른 매개 변수가 배열이 아닌 경우 결과는 문자열로 변환된 올바른 매개 변수입니다.

이 예제에서는 배열의 각 항목 사이에 세미콜론이 추가됩니다. 매개 변수 형식이 개체입니다.

parameters:
- name: myArray
  type: object
  default:
    - FOO
    - BAR
    - ZOO

variables:
   A: ${{ join(';',parameters.myArray) }}

steps:
  - script: echo $A # outputs FOO;BAR;ZOO

낮추다 / 아래의 / 더 낮은

• 문자열 또는 변수 값을 모든 소문자로 변환합니다.
• 최소 매개 변수: 1. 최대 매개 변수 1
• 문자열에 해당하는 소문자를 반환합니다.
• 예제: lower('FOO') 반환 foo

교체하다

• 현재 인스턴스에 있는 문자열의 모든 인스턴스가 다른 문자열로 대체되는 새 문자열을 반환합니다.
• 최소 매개 변수: 3. 최대 매개 변수: 3
• replace(a, b, c): b의 모든 인스턴스가 c로 대체된 a를 반환합니다.
• 예: replace('https://www.tinfoilsecurity.com/saml/consume','https://www.tinfoilsecurity.com','http://server') (반환 http://server/saml/consume)

분할

• 지정된 구분 문자에 따라 문자열을 부분 문자열로 분할합니다.
• 최소 매개 변수: 2. 최대 매개 변수: 2
• 첫 번째 매개 변수는 분할할 문자열입니다.
• 두 번째 매개 변수는 구분 문자입니다.
• 부분 문자열의 배열을 반환합니다. 구분 문자가 연속적으로 또는 문자열 끝에 표시되면 배열에 빈 문자열이 포함됩니다.
• 예:

  variables:
  - name: environments
    value: prod1,prod2
  steps:
    - ${{ each env in split(variables.environments, ',')}}:
      - script: ./deploy.sh --environment ${{ env }}
  

• replace()와 함께 split()를 사용하는 예:

  parameters:
  - name: resourceIds
    type: object
    default:
    - /subscriptions/mysubscription/resourceGroups/myResourceGroup/providers/Microsoft.Network/loadBalancers/kubernetes-internal
    - /subscriptions/mysubscription02/resourceGroups/myResourceGroup02/providers/Microsoft.Network/loadBalancers/kubernetes
  - name: environments
    type: object
    default:
    - prod1
    - prod2
  
  trigger:
  - main
  
  steps:
  - ${{ each env in parameters.environments }}:
    - ${{ each resourceId in parameters.resourceIds }}:
        - script: echo ${{ replace(split(resourceId, '/')[8], '-', '_') }}_${{ env }}
  

다듬다

• 앞뒤 공백을 제거한 매개 변수를 반환합니다.
• 최소 매개 변수: 1. 최대 매개 변수: 1
• 예: trim(' variable ') 'variable'를 반환합니다.

위쪽

• 문자열 또는 변수 값을 모든 대문자로 변환합니다.
• 최소 매개 변수: 1. 최대 매개 변수 1
• 문자열에 해당하는 대문자를 반환합니다.
• 예제: upper('bah') 반환 BAH

및 ifelseif 절을 사용하여 else조건부로 변수 값을 할당하거나 작업에 대한 입력을 설정할 수 있습니다. 조건이 충족되면 단계를 조건부로 실행할 수도 있습니다.

조건부로 작업 입력 설정

pool:
  vmImage: 'ubuntu-latest'

steps:
- task: PublishPipelineArtifact@1
  inputs:
    targetPath: '$(Pipeline.Workspace)'
    ${{ if eq(variables['Build.SourceBranchName'], 'main') }}:
      artifact: 'prod'
    ${{ else }}:
      artifact: 'dev'
    publishLocation: 'pipeline'

조건부로 단계 실행

변수 집합이 없거나 foo 값이 if 조건과 일치하지 않으면 else 문이 실행됩니다. 여기서 foo의 값은 elseif 조건에서 true를 반환합니다.

variables:
  - name: foo
    value: contoso # triggers elseif condition

pool:
  vmImage: 'ubuntu-latest'

steps:
- script: echo "start"
- ${{ if eq(variables.foo, 'adaptum') }}:
  - script: echo "this is adaptum"
- ${{ elseif eq(variables.foo, 'contoso') }}: # true
  - script: echo "this is contoso"
- ${{ else }}:
  - script: echo "the value is not adaptum or contoso"

각 키워드

키워드를 each 사용하여 개체 형식의 매개 변수를 반복할 수 있습니다.

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 }}

종속성

표현식은 종속성 컨텍스트를 사용하여 이전 작업이나 단계를 참조할 수 있습니다. 종속성을 사용하여 다음을 수행할 수 있습니다.

• 이전 작업의 작업 상태 참조
• 이전 단계의 스테이지 상태 참조
• 동일한 단계에서 이전 작업의 출력 변수 참조
• 이전 단계에서 출력 변수를 단계 내에서 참조하세요.
• 다음 단계에서 이전 단계의 작업의 출력 변수 참조

컨텍스트는 작업 및 단계에 대해 호출 dependencies 되며 변수와 매우 유사하게 작동합니다. 다른 단계의 작업에서 출력 변수를 참조하는 경우 컨텍스트를 호출 stageDependencies합니다.

출력 변수에 따옴표 문자('또는")가 있는 문제가 발생하는 경우 이 문제 해결 가이드를 참조하세요.

종속성 구문 개요

종속성이 있는 출력 변수를 참조하는 구문은 상황에 따라 달라집니다. 다음은 가장 일반적인 시나리오에 대한 개요입니다. 대체 구문도 작동하는 경우가 있을 수 있습니다.

배포 전략에 따라 배포 작업에서 출력 변수에 대한 구문도 다릅니다. 자세한 내용은 배포 작업을 참조 하세요.

단계별 종속성

구조적으로 dependencies 개체는 작업 및 단계 이름을 results 및 outputs로 매핑하는 맵입니다. JSON으로 표현되는 모양은 다음과 같습니다.

"dependencies": {
  "<STAGE_NAME>" : {
    "result": "Succeeded|SucceededWithIssues|Skipped|Failed|Canceled",
    "outputs": {
        "jobName.stepName.variableName": "value"
    }
  },
  "...": {
    // another stage
  }
}

이 형식을 dependencies 사용하여 변수에 매핑하거나 단계 수준에서 조건을 확인합니다.

이 예제에는 A와 B라는 두 단계가 있습니다. 스테이지 A에는 조건이 false 있으며 결과적으로 실행되지 않습니다. 스테이지 A의 결과가 Succeeded, SucceededWithIssues, 또는 Skipped일 경우에 스테이지 B가 실행됩니다. 스테이지 A를 건너뛰었으므로 B단계가 실행됩니다.

stages:
- stage: A
  condition: false
  jobs:
  - job: A1
    steps:
    - script: echo Job A1
- stage: B
  condition: in(dependencies.A.result, 'Succeeded', 'SucceededWithIssues', 'Skipped')
  jobs:
  - job: B1
    steps:
    - script: echo Job B1

스테이지는 다른 단계의 출력 변수를 사용할 수도 있습니다. 이 예제에는 두 단계도 있습니다. 스테이지 A에는 출력 변수 shouldruntrue를 .로 설정하는 작업 A1이 포함됩니다. shouldrun이 true일 때 단계 B가 실행됩니다. shouldrun 이기 때문에 B단계가 true 실행됩니다.

stages:
- stage: A
  jobs:
  - job: A1
    steps:
     - bash: echo "##vso[task.setvariable variable=shouldrun;isOutput=true]true"
     # or on Windows:
     # - script: echo ##vso[task.setvariable variable=shouldrun;isOutput=true]true
       name: printvar

- stage: B
  condition: and(succeeded(), eq(dependencies.A.outputs['A1.printvar.shouldrun'], 'true'))
  dependsOn: A
  jobs:
  - job: B1
    steps:
    - script: echo hello from Stage B

한 단계 내의 직무 간 종속성

단일 단계 내의 작업 수준에서 데이터에는 dependencies 단계 수준 정보가 포함되지 않습니다.

"dependencies": {
  "<JOB_NAME>": {
    "result": "Succeeded|SucceededWithIssues|Skipped|Failed|Canceled",
    "outputs": {
      "stepName.variableName": "value1"
    }
  },
  "...": {
    // another job
  }
}

이 예제에는 세 가지 작업(a, b 및 c)이 있습니다. 작업 A는 condition: false 때문에 항상 건너뛰어집니다. 연결된 조건이 없으므로 작업 b가 실행됩니다. 작업 c는 모든 종속성이 완료되었거나(작업 b) 건너뛰었기 때문에(작업 a) 실행됩니다.

jobs:
- job: a
  condition: false
  steps:
  - script: echo Job a
- job: b
  steps:
  - script: echo Job b
- job: c
  dependsOn:
  - a
  - b
  condition: |
    and
    (
      in(dependencies.a.result, 'Succeeded', 'SucceededWithIssues', 'Skipped'),
      in(dependencies.b.result, 'Succeeded', 'SucceededWithIssues', 'Skipped')
    )
  steps:
  - script: echo Job c

이 예제에서 작업 B는 작업 A의 출력 변수에 따라 달라집니다.

jobs:
- job: A
  steps:
  - bash: echo "##vso[task.setvariable variable=shouldrun;isOutput=true]true"
  # or on Windows:
  # - script: echo ##vso[task.setvariable variable=shouldrun;isOutput=true]true
    name: printvar

- job: B
  condition: and(succeeded(), eq(dependencies.A.outputs['printvar.shouldrun'], 'true'))
  dependsOn: A
  steps:
  - script: echo hello from B

단계 간 작업 간 종속성

작업 수준에서 이전 단계의 작업에서 출력을 참조할 수도 있습니다. 이를 위해서는 컨텍스트를 stageDependencies 사용해야 합니다.

"stageDependencies": {
  "<STAGE_NAME>" : {
    "<JOB_NAME>": {
      "result": "Succeeded|SucceededWithIssues|Skipped|Failed|Canceled",
      "outputs": {
          "stepName.variableName": "value"
      }
    },
    "...": {
      // another job
    }
  },
  "...": {
    // another stage
  }
}

이 예제에서는 작업 A1을 건너뛰면 작업 B1이 실행됩니다. 작업 B2는 작업 A1의 출력 변수 값을 확인하여 실행해야 하는지 여부를 확인합니다.

stages:
- stage: A
  jobs:
  - job: A1
    steps:
     - bash: echo "##vso[task.setvariable variable=shouldrun;isOutput=true]true"
     # or on Windows:
     # - script: echo ##vso[task.setvariable variable=shouldrun;isOutput=true]true
       name: printvar

- stage: B
  dependsOn: A
  jobs:
  - job: B1
    condition: in(stageDependencies.A.A1.result, 'Skipped') # change condition to `Succeeded and stage will be skipped`
    steps:
    - script: echo hello from Job B1
  - job: B2
    condition: eq(stageDependencies.A.A1.outputs['printvar.shouldrun'], 'true')
    steps:
     - script: echo hello from Job B2

작업이 다른 단계의 배포 작업에서 정의한 변수에 따라 달라지면 구문이 다릅니다. 다음 예제에서 run_tests를 build_job로 설정한 배포 작업이 있을 때, 작업 runTests가 실행됩니다. 사전에 사용된 키는 outputsbuild_job.setRunTests.runTests입니다.

stages:
- stage: build
  jobs:
  - deployment: build_job
    environment:
      name: Production
    strategy:
      runOnce:
        deploy:
          steps:
          - task: PowerShell@2
            name: setRunTests
            inputs:
              targetType: inline
              pwsh: true
              script: |
                $runTests = "true"
                echo "setting runTests: $runTests"
                echo "##vso[task.setvariable variable=runTests;isOutput=true]$runTests"

- stage: test
  dependsOn:
  - 'build'
  jobs:
    - job: run_tests
      condition: eq(stageDependencies.build.build_job.outputs['build_job.setRunTests.runTests'], 'true')
      steps:
        ...

배포 작업 출력 변수

스테이지가 다른 단계의 배포 작업에서 정의한 변수에 따라 달라지면 구문이 다릅니다. 다음 예제에서 단계는 test 배포 build_job 설정 shouldTesttrue에 따라 달라집니다. condition 단계의 test에서 build_job가 두 번 나타나는 것을 주목하세요.

stages:
- stage: build
  jobs:
  - deployment: build_job
    environment:
      name: Production
    strategy:
      runOnce:
        deploy:
          steps:
          - task: PowerShell@2
            name: setRunTests
            inputs:
              targetType: inline
              pwsh: true
              script: |
                $runTests = "true"
                echo "setting runTests: $runTests"
                echo "##vso[task.setvariable variable=runTests;isOutput=true]$runTests"

- stage: test
  dependsOn:
  - 'build'
  condition: eq(dependencies.build.outputs['build_job.build_job.setRunTests.runTests'], 'true')
  jobs:
    - job: A
      steps:
        - script: echo Hello from job A

위의 예제에서 조건은 환경 리소스가 아닌 환경을 참조합니다. 환경 리소스를 참조하려면 종속성 조건에 환경 리소스 이름을 추가해야 합니다. 다음 예제에서 조건은 명명 vmtest된 환경 가상 머신 리소스를 참조합니다.

stages:
- stage: build
  jobs:
  - deployment: build_job
    environment:
      name: vmtest
      resourceName: winVM2
      resourceType: VirtualMachine
    strategy:
      runOnce:
        deploy:
          steps:
          - task: PowerShell@2
            name: setRunTests
            inputs:
              targetType: inline
              pwsh: true
              script: |
                $runTests = "true"
                echo "setting runTests: $runTests"
                echo "##vso[task.setvariable variable=runTests;isOutput=true]$runTests"

- stage: test
  dependsOn:
  - 'build'
  condition: eq(dependencies.build.outputs['build_job.Deploy_winVM2.setRunTests.runTests'], 'true')
  jobs:
  - job: A
    steps:
     - script: echo Hello from job A