使用名稱/值組定義變數。
參考此定義的定義:管線、stage.stage、jobs.job、jobs.deployment
實作
備註
variables
關鍵詞使用兩種語法形式:變數清單和對應(字串字典)。
在對應語法中,所有索引鍵都是變數名稱,而其值是變數值。 若要使用變數範本,您必須使用清單語法。 清單語法需要您指定是否提及變數(name
)、變數群組(group
),或範本(template
)。
您無法在同一個變數區段中使用清單和對應變數,但您可以在使用清單語法時合併 name
、group
和 template
。
您可以在管線、階段或作業層級指定變數。
variables:字串字典
使用名稱/值組定義變數。
variables:
string: string # Name/value pairs
沒有。
範例
針對一組簡單的硬式編碼變數,請使用下列對應語法:
variables: { string: string }
在不同範圍定義的變數:
variables: # pipeline-level
MY_VAR: 'my value'
ANOTHER_VAR: 'another value'
stages:
- stage: Build
variables: # stage-level
STAGE_VAR: 'that happened'
jobs:
- job: FirstJob
variables: # job-level
JOB_VAR: 'a job var'
steps:
- script: echo $(MY_VAR) $(STAGE_VAR) $(JOB_VAR)
變數:變數清單
依名稱、變數群組或範本中的變數來定義變數。
variables: [ name | group | template ] # Define variables by name, variable group, or in a template.
清單類型
類型 | 說明 |
---|---|
variables.name | 使用名稱和完整語法定義變數。 |
variables.group | 參考變數群組的變數。 |
variables.template | 在範本中定義變數。 |
範例
若要包含變數群組,請切換至此序列語法:
variables:
- name: string # name of a variable
value: string # value of the variable
- group: string # name of a variable group
您可以重複 name
/value
組和 group
。
變數也可以設定為唯讀,以 增強安全性。
variables:
- name: myReadOnlyVar
value: myValue
readonly: true
您也可以從範本 包含變數。
順序語法:
variables:
- name: MY_VARIABLE # hard-coded value
value: some value
- group: my-variable-group-1 # variable group
- group: my-variable-group-2 # another variable group