Lab 08 — Déclencher un pipeline

Dans un projet réel, un pipeline ne doit pas dépendre uniquement d’un git push. Vous avez souvent besoin de lancer des tests chaque nuit, de déclencher un rebuild depuis un outil externe, ou de relancer un pipeline à la demande après une alerte monitoring. Ce lab vous montre comment faire avec les déclencheurs GitLab natifs.

Ce que vous allez apprendre

Déclencher un pipeline via un schedule GitLab
Déclencher un pipeline via API et trigger token
Comprendre les valeurs de $CI_PIPELINE_SOURCE
Écrire des rules spécifiques au type de déclenchement

Dans quel contexte ?

Les équipes DevOps utilisent plusieurs sources de déclenchement selon le besoin :

push et merge request pour la validation continue
schedule pour les tests de régression nocturnes
API/trigger pour orchestrer des pipelines depuis d’autres systèmes

Sans cette maîtrise, vous limitez l’automatisation et vous ratez des scénarios importants.

Prérequis

Lab 07 — Valider un pipeline terminé
Avoir lu Déclencheurs de pipelines

Point de départ

Basculez sur la branche du lab
Fenêtre de terminal
```
cd pipeline-craft
git checkout starter/lab-08
```
Ouvrez le .gitlab-ci.yml

Vous allez ajouter des règles basées sur la source du pipeline.

Le problème

Actuellement, tout est piloté par les pushes. Impossible de lancer un run planifié ou externe avec des comportements différents. Vous allez créer un pipeline plus intelligent, capable de distinguer :

push
schedule
trigger
api

L’exercice

Étape 1 — Ajouter des règles basées sur la source

Ajoutez un job dédié aux runs planifiés

nightly-regression:
  stage: test
  image: python:3.12-slim
  before_script:
    - pip install -r requirements-dev.txt
  script:
    - pytest -v
  rules:
    - if: '$CI_PIPELINE_SOURCE == "schedule"'

Ajoutez une règle explicite pour les pipelines API/trigger sur un job existant

Exemple sur pytest :

pytest:
  ...
  rules:
    - if: '$CI_PIPELINE_SOURCE == "push"'
    - if: '$CI_PIPELINE_SOURCE == "merge_request_event"'
    - if: '$CI_PIPELINE_SOURCE == "trigger"'
    - if: '$CI_PIPELINE_SOURCE == "api"'

Étape 2 — Créer un schedule dans GitLab

Allez dans Build > Pipeline schedules
Créez un schedule quotidien
Choisissez la branche cible et l’horaire GitLab évalue le cron en UTC. Si vous programmez 02:00 locale, vérifiez le décalage horaire pour éviter les surprises.

Étape 3 — Déclencher via API avec trigger token

Générez un token dans Settings > CI/CD > Pipeline trigger tokens

Déclenchez depuis votre terminal

curl --request POST \
  --form token="$TRIGGER_TOKEN" \
  --form ref="main" \
  "https://gitlab.com/api/v4/projects/<project_id>/trigger/pipeline"

Vérifiez dans GitLab que la source du pipeline est trigger

Étape 4 — Vérifier la source dans les logs

Ajoutez temporairement une ligne de debug dans un job

script:
  - echo "SOURCE=$CI_PIPELINE_SOURCE"
  - pytest -v

Lancez un pipeline de chaque type et comparez les valeurs

Cette étape vous aide à valider vos règles sans ambiguïté.

Vérification

Un schedule déclenche bien un pipeline
Un trigger API déclenche bien un pipeline
Les jobs s’exécutent selon la valeur de CI_PIPELINE_SOURCE
Vous savez expliquer la différence entre trigger token et personal access token

Pièges fréquents

Le trigger token sert à déclencher un pipeline, pas à accéder à toute l’API GitLab. Le personal access token a un autre usage. Mélanger les deux est une erreur classique.

Autre point : un cron mal calé en UTC donne l’impression que le schedule ne fonctionne pas. Vérifiez toujours le fuseau horaire avant de conclure.

À retenir

Un pipeline GitLab peut être déclenché sans push
$CI_PIPELINE_SOURCE permet d’adapter les jobs au contexte
Schedule et API couvrent des besoins complémentaires
Tester vos règles par source évite les surprises en production

Prochaines étapes

Lab 09 — Publier dans le registry Pousser vos images et packages vers GitLab Registry

Guide : déclencheurs Référence complète des sources de pipeline

Retour au Lab 07 Validation avant push