Concepts clés
Cette page définit les notions que vous retrouverez dans toute la documentation. Lisez-la une fois avant d'aller plus loin.
Vue d'ensemble
Projet
Un projet correspond à une plateforme Odoo. Il regroupe :
- un dépôt Git hébergé sur GitLab ;
- une branche de production et son instance Odoo, hébergées chez le fournisseur cloud et dans la région choisis à la commande ;
- un sous-domaine Karizma (
https://<projet>.karizma.one) et, si vous le souhaitez, vos propres domaines ; - des collaborateurs, des paramètres et des services ;
- un abonnement avec une date d'expiration. Quand elle est dépassée, le projet est marqué Expired et la plupart des actions sont désactivées.
Le nom du projet est en lettres minuscules et chiffres ; il apparaît dans les adresses (/project/demo-erp) et dans le dépôt GitLab.
Branche et environnement
Chaque branche Git du projet a une étape (stage) qui détermine son rôle et ce qu'elle fait tourner. Dans la barre latérale de la page projet, les branches sont regroupées en sections PRODUCTION, STAGING, MIGRATION et DEVELOPMENT.
| Étape | À quoi elle sert | Instance Odoo | Onglets disponibles |
|---|---|---|---|
| prod | L'environnement de production utilisé par vos équipes. Une seule par projet, créée avec le projet et nommée d'après la version d'Odoo (par exemple 17.0). | Oui | HISTORY, SHELL, LOGS, MONITORING, BACKUP, SQL INSIGHTS, UPGRADE, CONFIG |
| staging | Un environnement de test déployé à partir d'une branche, pour valider les évolutions avant la production. Leur nombre est limité par votre offre. | Oui | HISTORY, SHELL, LOGS, MONITORING, BACKUP, SQL INSIGHTS, MCP, CONFIG (et UPGRADE si la branche vise une version d'Odoo plus récente) |
| dev | Une branche de développement : du code dans Git, sans environnement en marche. | Non | HISTORY, CONFIG |
| migration | Une branche créée par la mise à niveau vers une version d'Odoo plus récente. Elle peut ensuite être promue en staging pour être testée. | Non | HISTORY, CONFIG |
Certains onglets ne s'affichent ou ne s'activent que pour certains rôles. Le cycle de vie d'une branche (déployer en staging, détruire un staging, fusionner en production) est décrit dans Branches et environnements.
Version d'Odoo
Chaque projet a une version d'Odoo (par exemple 17.0), affichée sur sa carte et sur chaque branche. Les nouvelles branches de développement reprennent cette version. Une branche de migration ou un staging issu d'une migration peut viser une version plus récente ; on ne peut pas déployer en staging une branche d'une version plus ancienne que celle du projet. Pour changer de version, voir Mise à niveau.
Dépôt Git (GitLab)
Le code de chaque projet (vos modules Odoo) est stocké dans un dépôt GitLab : https://gitlab.com/odoo-kzm/projet-client/<projet>. Vous pouvez y travailler :
- dans le navigateur, avec le Web IDE ;
- sur votre poste, avec la commande
git cloneque le bouton Clone copie pour vous.
Certains collaborateurs peuvent aussi être invités directement sur le dépôt GitLab, avec un niveau d'accès qui découle de leur rôle sur le projet.
Pipeline et déploiement
Chaque commit poussé sur une branche lance un pipeline GitLab CI. Son avancement s'affiche dans l'onglet HISTORY de la branche, avec les étapes :
| Étape affichée | Branches concernées |
|---|---|
| Build | Toutes les branches. |
| Mise en test | Branches de staging. |
| Mise en prod | Branche de production. |
Une branche ne peut être déployée en staging que si elle a un pipeline réussi. Le passage en production se fait par une merge request de la branche de staging vers la production. Voir aussi Déploiements.
Collaborateur et rôle
Un collaborateur est un utilisateur Karizma One ajouté à un projet. Il a un rôle par projet : la même personne peut être Admin sur un projet et Tester sur un autre.
| Rôle | En résumé |
|---|---|
| Super Admin | Tous les droits du projet, y compris le shell des instances. |
| Admin | Gère le projet : paramètres, collaborateurs, sauvegardes, merge requests, services. |
| Developer | Crée des branches, déploie des stagings et modifie le code dans le Web IDE. |
| Tester | Consulte le projet et ses branches ; lecture seule dans le Web IDE. |
Le détail des droits est dans Rôles et permissions. Pour ajouter un collaborateur, contactez votre interlocuteur Karizma.
Service
Un service est une fonctionnalité complémentaire que vous activez projet par projet : WhatsApp, SMTP, messagerie, CDN et équilibreur de charge, facturation électronique, paiement, ressources supplémentaires… Les services se gèrent dans Settings › Integrations › Services. Selon le service, il faut l'acheter, puis l'activer ; l'activation installe le module correspondant sur l'instance Odoo de production. Voir Services.
Crédits
Les crédits forment la réserve de consommation d'un projet (Credit Pool, en haut de la page Services). Ils sont décomptés quand un service est utilisé, par exemple pour l'envoi de messages, et servent aussi à payer l'assistant IA du Web IDE. La page Services affiche le solde disponible, la consommation de la période et l'historique des mouvements. Voir Services.