使用範本擴充管線。
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"