Sdílet prostřednictvím

definice proměnných

  • Článek

Definujte proměnné pomocí párů název/hodnota.

Definice, které odkazují na tuto definici: pipeline, stages.stage, jobs.job, jobs.deployment

Definice, které odkazují na tuto definici: pipeline, jobs.job

Implementace

Implementace Popis
variables: string dictionary Definujte proměnné pomocí párů název/hodnota.
variables: variable list Definujte proměnné podle názvu, skupiny proměnných nebo v šabloně.

Poznámky

Klíčové variables slovo používá dva tvary syntaxe: seznam proměnných a mapování (řetězcový slovník).

V syntaxi mapování jsou všechny klíče názvy proměnných a jejich hodnoty jsou hodnoty proměnných. Pokud chcete použít šablony proměnných, musíte použít syntaxi seznamu. Syntaxe seznamu vyžaduje, abyste určili, jestli zmíníte proměnnou (name), skupinu proměnných (group) nebo šablonu (template).

Seznam a mapování proměnných nemůžete použít ve stejné části proměnných, ale při použití syntaxe seznamu můžete kombinovat name, groupa template .

Proměnné můžete zadat na úrovni kanálu, fáze nebo úlohy.

variables: string dictionary

Definujte proměnné pomocí párů název/hodnota.

variables:
  string: string # Name/value pairs

Žádné

Příklady

Pro jednoduchou sadu pevně zakódovaných proměnných použijte tuto syntaxi mapování:

variables: { string: string }

Proměnné definované v různých oborech:

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: variable list

Definujte proměnné podle názvu, skupiny proměnných nebo v šabloně.

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

Typy seznamů

Typ Description
variables.name Definujte proměnné pomocí názvu a úplné syntaxe.
variables.group Odkaz na proměnné ze skupiny proměnných.
variables.template Definování proměnných v šabloně

Příklady

Pokud chcete zahrnout skupiny proměnných, přepněte na tuto syntaxi sekvence:

variables:
- name: string  # name of a variable
  value: string # value of the variable
- group: string # name of a variable group

Můžete opakovat name/value dvojice a .group

Proměnné lze také nastavit jako jen pro čtení, aby se zvýšilo zabezpečení.

variables:
- name: myReadOnlyVar
  value: myValue
  readonly: true

Můžete také zahrnout proměnné ze šablon.

Syntaxe sekvence:

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

Viz také