範本參數

您可以在範本中指定參數及其資料類型，並在管線中參考這些參數。 使用 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。

在這裡範例中，中的 testing-template.yml 參數testSet具有 資料類型 jobList。 此範本testing-template.yml會使用每個關鍵詞來建立新的變數testJob。 然後，範本會參考 testJob.templateContext.expectedHTTPResponseCode，這會在 中 azure-pipeline.yml 設定並傳遞至範本。

當回應碼為 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 呼叫不同的範本。 在此範例中 experimental.yml ，YAML 會在 參數 experimentalTemplate 為 true 時執行。

#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、job、jobList、deployment、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