Déploiements
Déployer, c'est signer un commit exact. L'agent vérifie, construit sur le serveur et dit ce qu'il a fait dans un résultat signé. Deux façons, selon ce qui tourne déjà chez vous.
Deux façons de déployer
Service app | Projet docker compose existant | |
|---|---|---|
| Pour | un service que Kantama met en ligne | une production qui tourne déjà avec docker compose, derrière son propre frontal |
| Ce que l'on signe | le commit et le service | le commit, les services à reconstruire et les gestes qui suivent |
| Ce que fait l'agent | construit l'image, démarre un conteneur à côté, bascule le trafic une fois sain | place le clone sur le commit, reconstruit les services choisis, attend qu'ils soient sains |
| Revenir en arrière | rebascule sur la version précédente, déjà construite | replace le clone sur un commit déjà déployé et reconstruit |
Dans les deux cas, une seule passkey suffit : ce qui est signé est le commit exact, jamais une branche, et revenir en arrière doit rester immédiat.
Un projet docker compose
Votre production tourne déjà : un clone du dépôt sur le serveur, des fichiers compose, un fichier de variables, un frontal. Kantama ne change rien à cette pile. Déclarez où est le clone et ce qui s'y reconstruit :
source: path: /opt/cas-market # le clone de travail, déjà là branch: develop after_deploy: [nginx.reload] services: - name: api_core kind: compose compose: [/opt/cas-market/docker-compose.yml, /opt/cas-market/docker-compose.prod.yml] env_file: /opt/cas-market/.env.prod build: true # se reconstruit au déploiement health: {docker: true} # sonde : le healthcheck Docker - name: nginx kind: compose compose: [/opt/cas-market/docker-compose.yml, /opt/cas-market/docker-compose.prod.yml] env_file: /opt/cas-market/.env.prod actions: - id: nginx.reload label: Recharger nginx level: single run: {service: nginx, command: [nginx, -s, reload]}
Les fichiers compose et le fichier de variables sont ceux que vous passez à la main : l'agent les donne à Docker Compose, dans le même ordre, et ne lit jamais les variables. Le geste après déploiement est une action déclarée comme les autres.
Ce que fait l'agent
- il vérifie que le clone est sur la branche déclarée et qu'aucun fichier suivi n'a été modifié à la main : sinon il refuse, et rien n'est touché ;
- il récupère la branche, puis vérifie que le commit signé en fait partie ;
- il place le clone sur ce commit en gardant la branche : un
git pullà la main reste possible ensuite ; - il reconstruit seulement les services signés, avec vos fichiers compose et votre fichier de variables ;
- il attend que chacun soit sain d'après son healthcheck Docker (ou simplement démarré s'il n'en a pas), avec un délai borné ;
- il lance les gestes après déploiement, par exemple recharger nginx ;
- il enregistre le déploiement : commit, services, durée, issue.
Commits proposés
L'agent récupère la branche toutes les 5 minutes (réglable) et annonce ses derniers commits : titre, auteur, date. La page Déploiements du projet les propose, avec les services à reconstruire, tous cochés par défaut ; Actualiser demande une récupération tout de suite.
Le serveur central ne propose que les commits annoncés par l'agent : il n'invente jamais un commit, et l'agent revérifie de toute façon.
Revenir en arrière
Si un déploiement échoue après la reconstruction (un service qui ne devient pas sain, un geste en échec), l'agent ne revient pas en arrière seul : il le dit, avec le commit en place et celui d'avant. La console propose alors Revenir à ce commit : un ordre signé, une passkey, vers un commit que l'agent a déjà déployé.
Revenir en arrière est un geste de secours : un gel ou une plage horaire bloque un déploiement, jamais un retour.
Santé Docker
Quand l'API n'est pas exposée par votre frontal (un /health interne), déclarez health: {docker: true} : l'état de santé que Docker tient déjà sert de sonde. Un conteneur unhealthy ou arrêté est un échec, avec les mêmes alertes et le même historique qu'une sonde HTTP.
Avec le reste
- Une procédure peut déployer dans une étape, et un ordre planifié déployer à l'heure signée.
- Après un déploiement signé, la dérive reprend l'état des services reconstruits : rien n'est signalé à tort ; une modification à la main reste visible.
- Un agent qui ne connaît pas encore ce déploiement refuse le fichier et l'ordre plutôt que d'en exécuter une partie.
Les propositions de modification de la documentation ne sont pas encore ouvertes au public.