Prévisualiser sur dev et promouvoir en production

Correspondance des deux environnements avec les branches

Branche	Site	Indexé par les moteurs de recherche
main	https://jenksguo.xyz	oui
dev	https://dev.jenksguo.xyz	non (noindex)

Chaque push sur une branche lance la CI : traduire les entrées modifiées dans toutes les langues, construire, déployer sur le site de cette branche. Les opérations admin écrivent par défaut sur main ; passez --branch dev (CLI) ou "branch": "dev" (REST/MCP) pour préparer sur dev à la place.

1. Faire des modifications sur dev

jenks admin put content/corpus/projects/smart-energy-meter.md smart-energy-meter.md \
  -m "Smart energy meter: add thesis link" --branch dev

Répétez pour autant de modifications que vous le souhaitez. Chaque écriture est un commit sur dev.

2. Attendre le déploiement

jenks admin deploys --branch dev

Attendez que la dernière exécution pour dev réussisse. La traduction ajoute un peu de temps lorsque de nombreuses entrées ont changé.

3. Vérifier l’aperçu

Ouvrez les pages modifiées sur https://dev.jenksguo.xyz et au moins une version traduite, par exemple https://dev.jenksguo.xyz/ja/projects/smart-energy-meter. Posez une question à l’assistant dev qui concerne la modification pour vérifier que le bot l’a prise en compte :

jenks ask "What was Jenks's final-year project?" --api https://dev.jenksguo.xyz

4. Promouvoir

jenks admin promote

Cela fusionne dev dans main et déclenche le déploiement en production. Exécutez à nouveau jenks admin deploys pour suivre la fin, puis vérifiez https://jenksguo.xyz.

Si quelque chose ne va pas

• Avant de promouvoir : corrigez sur dev avec un autre commit, ou annulez la modification dans git.
• Après avoir promu : validez la correction directement sur main, ou corrigez sur dev et promouvez à nouveau. Git conserve chaque version, il est donc toujours possible de restaurer un fichier antérieur.
• Conflit de fusion lors de la promotion : quelqu’un a modifié le même fichier directement sur main. Mettez dev à jour avec main dans git, résolvez, puis promouvez à nouveau.