Определение переменных
Определите переменные с помощью пар "имя-значение".
Определения, ссылающиеся на это определение: pipeline, stage.stage, jobs.job, jobs.deployment
Варианты реализации решения
Реализация | Описание |
---|---|
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