變數定義

定義管線中使用的變數。

使用此定義的屬性: pipeline.variablesjobs.job.variables

使用此定義的屬性: pipeline.variablesjobs.job.variables

多載

多載 描述
變數:字串配對 使用名稱/值組定義變數。
變數:變數清單 依名稱、變數群組或在範本中定義變數。
多載 描述
變數:字串配對 使用名稱/值組定義變數。
變數:變數清單 依名稱、變數群組或在範本中定義變數。
多載 描述
變數:字串配對 使用名稱/值組定義變數。
變數:變數清單 依名稱、變數群組或在範本中定義變數。
多載 描述
變數:字串配對 使用名稱/值組定義變數。
變數:變數清單 依名稱、變數群組或在範本中定義變數。
多載 描述
變數:字串配對 使用名稱/值組定義變數。
變數:變數清單 依名稱、變數群組或在範本中定義變數。
多載 描述
變數:字串配對 使用名稱/值組定義變數。
變數:變數清單 依名稱、變數群組或在範本中定義變數。

備註

關鍵字 variables 使用兩種語法形式:清單和對應。

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

您無法在同一個變數區段中使用清單和對應變數,但您可以在使用清單語法時合併 namegrouptemplate

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

變數:字串配對

您可以將變數指定為字串/值組。

variables:
  string: string # Name/value pairs.

屬性

mapping

字串名稱/值組


variables:
  string: string # Name/value pairs.

屬性

mapping

字串名稱/值組


variables:
  string: string # Name/value pairs.

屬性

mapping

字串名稱/值組


variables:
  string: string # Name/value pairs.

屬性

mapping

字串名稱/值組


variables:
  string: string # Name/value pairs.

屬性

mapping

字串名稱/值組


variables:
  string: string # Name/value pairs.

屬性

mapping

字串名稱/值組


範例

針對一組簡單的硬式編碼變數,請使用此對應語法:

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. 

屬性

variables


variables: [ name | group | template ] # Define variables by name, variable group, or in a template. 

屬性

variables


variables: [ name | group | template ] # Define variables by name, variable group, or in a template. 

屬性

variables


variables: [ name | group | template ] # Define variables by name, variable group, or in a template. 

屬性

variables


variables: [ name | group | template ] # Define variables by name, variable group, or in a template. 

屬性

variables


variables: [ name | group | template ] # Define variables by name, variable group, or in a template. 

屬性

variables


範例

若要包含變數群組,請切換至此順序語法:

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

另請參閱