Share via


definition av variabler

Definiera variabler med namn/värde-par.

Definitioner som refererar till den här definitionen: pipeline, stages.stage, jobs.job, jobs.deployment

Definitioner som refererar till den här definitionen: pipeline, jobs.job

Implementeringar

Implementering Description
variabler: strängordlista Definiera variabler med namn/värde-par.
variabler: variabellista Definiera variabler efter namn, variabelgrupp eller i en mall.

Kommentarer

Nyckelordet variables använder två syntaxformulär: variabellista och mappning (strängordlista).

I mappningssyntaxen är alla nycklar variabelnamn och deras värden är variabelvärden. Om du vill använda variabelmallar måste du använda listsyntax. Listsyntaxen kräver att du anger om du nämner en variabel (name), en variabelgrupp (group) eller en mall (template).

Du kan inte använda list- och mappningsvariabler i samma variabelavsnitt, men du kan kombinera name, groupoch template när du använder listsyntax.

Du kan ange variabler på pipeline-, fas- eller jobbnivå.

variabler: strängordlista

Definiera variabler med namn/värde-par.

variables:
  string: string # Name/value pairs

Inga.

Exempel

Använd den här mappningssyntaxen för en enkel uppsättning hårdkodade variabler:

variables: { string: string }

Variabler som definierats i olika omfång:

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)

variabler: variabellista

Definiera variabler efter namn, variabelgrupp eller i en mall.

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

Listtyper

Typ Description
variables.name Definiera variabler med namn och fullständig syntax.
variables.group Referensvariabler från en variabelgrupp.
variables.template Definiera variabler i en mall.

Exempel

Om du vill inkludera variabelgrupper växlar du till den här sekvenssyntaxen:

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

Du kan upprepa name/value par och group.

Variabler kan också anges som skrivskyddade för att förbättra säkerheten.

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

Du kan också inkludera variabler från mallar.

Sekvenssyntax:

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

Se även