Sommaire
TOP s’arrête devant sa boutique de barbes à papa. Fraise. Toujours fraise. Il connaît le menu par cœur. Il baisse ses lunettes d’aviateur, réfléchit deux secondes, puis les remonte. « Il nous faut un goût Licorne magique. Avec une petite corne comestible. Sinon, c’est juste du sucre qui se donne un genre. »
L’idée tient sur un carnet. La mettre en vente sans casser les commandes de fraise demande un peu plus de méthode.
Bienvenue dans La Barbe à TOP, notre boutique fictive. Pendant trois épisodes, nous suivrons une nouveauté du laboratoire jusqu’aux premiers clients. Le laboratoire représente le code ; l’usine, la construction de l’application ; les colis, ses versions ; le magasin, le service en fonctionnement. Les illustrations racontent cette analogie. Le logiciel que nous allons réellement manipuler est une petite API de commande, pas une machine à fabriquer du sucre.
Dans ce premier épisode, tu vas comprendre ce que vérifie une CI, pourquoi une PR peut rester bloquée malgré des tests verts et comment identifier la version finalement produite. Un labo sur GitHub permet de provoquer les ratés de TOP.
Le plan de fabrication
- Le laboratoireModifier une recette sans toucher au service en cours.
- L’atelier d’essaiTester la modification et sa combinaison avec le catalogue.
- L’usineConstruire et vérifier une version livrable.
- L’entrepôtConserver précisément le paquet qui pourra partir.
Notre version v1 connaît la fraise. La v2 ajoutera Licorne magique, à 4,5 €, avec une décoration horn. Ces numéros désignent des versions de l’application : v2 sait toujours vendre de la fraise. Ce ne sont pas des numéros de parfum.
Dans le carnet, puis dans Git
TOP ouvre une page de travail : sa branche dev. Il ajoute le parfum au catalogue et enregistre un commit, une étape identifiable dans l’historique. Le push envoie cette étape vers GitHub. Enregistrer localement et envoyer au dépôt sont deux actions distinctes.
Nous utilisons dev pour rendre le trajet facile à suivre. Dans une équipe, des branches courtes par changement peuvent remplir ce rôle. Une branche longue ne protège pas le logiciel par son nom ; ce sont les contrôles, les petites modifications et leur intégration fréquente qui rendent le travail vérifiable.
Le service en boutique utilise encore l’ancienne image. Modifier le carnet ne change donc pas spontanément ce que les clients voient. Cette séparation permettra à TOP de faire plusieurs essais sans facturer ses expériences à la file d’attente.
Du carnet de TOP à Git : le push sur dev déclenche les contrôles ; la PR teste la combinaison avec main avant la vraie fusion.
Premier raté : une licorne à moins 4,50 €
TOP remplit le prix un peu vite : −4,5 €. La boutique devrait maintenant payer les clients qui commandent une licorne. Le marketing adore. La comptabilité, beaucoup moins.
Le client voit 4,5 €. Le code conserve les montants en centimes entiers pour calculer les totaux ; c’est un détail de stockage, pas la façon de présenter le prix au lecteur.
Le test automatique vérifie que ce montant interne est un entier strictement positif. Il échoue. Cette règle métier exprime un comportement attendu, indépendant de la manière dont le code calcule une commande. D’autres tests vérifient le total de deux portions, le refus d’un parfum inconnu et les quantités non valides.
C’est le début de la CI, ou intégration continue : à chaque changement partagé, des contrôles reproductibles cherchent rapidement les problèmes. GitHub Actions fournit ici les machines et l’exécution du workflow. Les tests doivent encore être écrits : le service n’invente pas les règles de notre boutique.
Voici les événements de notre workflow :
on:
push:
branches: [dev, main]
pull_request:
branches: [main]
merge_group:
types: [checks_requested]
Le push sur dev donne un premier retour. La PR vers main vérifie la proposition d’intégration. merge_group couvre aussi une éventuelle file de fusion. Le workflow complet, fourni dans le labo, enchaîne tests, build et démarrage d’une image candidate. Événements GitHub Actions.
TOP remet 4,5 €. Les tests passent. Il pourrait se précipiter vers le bouton de fusion. Heureusement, l’usine a encore son mot à dire.
Deuxième raté : la corne ne rentre pas dans la machine
L’ancien emballage est conçu pour une boule. TOP arrive avec une boule et une corne. La recette est valide, son prix est correct, mais la tête de la nouvelle barbe à papa bute contre l’entrée de la machine.
Dans notre application, cette scène correspond à un problème précis : le catalogue demande une décoration horn, mais la configuration de construction ne connaît que plain. Le build refuse de produire un paquet qu’il ne sait pas représenter.
Tests de recette : OK
Construction : BUILD BLOCKED: unsupported decoration "horn"
Fusion : bloquée si ce contrôle est obligatoire
Tester et construire répondent à deux questions différentes. Les tests de prix peuvent réussir alors qu’une ressource manque, qu’un format n’est pas pris en charge ou que l’assemblage échoue. Dans le labo, le build vérifie la compatibilité du catalogue avec la machine, puis regroupe le serveur et prépare les fichiers exécutables par Bun.
TOP ouvre une pull request, ou PR : une proposition de fusion accompagnée du changement et de ses résultats. Pour une PR fusionnable, le checkout par défaut de notre workflow utilise le résultat de fusion proposé par GitHub. Cela permet de vérifier la combinaison avec main, et pas seulement le travail isolé de TOP. Forcer le checkout sur la tête de dev ferait perdre cette propriété. Checkout de la branche de fusion.
Un conflit Git est encore autre chose : Git n’arrive pas à combiner automatiquement certaines modifications. Il faut le résoudre avant ce parcours de validation. Notre corne, elle, peut parfaitement se fusionner dans les fichiers tout en cassant la construction. Git sait assembler du texte ; il ne sait pas si l’usine accepte les licornes.
TOP ajoute donc le support de la corne à la machine. Nouveau commit, nouveau push, nouveaux contrôles. Le colis sort enfin entier.
Une PR verte doit encore être autorisée à entrer
Les voyants n’empêchent rien à eux seuls. Dans les règles du dépôt, nous exigeons une PR relue, le contrôle Recipe and factory réussi et une combinaison à jour avec main, sans contournement pour l’exercice. Si la branche cible évolue, on actualise et revalide, ou on utilise une file de fusion. Protection des branches.
La revue humaine demande aussi : le nouveau prix est-il voulu ? Le nom est-il compréhensible ? La modification touche-t-elle seulement ce qu’elle annonce ? Un test vérifie une règle programmée. Il ne remplace pas la décision de vendre Licorne magique.
Dans une équipe qui fusionne beaucoup, une merge queue vérifie les changements avec ceux qui les précèdent dans la file. Elle évite de considérer comme actuelle une validation devenue ancienne après d’autres fusions. Notre événement merge_group est prévu pour ce cas ; activer une queue reste un réglage du dépôt. File de fusion GitHub.
Fabriquer le paquet qui partira vraiment
La PR est fusionnée. Le commit final entre dans main et déclenche un nouveau workflow. Il est identifiable séparément : selon la méthode de fusion, son identifiant peut différer de celui testé sur la proposition de PR.
Le pipeline vérifie ce code final. Son job de publication construit une image de conteneur, la démarre, demande sa disponibilité et réalise une commande simple. Il publie ensuite cette même image, sans la reconstruire entre ce contrôle et l’envoi. L’image candidate de PR était une répétition ; le paquet final reçoit son propre contrôle.
C’est un smoke test : un essai court pour détecter un service qui ne démarre pas ou ne répond pas au parcours choisi. Il ne couvre pas toutes les commandes possibles. Le troisième épisode montrera pourquoi cette limite compte.
L’image rejoint GHCR, notre registre. Un tag contenant le commit aide à la retrouver. Son digest, une empreinte de contenu, désigne précisément l’image à déployer. Réutiliser un nom mobile tel que latest ne donne pas la même garantie d’identification. Digests d’images.
TOP colle donc deux informations sur le carton : « fabriqué depuis ce commit » et « contenu identifié par ce digest ». Cela ne prouve pas l’absence de défaut ; cela évite de chercher un défaut dans une version différente.
Le workflow réserve les droits de publication au job exécuté après un push sur main. Les PR disposent de droits de lecture et ne publient pas d’image finale. Dans une chaîne maintenue, on contrôle aussi les actions utilisées, les dépendances et l’image de base ; le labo privilégie des fichiers courts et des versions lisibles. Publication d’images avec GitHub Actions.
L’usine devient le build : construire, démarrer, vérifier, puis pousser exactement la même image dans GHCR.
Où se cache le CD ?
La livraison continue consiste à conserver une version prête à être livrée ; une validation peut encore décider du départ en production. Le déploiement continu pousse plus loin l’automatisation : un changement admissible est mis en production sans cette décision manuelle à chaque livraison.
Notre premier épisode produit un paquet vérifié. Il prépare la livraison, mais le workflow ne change pas encore la boutique. Le CD sera concret lorsque nous relierons ce paquet à un environnement et à ses contrôles. Intégration et livraison continues.
À toi de bloquer la corne
Clone le dépôt public La Barbe à TOP et entre dans son dossier.
git clone https://github.com/doudidas/la-barbe-a-top.git
cd la-barbe-a-top
Il utilise Bun 1.4.0, sans dépendances à installer. Les commandes scenario remplacent ses deux fichiers de configuration ; fais l’expérience dans cette copie dédiée.
D’abord, provoque l’erreur de prix :
bun run scenario red-test
bun run test
Le processus doit sortir en erreur et nommer le prix invalide. Ensuite, prépare une recette correcte pour une machine incompatible :
bun run scenario broken-build
bun run test
bun run build
Cette fois, le test passe, puis le build refuse horn. Nous avons reproduit deux portes différentes du parcours. Enfin, adapte la machine :
bun run scenario v2
bun run test
bun run build
bun run start
Ouvre http://localhost:8080/. Le JSON affiche v2, Fraise et Licorne magique. Dans un autre terminal, une commande permet de vérifier le prix réel :
curl -i -H 'Content-Type: application/json' \
-d '{"flavour":"unicorn","quantity":2}' \
http://localhost:8080/orders
Résultat attendu : HTTP 200 et totalEUR: "9.00 €". Il s’agit d’un devis fictif ; aucune commande n’est enregistrée et aucun paiement n’est effectué.
Pour observer la PR bloquée, crée ton propre fork du dépôt public, qui contient déjà le dossier .github. Le README explique la protection de main, les droits GHCR et les événements. Exécuter les scripts localement ne crée pas ces règles GitHub.
TOP retourne en boutique. Le menu affiche toujours Fraise.
« Attends. On a une recette, une usine, un carton… Qui prévient le magasin ? »
C’est le départ du deuxième épisode : GitOps et rolling update. L’image existe ; il reste à la mettre en service.
Reçois le prochain par email
Les nouveaux articles et séries, envoyés à leur publication. Aucun autre courrier.


