Dela via

definition av variabler

  • Artikel

Definiera variabler med namn/värde-par.

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

Implementeringar

Genomförande Beskrivning
variabler: strängordlista Definiera variabler med namn/värde-par.
variabler: Definiera variabler efter namn, variabelgrupp eller i en mall.

Anmärkningar

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

Ingen.

Exempel

För en enkel uppsättning hårdkodade variabler använder du den här mappningssyntaxen:

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)

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 Beskrivning
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å ta med 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