閱讀英文

共用方式為


變數定義

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

參考此定義的定義: pipelinestage.stagejobs.jobjobs.deployment

參考此定義的定義: pipelinejobs.job

實作

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

備註

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

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

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

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

變數:字串字典

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

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:      # 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

另請參閱