共用方式為


擴充定義

使用範本擴充管線。

extends:
  template: string # The template referenced by the pipeline to extend.
  parameters: # Parameters used in the extend.

參考此定義的定義:管線

性能

template 字串。
管線所參考的範本進行擴充。

parameters 範本參數。
擴充中使用的參數。

範例

範本及其參數會在管線執行之前轉換成常數。 範本參數提供輸入參數的類型安全性。 在這裡範例中,樣本 start.yml 會定義 參數 buildSteps,然後在 中使用 azure-pipelines.yml。 如果 buildStep 以腳本步驟傳遞,則會遭到拒絕,且管線組建失敗。

# File: start.yml
parameters:
- name: buildSteps # the name of the parameter is buildSteps
  type: stepList # data type is StepList
  default: [] # default value of buildSteps
stages:
- stage: secure_buildstage
  pool:
    vmImage: windows-latest
  jobs:
  - job: secure_buildjob
    steps:
    - script: echo This happens before code 
      displayName: 'Base: Pre-build'
    - script: echo Building
      displayName: 'Base: Build'

    - ${{ each step in parameters.buildSteps }}:
      - ${{ each pair in step }}:
          ${{ if ne(pair.value, 'CmdLine@2') }}:
            ${{ pair.key }}: ${{ pair.value }}       
          ${{ if eq(pair.value, 'CmdLine@2') }}: 
            # Step is rejected by raising a YAML syntax error: Unexpected value 'CmdLine@2'
            '${{ pair.value }}': error         

    - script: echo This happens after code
      displayName: 'Base: Signing'
# File: azure-pipelines.yml
trigger:
- main

extends:
  template: start.yml
  parameters:
    buildSteps:  
      - bash: echo Test #Passes
        displayName: succeed
      - bash: echo "Test"
        displayName: succeed
      # Step is rejected by raising a YAML syntax error: Unexpected value 'CmdLine@2'
      - task: CmdLine@2
        inputs:
          script: echo "Script Test"
      # Step is rejected by raising a YAML syntax error: Unexpected value 'CmdLine@2'
      - script: echo "Script Test"

另請參閱