Saltar al contenido principal

Agregar un Submódulo de Git

Usa un submódulo de Git cuando desees incluir un repositorio externo — como un módulo de la comunidad OCA o una librería compartida privada — como parte de tu despliegue en Skysize.

Skysize inicializa automáticamente todos los submódulos en cada despliegue, por lo que una vez que el submódulo está en tu repositorio, no se necesitan pasos manuales en el lado de la plataforma más allá de configurar la ruta de addons.

atención

Skysize solo admite repositorios de submódulos públicos. Los repositorios de submódulos privados no son compatibles en este momento.

Agregar un submódulo a través de la terminal​

En tu clon local del repositorio de tu proyecto, ejecuta:

git submodule add https://github.com/OCA/web.git addons/oca_web
git add .gitmodules addons/oca_web
git commit -m "Add OCA web submodule"
git push

Esto crea un archivo .gitmodules y agrega el repositorio externo anclado a un commit específico en addons/oca_web.

Agregar un submódulo a través de la interfaz web de GitHub​

Si no tienes acceso a una terminal, puedes crear la configuración del submódulo manualmente:

  1. En tu repositorio en GitHub, haz clic en Add file → Create new file (Agregar archivo → Crear nuevo archivo).

  2. Nombra el archivo como .gitmodules.

  3. Agrega el siguiente contenido, ajustando la ruta y la URL:

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

  4. Haz un commit del archivo.

  5. Crea el marcador de posición del directorio: haz clic en Add file → Create new file y nómbralo addons/oca_web/.gitkeep, luego haz el commit.

nota

La interfaz web de GitHub tiene un soporte limitado para submódulos. Para cualquier cosa que vaya más allá de un submódulo simple, se recomienda encarecidamente el enfoque de la terminal.

Configurar la ruta de addons​

Debido a que el submódulo está en un subdirectorio, debes decirle a Skysize dónde encontrar los módulos:

  1. Ve a tu proyecto y abre la pestaña Branches (Ramas).

  2. Haz clic en la rama para abrir su configuración.

  3. En Custom Addons Path (Ruta de Addons Personalizados), ingresa la ruta al directorio del submódulo:

    /addons/oca_web

    Para múltiples submódulos, sepáralos con comas:

    /addons/oca_web,/addons/oca_mail

  4. Haz clic en Save (Guardar).

El próximo despliegue recogerá la nueva ruta y pondrá los módulos a disposición.

Instalar el módulo en Odoo​

Los módulos de submódulos están disponibles en el servidor pero no se instalan automáticamente.

  1. Abre tu instancia de Odoo.
  2. Activa el modo desarrollador: Settings → Activate the developer mode (Ajustes → Activar el modo desarrollador).
  3. Ve a Apps, busca tu módulo y haz clic en Install (Instalar).

Actualizar un submódulo a una versión más reciente​

Para traer una versión más reciente del submódulo:

cd addons/oca_web
git pull origin main
cd ../..
git add addons/oca_web
git commit -m "Update OCA web submodule"
git push

Skysize desplegará el submódulo actualizado en la próxima construcción.