Freigeben über

Variablendefinition

  • Artikel

Definieren Sie Variablen mithilfe von Name-Wert-Paaren.

Definitionen, die auf diese Definition verweisen: pipeline, stages.stage, jobs.job, jobs.deployment

Definitionen, die auf diese Definition verweisen: pipeline, jobs.job

Implementierungen

Implementierung Beschreibung
variablen: Zeichenfolgenwörterbuch Definieren Sie Variablen mithilfe von Name-Wert-Paaren.
Variablen: Variablenliste Definieren Sie Variablen nach Name, Variablengruppe oder in einer Vorlage.

Hinweise

Die variables Schlüsselwort (keyword) verwendet zwei Syntaxformen: Variablenliste und Zuordnung (Zeichenfolgenwörterbuch).

In der Zuordnungssyntax sind alle Schlüssel Variablennamen, und ihre Werte sind Variablenwerte. Um Variablenvorlagen verwenden zu können, müssen Sie die Listensyntax verwenden. Für die Listensyntax müssen Sie angeben, ob Sie eine Variable (name), eine Variablengruppe (group) oder eine Vorlage (template) erwähnen.

Sie können keine Listen- und Zuordnungsvariablen im selben Variablenabschnitt verwenden, aber Sie können , groupund template kombinierenname, wenn Sie Listensyntax verwenden.

Sie können Variablen auf Pipeline-, Phasen- oder Auftragsebene angeben.

variablen: Zeichenfolgenwörterbuch

Definieren Sie Variablen mithilfe von Name-Wert-Paaren.

variables:
  string: string # Name/value pairs

Keine.

Beispiele

Verwenden Sie für einen einfachen Satz hartcodierter Variablen die folgende Zuordnungssyntax:

variables: { string: string }

Variablen, die in verschiedenen Bereichen definiert sind:

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)

Variablen: Variablenliste

Definieren Sie Variablen nach Name, Variablengruppe oder in einer Vorlage.

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

Listentypen

Typ BESCHREIBUNG
variables.name Definieren Sie Variablen mithilfe des Namens und der vollständigen Syntax.
variables.group Referenzvariablen aus einer Variablengruppe.
variables.template Definieren sie Variablen in einer Vorlage.

Beispiele

Um Variablengruppen einzuschließen, wechseln Sie zu dieser Sequenzsyntax:

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

Sie können name/value-Paare und group wiederholen.

Variablen können auch als schreibgeschützt festgelegt werden, um die Sicherheit zu erhöhen.

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

Sie können auch Variablen aus Vorlagen einschließen.

Sequenzsyntax:

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

Weitere Informationen