Gitlab - 3.3.4 Rédaction du premier pipeline

Apprenons maintenant à écrire un premier pipeline pour utiliser la fonctionnalité GitLab CI/CD. Il y a deux prérequis : votre code applicatif doit déjà être hébergé dans un dépôt Git (c'est notre cas), et vous devez créer un fichier YAML qui décrit le pipeline à exécuter à chaque modification du code. Ce fichier définit la structure et l'ordre des jobs, les scripts à lancer, les dépendances, les tests à exécuter avant le déploiement, l'emplacement de déploiement, etc.

Créer le fichier .gitlab-ci.yml

Le fichier à créer s'appelle .gitlab-ci.yml et doit être placé à la racine du dépôt. Vous avez deux options : le créer localement et le pousser via Git (comme nous l'avons fait pour hello.py), ou le créer directement depuis l'interface GitLab. Nous choisissons ici la seconde option, plus simple pour découvrir l'outil. Sur le tableau de bord du projet, sélectionnez d'abord la branche dev1, cliquez sur « Nouveau fichier » et saisissez précisément .gitlab-ci.yml — ce nom est obligatoire car GitLab ne cherche que ce fichier pour trouver vos pipelines CI/CD.

Toute configuration de pipeline commence par la définition d'un job. C'est obligatoire. On commence par donner un nom au job, puis on peut éventuellement préciser à quel stage il appartient avec le mot-clé stage. Si vous ne spécifiez pas de stage, GitLab assigne par défaut test. La clause script est obligatoire et contient la ou les commandes à exécuter :

job_run_code:
  stage: test
  script:
    - python hello.py
  • Nom de fichier obligatoire : .gitlab-ci.yml à la racine
  • Un job au minimum, avec sa clause script obligatoire
  • Clause stage facultative (par défaut test)
  • Plusieurs commandes possibles dans le bloc script
  • Validation = déclenchement automatique du pipeline

Notre pipeline est défini. On valide les modifications avec la branche cible dev1. Dès que GitLab détecte la présence d'un fichier .gitlab-ci.yml dans le dépôt, il déclenche automatiquement le pipeline. Dans la section CI/CD, on voit le statut « en cours d'exécution » sans avoir eu à le lancer manuellement.

La page CI/CD liste tous vos pipelines, leur statut, l'ID, la branche, l'auteur et la durée d'exécution. Une barre de recherche permet de filtrer par nom de branche, statut ou tag. En cliquant sur un pipeline, vous obtenez le détail avec une représentation graphique des jobs et stages. Comme notre pipeline n'a qu'un seul job, il n'y a qu'un seul bloc affiché ; à mesure que vous ajouterez des jobs, ils apparaîtront tous dans l'ordre défini dans votre YAML.

En résumé

Cette leçon enseigne comment rédiger un premier pipeline GitLab CI/CD en créant un fichier .gitlab-ci.yml. Elle explique les prérequis (code sauvegardé dans un référentiel Git), les deux méthodes pour créer le fichier (localement ou via l'interface GitLab), et la structure de base d'un pipeline (définition des tâches, nom du travail, mot-clé stage, clause script obligatoire). Une fois validée et commitée, GitLab détecte automatiquement le fichier et déclenche l'exécution du pipeline, visualisable via la page CI/CD avec graphiques et filtres.

Points clés

  • Le fichier .gitlab-ci.yml définit la structure complète du pipeline avec instructions étape par étape (scripts à exécuter, dépendances, tests, déploiement).
  • Deux options de création : localement puis transfert via Git, ou directement dans l'interface GitLab (tableau de bord → nouveau fichier).
  • Configuration minimale : donner un nom au travail (job), spécifier optionnellement le stage, puis écrire la clause script obligatoire.
  • GitLab déclenche automatiquement le pipeline dès qu'il détecte le fichier .gitlab-ci.yml après un commit, sans action manuelle.
  • La page CI/CD et le graphique du pipeline permettent de visualiser le statut, l'ordre des travaux et leur exécution en temps réel.

Questions fréquentes

Quels sont les prérequis pour créer un pipeline GitLab CI/CD ?

Vous avez besoin que le code de l'application soit sauvegardé dans un référentiel Git et de créer un fichier .gitlab-ci.yml qui définit la structure et l'ordre des travaux du pipeline.

Comment créer le fichier .gitlab-ci.yml ?

Deux méthodes : créer le fichier localement et le transférer via commandes Git (comme vu précédemment), ou créer le fichier directement depuis l'interface GitLab (tableau de bord du projet → nouvelle branche → nouveau fichier).

Qu'est-ce qui se passe après la validation du fichier .gitlab-ci.yml ?

Une fois le fichier validé et commité, GitLab le détecte automatiquement et déclenche l'exécution du pipeline sans intervention manuelle. Vous pouvez suivre son statut et son avancement dans la section CI/CD.