昨天的文章提到了運算式與函數，今天我們來看看另一個跟變數(variables)很像的東西：參數(parameters)。
參數可以應用在單一的YAML Pipeline設計，也可以使用在範本template的設計中。
如果是在單一個Pipeline的設計上使用，搭配運算式的使用，它可以讓手動觸發的介面多出幾個可以讓使用者設定的選項，最簡單的範例就是讓使用者選擇要用來執行的agent類型。例如我們設計一個讓使用者可以選擇使用ubuntu的agent或是使用windows的agent：
上面這張圖的左邊就是加上了參數(Parameter)之後在手動執行時呈現的樣貌，而右邊就是一般預設的執行畫面。要達成這樣的設計並不困難，我們只要在YAML內容中加上parameters的關鍵字，再把我們規劃的參數加進去就行。要取得參數值的時候，則是利用${{ parameters.參數名稱 }}這樣的格式來取得設定值。
trigger:
- none
parameters:
- name: vmImageOS
type: string
default: ubuntu-latest
values:
- ubuntu-latest
- windows-latest
pool:
vmImage: ${{ parameters.vmImageOS }}
上面這一段的YAML內容就是對應上圖的設計結果，使用前面第10天文章內的YAML內容來修改，實際上就是加上parameters那一段的宣告，把pool底下的vmImage原本的ubuntu-latest換成${{ parameters.vmImageOS }}。
每一個參數的定義格式除了name跟type之外，其它的定義並不是必須的。type的部份則有下列這些類型：
- string
- number：數字
- boolean
- object：任何YAML結構
- step：單一步驟
- stepList：多個步驟
- job：單一作業
- jobList：多個作業
- deployment：單一部署作業
- deploymentList：多個部署作業
- stage：單一階段
- stageList：多個階段
一般常用的就是string、boolean，其它的大多是在範本設計的時候才會用到。
上面的例子只是讓使用者在執行的時候可以選擇使用哪一種OS的vmImage，但是實際上更常會碰到的是在執行的時候選擇是使用cloud的agent或是我們自己建立的agent，但是cloud agent是透過vmImage這個關鍵字來設定，而自己建立的agent則是利用name來指定使用哪一個agent pool，並且可能搭配demands關鍵字來篩選符合條件的agent。
碰到這樣的需求，我們就必須利用編譯時期的運算式，也就是${{ 內容 }}搭配判斷式與變數來達成需求：
trigger:
- none
parameters:
- name: agentType
type: string
default: self-hosted
values:
- cloud-hosted
- self-hosted
- name: agentPoolName
type: string
default: 'Default'
- name: agentName
type: string
default: ''
variables:
${{ if eq(parameters.agentType, 'cloud-hosted') }}:
agentPoolKey: vmImage
agentPoolValue: ubuntu-latest
${{ else }}:
agentPoolKey: name
agentPoolValue: ${{ parameters.agentPoolName }}
stages:
- stage: Stage1
pool:
${{ variables.agentPoolKey }}: ${{ variables.agentPoolValue }}
${{ if ne(parameters.agentName, '') }}:
demands:
- agent.name -equals ${{ parameters.agentName }}從上面的YAML內容就可以看得出來，正好將這兩天所提到的運算是、函數、參數、變數與判斷式全都用上了。執行的範例如下圖：
這邊要特別留意的地方就是在使用了${{ 判斷式 }}之後要接續的YAML內容要內排一個層級。
除了上面的範例，更多的例子也可以參考官方文件上的說明與範例。