Определение переменных

Определите переменные с помощью пар "имя-значение".

Определения, ссылающиеся на это определение: pipeline, stage.stage, jobs.job, jobs.deployment

Определения, ссылающиеся на это определение: pipeline, jobs.job

Варианты реализации решения

Реализация Описание
variables: строковый словарь Определите переменные с помощью пар "имя-значение".
variables: список переменных Определите переменные по имени, группе переменных или в шаблоне.

Комментарии

В 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:      # 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: список переменных

Определите переменные по имени, группе переменных или в шаблоне.

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

См. также раздел