變數定義

使用名稱/值組定義變數。

參考此定義的定義： pipeline、 stage.stage、 jobs.job、 jobs.deployment

實作

實作	描述
變數：字串字典	使用名稱/值組定義變數。
變數：變數清單	依名稱、變數群組或在範本中定義變數。

備註

關鍵詞 variables 使用兩種語法形式：變數清單和對應 (字串字典) 。

在對應語法中，所有索引鍵都是變數名稱，而其值是變數值。 若要使用變數範本，您必須使用清單語法。 清單語法會要求您指定是否提及變數 (name) 、變數群組 (group) ，或範本 (template) 。

您無法在同一個變數區段中使用清單和對應變數，但您可以在使用清單語法時合併 name、 group和 template 。

您可以在管線、階段或作業層級指定變數。

變數：字串字典

使用名稱/值組定義變數。

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.

清單類型

類型	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

另請參閱

• 新增 & 使用變數群組
• 定義變數