Aller au contenu principal

Ajouter un sous-module Git

Utilisez un sous-module Git lorsque vous souhaitez inclure un dépôt externe — comme un module communautaire OCA ou une bibliothèque interne partagée — dans votre déploiement Skysize.

Skysize initialise automatiquement tous les sous-modules à chaque déploiement. Une fois le sous-module dans votre dépôt, aucune action manuelle n'est nécessaire côté plateforme, mis à part la configuration du chemin des modules.

attention

Skysize ne prend en charge que les dépôts de sous-modules publics. Les dépôts privés ne sont pas supportés pour le moment.

Ajouter un sous-module via le terminal​

Dans votre clone local du dépôt de projet, exécutez :

git submodule add https://github.com/OCA/web.git addons/oca_web
git add .gitmodules addons/oca_web
git commit -m "Ajout du sous-module OCA web"
git push

Cela crée un fichier .gitmodules et ajoute le dépôt externe épinglé à un commit spécifique à addons/oca_web.

Ajouter un sous-module via l'interface web GitHub​

Si vous n'avez pas accès à un terminal, vous pouvez créer la configuration du sous-module manuellement :

  1. Dans votre dépôt sur GitHub, cliquez sur Add file → Create new file.

  2. Nommez le fichier .gitmodules.

  3. Ajoutez le contenu suivant en adaptant le chemin et l'URL :

    [submodule "addons/oca_web"]
        path = addons/oca_web
        url = https://github.com/OCA/web.git

  4. Committez le fichier.

  5. Créez le répertoire de référence : cliquez sur Add file → Create new file et nommez le fichier addons/oca_web/.gitkeep, puis committez.

remarque

L'interface web GitHub offre un support limité pour les sous-modules. Pour toute configuration au-delà d'un sous-module simple, l'approche en ligne de commande est fortement recommandée.

Configurer le chemin des modules​

Comme le sous-module se trouve dans un sous-répertoire, vous devez indiquer à Skysize où trouver les modules :

  1. Accédez à votre projet et ouvrez l'onglet Branches.

  2. Cliquez sur la branche pour ouvrir ses paramètres.

  3. Dans le champ Chemin des modules, entrez le chemin vers le répertoire du sous-module :

    /addons/oca_web

    Pour plusieurs sous-modules, séparez-les par des virgules :

    /addons/oca_web,/addons/oca_mail

  4. Cliquez sur Enregistrer.

Le prochain déploiement récupérera le nouveau chemin et rendra les modules disponibles.

Installer le module dans Odoo​

Les modules des sous-modules sont disponibles sur le serveur mais ne sont pas installés automatiquement.

  1. Ouvrez votre instance Odoo.
  2. Activez le mode développeur : Paramètres → Activer le mode développeur.
  3. Accédez à Applications, recherchez votre module et cliquez sur Installer.

Mettre à jour un sous-module vers une version plus récente​

Pour récupérer une version plus récente du sous-module :

cd addons/oca_web
git pull origin main
cd ../..
git add addons/oca_web
git commit -m "Mise à jour du sous-module OCA web"
git push

Skysize déploiera le sous-module mis à jour lors du prochain build.