GitLab - 7.31 Variables prédéfinies GitLab CI/CD

GitLab fournit des variables prédéfinies, disponibles dans chaque pipeline sans configuration. Elles donnent des informations sur le pipeline, comme le message de validation ou le nom du job. Cette leçon montre comment les afficher.

Des informations prêtes à l'emploi

Les variables prédéfinies s'utilisent par leur nom. Elles fournissent des détails utiles, comme le nom de l'utilisateur, le nom de la branche ou l'identifiant du pipeline.

La documentation GitLab liste toutes ces variables, avec les versions minimales de GitLab et de Runner compatibles.

Afficher le message et le nom du job

La variable du message de validation contient le texte du commit. La variable du nom du job contient le nom de la tâche en cours.

Dans cet exemple, un job nommé demo affiche ces deux valeurs. Le message vient du commit, et le nom vient du job.

GitLab lit le fichier, puis remplace chaque variable par sa valeur au moment de l'exécution. Le fichier reste donc identique d'un commit à l'autre.

demo:
  script:
    - echo $CI_COMMIT_MESSAGE
    - echo $CI_JOB_NAME

Utiliser les variables dans un pipeline

GitLab remplace chaque variable par sa valeur réelle au moment de l'exécution. Le code du fichier reste donc générique.

La variable du hash court du commit donne les huit premiers caractères du numéro de révision. Elle peut servir à étiqueter une image Docker.

Les variables personnalisées seront présentées dans la leçon suivante.

En résumé

Les variables prédéfinies donnent des informations sur le pipeline sans configuration. Le message de validation et le nom du job s'affichent avec echo. La documentation GitLab liste toutes les variables disponibles.

Points clés

• Les variables prédéfinies sont disponibles dans chaque pipeline.
• Une variable s'utilise avec le signe dollar devant son nom.
• Le message de validation est disponible dans une variable.
• Le nom du job est aussi disponible dans une variable.
• La liste complète se trouve dans la documentation GitLab.

Questions fréquentes

Comment utiliser une variable prédéfinie ?

Écrivez le signe dollar suivi du nom de la variable, par exemple dans une commande du script.

Dois-je configurer ces variables ?

Non. Elles sont disponibles dans chaque pipeline sans configuration supplémentaire.

À quoi sert le hash court du commit ?

Il donne les huit premiers caractères du numéro de révision. Il peut servir à étiqueter une image Docker.