Partager via


définition des variables

Définissez des variables à l’aide de paires nom/valeur.

Définitions qui font référence à cette définition : pipeline, stages.stage, jobs.job, jobs.deployment

Définitions qui font référence à cette définition : pipeline, jobs.job

Implémentations

Implémentation Description
variables : dictionnaire de chaînes Définissez des variables à l’aide de paires nom/valeur.
variables : liste de variables Définissez des variables par nom, groupe de variables ou dans un modèle.

Remarques

Le variables mot clé utilise deux formes de syntaxe : liste de variables et mappage (dictionnaire de chaînes).

Dans la syntaxe de mappage, toutes les clés sont des noms de variables et leurs valeurs sont des valeurs de variable. Pour utiliser des modèles de variables, vous devez utiliser la syntaxe de liste. La syntaxe de liste vous oblige à spécifier si vous mentionnez une variable (name), un groupe de variables (group) ou un modèle (template).

Vous ne pouvez pas utiliser les variables de liste et de mappage dans la même section variables, mais vous pouvez combiner name, groupet template lors de l’utilisation de la syntaxe de liste.

Vous pouvez spécifier des variables au niveau du pipeline, de la phase ou du travail.

variables : dictionnaire de chaînes

Définissez des variables à l’aide de paires nom/valeur.

variables:
  string: string # Name/value pairs

Aucun.

Exemples

Pour un ensemble simple de variables codées en dur, utilisez cette syntaxe de mappage :

variables: { string: string }

Variables définies dans différentes étendues :

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 : liste de variables

Définissez des variables par nom, groupe de variables ou dans un modèle.

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

Types de liste

Type Description
variables.name Définissez des variables à l’aide du nom et de la syntaxe complète.
variables.group Référencer des variables à partir d’un groupe de variables.
variables.template Définissez des variables dans un modèle.

Exemples

Pour inclure des groupes de variables, basculez vers cette syntaxe de séquence :

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

Vous pouvez répéter name/value des paires et group.

Les variables peuvent également être définies en lecture seule pour améliorer la sécurité.

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

Vous pouvez également inclure des variables à partir de modèles.

Syntaxe de séquence :

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

Voir aussi