Partager via

définition des variables

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

Définitions qui référencent cette définition : de pipeline, stage, jobs.job, jobs.deployment

Implémentations

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

Remarques

Le mot clé variables utilise deux formes de syntaxe : la liste des variables et le 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 variables. 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 de 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 l’étape 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 à 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 : 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 listes

Catégorie Descriptif
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 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

  • Last updated on