MonTour dans un conteneur : le projet et la méthode

Le projet : MonTour, mais cette fois en conteneurs

MonTour est une file d’attente virtuelle par QR code : le commerçant affiche une affiche, le client scanne, reçoit un numéro et suit sa place en direct. Dans la formation Coder avec l’IA, l’application était déployée sur Vercel. Ici, vous reprenez la main sur toute la chaîne :

1. Une image Docker de MonTour, légère (moins de 200 Mo) et sans secret.
2. Un environnement local lancé avec docker compose up : application, base et outils, identiques pour toute l’équipe.
3. Un pipeline GitLab CI qui construit l’image, lance les tests dans des conteneurs, la scanne et la publie dans le registre.
4. Un VPS où Caddy sert MonTour en HTTPS, mis à jour à chaque merge sur main, avec un retour arrière en une commande.

Pourquoi Docker pour une application comme MonTour

• « Ça marche sur ma machine » disparaît : la même image tourne sur votre poste, dans la CI et en production.
• Vous ne dépendez plus d’un hébergeur : un VPS à quelques euros suffit, et vous pouvez changer de fournisseur en une journée.
• La sécurité devient vérifiable : ce qui est dans l’image est listé (SBOM), scanné et versionné.
• Le retour arrière est trivial : chaque version est une image taguée ; revenir en arrière, c’est relancer la précédente.

La boucle de chaque chapitre

1. Objectif : une phrase, un résultat visible.
2. Test : la commande qui prouve que c’est fait (docker run, curl, un healthcheck vert).
3. Prompt : une demande précise à l’IA, avec le contexte du projet et un point de départ (tag Git).
4. Relire : chaque ligne du Dockerfile ou du fichier Compose, avec la grille du chapitre.
5. Commit : un petit pas historisé, puis un tag dkNN en fin de chapitre.
6. Pipeline vert : à partir du module 3, GitLab CI valide chaque push.

git clone https://gitlab.com/<votre-groupe>/montour.git
cd montour
git switch -c formation-docker docker-start
npm ci && npm run build   # doit réussir avant de conteneuriser quoi que ce soit

Ce que l’IA fait, et ce que vous faites

• L’IA propose : un Dockerfile, un fichier Compose, un job de pipeline, une commande de diagnostic.
• Vous décidez : l’image de base, ce qui entre dans l’image, les ports exposés, les droits du conteneur.
• Les tests tranchent : une image qui ne démarre pas, qui tourne en root ou qui contient un secret ne passe pas.

Les règles du jeu

• Un chapitre = une branche courte, un ou plusieurs commits, un tag dkNN à la fin.
• Aucune image n’est poussée à la main en production : seul le pipeline publie.
• Chaque Dockerfile est relu avec la grille avant le commit.
• Chaque chapitre contient une partie à faire sans IA, pour que vous sachiez lire et corriger ce qui est généré.

Le prompt reproductible

Même point de départ, même contexte, même résultat : partez du tag indiqué et collez ce prompt tel quel.

Point de départ : tag docker-start du dépôt MonTour (Next.js App Router + Supabase).
Rôle : tu es mon binôme DevOps pour la formation Docker.
Tâche : lis package.json, next.config.* et .env.example, puis liste en 10 lignes
maximum ce qu'il faudra pour conteneuriser l'application :
version de Node, commande de build, port, variables publiques (NEXT_PUBLIC_*)
et variables serveur.
Contraintes : ne crée ni ne modifie aucun fichier. Ne recopie aucune valeur
de secret, seulement les noms de variables.

Qualité et sécurité : ce que vous vérifiez

• Le build fonctionne sans Docker : on ne conteneurise jamais une application qui ne se construit pas.
• La liste des variables est complète et séparée en deux : publiques (gravées au build) et serveur (fournies au démarrage).
• Sans IA : retrouvez vous-même la version de Node exigée (champ engines ou fichier .nvmrc) et comparez avec la réponse de l’assistant.

Vérifier

• ☐ Le dépôt est cloné et la branche formation-docker part du tag docker-start.
• ☐ npm run build réussit sans Docker.
• ☐ Vous avez la liste des variables publiques et serveur de MonTour.
• ☐ Vous savez expliquer en une phrase le rôle de l’image, du pipeline, du registre et du VPS.

Pour aller plus loin

• Chapitre suivant : installer Docker et vérifier son poste
• MonTour et la méthode, dans la formation Coder avec l’IA