GitLab - 7.32 Créer des variables CI/CD personnalisées

Les variables personnalisées vous permettent de nommer une valeur que vous utilisez plusieurs fois. Vous pouvez les déclarer dans le fichier de pipeline ou dans les paramètres du projet. Cette leçon montre la première méthode et ses règles de portée.

Déclarer des variables dans le fichier

Pour déclarer des variables, utilisez le mot-clé variables. Chaque ligne associe un nom à une valeur.

Ces variables sont globales : elles s'appliquent à tous les jobs du pipeline.

Les noms comme NOM ou MESSAGE sont choisis par vous. Utilisez des noms clairs, pour que chaque job reste lisible.

variables:
  NOM: "John"
  MESSAGE: "comment vas-tu"

affichage:
  script:
    - echo "Bonjour $NOM, $MESSAGE"

Remplacer une variable dans un job

Un job peut redéfinir une variable avec le même nom. La nouvelle valeur remplace la valeur globale, pour ce job uniquement.

Les autres jobs gardent la valeur globale. C'est le même principe que dans la plupart des langages de programmation.

Dans l'exemple, le nom est remplacé dans un seul job, alors que le message garde la valeur globale.

Ne pas exposer les secrets

Les variables écrites dans le fichier sont visibles par toute personne qui y a accès. Pour un mot de passe ou un jeton, utilisez plutôt les paramètres du projet, présentés dans la leçon suivante.

En résumé

Les variables personnalisées se déclarent avec le mot-clé variables. Elles sont globales, et un job peut les remplacer localement. Les informations sensibles doivent passer par les paramètres du projet.

Points clés

• Le mot-clé variables déclare les variables personnalisées.
• Une variable globale s'applique à tous les jobs du pipeline.
• Un job peut remplacer une variable pour lui seul.
• Les valeurs écrites dans le fichier sont visibles par qui y a accès.
• Les mots de passe et jetons se placent dans les paramètres du projet.

Questions fréquentes

Où déclarer une variable personnalisée ?

Dans le fichier de pipeline, avec le mot-clé variables, ou dans les paramètres du projet.

Que se passe-t-il si un job utilise le même nom de variable ?

La nouvelle valeur remplace la valeur globale pour ce job uniquement. Les autres jobs gardent leur valeur.

Quand utiliser le fichier plutôt que les paramètres ?

Pour des valeurs réutilisables et non sensibles, comme une URL. Les informations sensibles doivent aller dans les paramètres du projet.