Déploiements et pipelines
Dans Karizma One, vous ne déployez pas à la main : chaque commit envoyé sur une branche déclenche un pipeline GitLab qui construit le code puis, sur une staging ou sur la production, le déploie. Cette page explique ce qui déclenche un déploiement, comment le suivre et comment mettre à jour l'image Odoo d'une branche.
Le suivi des pipelines (onglet HISTORY) est ouvert à tous les collaborateurs. Envoyer du code dépend de votre rôle : voir Rôles et permissions. La mise à jour de l'image Odoo est réservée aux Super Admin et Admin.
Du commit au déploiement
Chaque projet est un dépôt GitLab. Lorsqu'un commit arrive sur une branche, GitLab lance le pipeline de cette branche. Les étapes affichées dépendent du type de branche :
| Type de branche | Étapes du pipeline | Résultat |
|---|---|---|
| Production | Build, puis Mise en prod | Le code est construit puis déployé sur l'instance de production. |
| Staging | Build, puis Mise en test | Le code est construit puis déployé sur l'environnement de staging. |
| Développement | Build | Le code est seulement construit : une branche de développement n'a pas d'environnement. |
Tout commit qui arrive sur la branche de production est déployé en production dès que son pipeline réussit. Testez vos modifications sur une staging avant de les livrer.
Ce qui déclenche un déploiement
Un pipeline est lancé chaque fois qu'un commit arrive sur la branche, quelle qu'en soit l'origine :
| Origine | Exemple |
|---|---|
| Push Git | Vous poussez depuis votre poste (git push), à partir de la commande copiée avec Clone sur la page projet. |
| Commit du Web IDE | Vous cliquez sur Commit dans le Web IDE : toutes les modifications préparées partent en un seul commit. |
| Fusion d'une merge request | Vous validez une merge request avec Validate & Merge : la branche cible reçoit le commit de fusion. Fusionner dans la branche de production la déploie en production. |
| Sous-module approuvé | Une demande d'ajout ou de retrait de sous-module approuvée par le chef de projet lance un pipeline sur la branche (voir Gérer les sous-modules). |
Le déploiement d'une staging (glisser une branche sur STAGING) exige que la branche ait déjà un pipeline réussi. Voir Déployer une staging.
Les modules de la liste Update List sont mis à jour automatiquement à chaque déploiement, et ceux de la liste Test Suite sont inclus dans les tests automatiques. Pour modifier ces listes, contactez votre interlocuteur Karizma. Pour mettre à jour un module ponctuellement, utilisez Immediate update of modules dans l'onglet CONFIG.
Suivre un pipeline
L'onglet HISTORY de la branche liste ses commits et se met à jour en direct. Chaque commit porte le badge d'état de son pipeline :
| Badge | Signification |
|---|---|
| Created | Le pipeline est créé et n'a pas encore démarré. |
| pending / running | Le pipeline attend ou s'exécute. |
| Success | Toutes les étapes ont réussi : sur une staging ou en production, le code est déployé. |
| Failed | Une étape a échoué : le code n'est pas déployé. |
| canceled / skipped | Le pipeline a été annulé ou ignoré. |
Depuis l'onglet HISTORY, vous pouvez aussi annuler un pipeline en cours, ouvrir le menu Pipeline Jobs pour consulter les journaux de chaque étape et relancer une étape. Le détail se trouve dans Historique et pipelines.
Pendant le premier déploiement d'une staging, la ligne de la branche affiche une roue qui tourne et les autres onglets indiquent Deployment in Progress.
Mettre à jour l'image Odoo d'une branche
La mise à jour applique à la branche le dernier build disponible de la même version d'Odoo : correctifs de sécurité, corrections de bugs et optimisations (liste Updates Include). Pour passer à une version supérieure (de 17 à 18, par exemple), utilisez l'onglet UPGRADE.
- Ouvrez la branche de production ou de staging, puis l'onglet CONFIG.
- Dans le panneau Update Odoo Version, consultez la version actuelle et la date de la dernière mise à jour (Version Status).
- Cliquez sur Update to Latest Build. Le bouton n'est actif que si la dernière mise à jour date d'au moins 7 jours.
- Dans la fenêtre Update Odoo Version, saisissez le Motif (obligatoire), puis cliquez sur Confirm.
La suite dépend de votre rôle :
| Rôle | Ce qui se passe |
|---|---|
| Super Admin | La mise à jour démarre immédiatement (Odoo image update started successfully.). |
| Admin | Une demande d'approbation est créée (Odoo version update request created successfully. Awaiting manager approval.). Pour la faire approuver, contactez votre interlocuteur Karizma. La mise à jour démarre à l'approbation. |
Un message vous informe de la fin de la mise à jour (Branch '…' was updated successfully!) ou de son échec. Chaque mise à jour lancée est inscrite dans le journal d'audit (Update Odoo Image).
Une brève interruption de service est à prévoir pendant la mise à jour. Planifiez-la en dehors des heures de forte activité, et testez d'abord la nouvelle image sur une staging.
Messages de refus
| Message | Cause |
|---|---|
| Updating a development branch is not a permitted action. | Seules la production et les stagings ont une image Odoo. |
| Project '…' is currently offline and cannot receive updates. | Le projet est hors service. |
| An update is already pending or in progress for the '…' branch. | Une mise à jour ou une demande est déjà en cours sur cette branche. |