變數定義
使用名稱/值組定義變數。
參考此定義的定義: pipeline、 stage.stage、 jobs.job、 jobs.deployment
關鍵詞 variables
使用兩種語法形式:變數清單和對應 (字串字典) 。
在對應語法中,所有索引鍵都是變數名稱,而其值是變數值。 若要使用變數範本,您必須使用清單語法。 清單語法會要求您指定是否提及變數 (name
) 、變數群組 (group
) ,或範本 (template
) 。
您無法在同一個變數區段中使用清單和對應變數,但您可以在使用清單語法時合併 name
、 group
和 template
。
您可以在管線、階段或作業層級指定變數。
針對一組簡單的硬式編碼變數,請使用此對應語法:
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: # pipeline-level
MY_VAR: 'my value'
ANOTHER_VAR: 'another value'
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.
類型 | Description |
---|---|
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