Actualizado el 16 de noviembre de 2026
La respuesta corta
Desplegar Odoo con Git significa que un git push es la única forma en que el código llega a tu Odoo. El push prepara el código, actualiza los módulos correctos, reinicia Odoo y comprueba que volvió. Para que sea seguro, un push tiene que hacer siete cosas, en orden. La mayoría de los pipelines caseros hacen tres.
Qué significa desplegar con Git en Odoo
Tu repositorio Git es la única forma en que el código llega a un servidor. Haces push de una rama. Ese push prepara el código, actualiza los módulos de Odoo que lo necesitan, reinicia Odoo y comprueba que funciona. Cada rama es su propio Odoo en marcha. Así, desarrollo, staging y producción son ramas que fusionas entre sí, no servidores a los que copias archivos. Nadie entra por SSH para desplegar.
Para la mayoría de las aplicaciones web, esto ya está resuelto. Para Odoo es más difícil, por la base de datos.
Por qué Odoo es más difícil de desplegar que la mayoría de las aplicaciones
En la mayoría de las aplicaciones web, desplegar es solo código. Traes el código nuevo y reinicias. Si algo falla, vuelves al código anterior y reinicias.
Odoo es código más una base de datos que el código cambia. Cada vez que actualizas un módulo, Odoo cambia tablas, campos y registros en PostgreSQL. Después de la actualización, el código anterior ya no encaja con la base de datos. Por eso no puedes volver atrás con solo retroceder un commit. Ese hecho explica todo lo que sigue.
Las siete cosas que tiene que hacer un push
1. Una copia limpia del código, no un pull en una carpeta en uso
Muchos scripts ejecutan git pull en la carpeta de módulos del servidor en producción. Esa carpeta está en uso. Un pull que falla a medias, un conflicto de merge o un archivo que alguien cambió a mano en el servidor pueden dejar a Odoo ejecutando código que no existe en ningún lugar de Git.
Lo seguro es un clon nuevo para cada build, en su propia carpeta. Ahí se instalan los submódulos y requirements.txt. El Odoo en marcha sigue con la copia anterior hasta que la nueva está lista.
2. El addons path correcto
Odoo solo ve los módulos que están en su addons path. Un build tiene que poner ahí cuatro cosas, en el orden correcto: tus propios módulos, tus submódulos de OCA u otros, Enterprise si lo tienes, y los módulos de la plataforma. Si tus módulos están en una subcarpeta, esa subcarpeta va en la ruta, no la raíz del repositorio. Si te equivocas aquí, el paso 3 no actualiza nada, pero dice que todo salió bien.
3. La lista correcta de módulos que actualizar
Este es el paso que la mayoría de las guías explica mal. odoo -u all actualiza todos los módulos de la base de datos, también los del núcleo. En una base grande, eso puede tardar una hora. Actualizar solo los módulos del último commit es más rápido, pero se salta los módulos que dependen del que cambió.
La lista correcta es fácil de decir. Actualiza los módulos que están instalados en la base de datos y también en la nueva copia del código. ¿Instalado pero ya no está en el repositorio? Déjalo. ¿En el repositorio pero nunca instalado? Déjalo también. Instalar un módulo es tu decisión, no un efecto de un push. Así que la lista sale de la base de datos, no del diff.
4. Un punto de vuelta atrás antes de la actualización
Por la base de datos, la única vuelta atrás real es una copia de la base de datos. Hazla después de parar Odoo y antes de ejecutar -u. No una snapshot de todo el servidor. Un dump de esa base de datos, para que una rama pueda volver atrás sin tocar nada más.
Si la copia falla, la actualización no debe ejecutarse. Es mejor un build fallido que una base de datos a medio actualizar y sin vuelta atrás.
5. La actualización, con Odoo parado
Ejecuta la actualización de módulos con --stop-after-init mientras Odoo no atiende a usuarios. Una actualización con usuarios trabajando puede dejar módulos a medias. Con dos actualizaciones a la vez, pasará seguro. Una actualización cada vez por rama, en orden.
odoo -c /etc/odoo/odoo.conf -d tu_base -u module_a,module_b --stop-after-init
6. Una comprobación, y vuelta atrás si falla
Arranca el nuevo Odoo. Comprueba que responde en su dominio. Si no responde, restaura la copia del paso 4 y vuelve a poner el Odoo anterior, sin que nadie tenga que leer logs a las 2 de la mañana. Si responde, la copia anterior del código ya puede irse.
Este paso es lo que hace seguro desplegar con un push en producción. Sin él, cada push es una apuesta.
7. Cada rama es un entorno
Una rama a la que haces push debería convertirse en un Odoo que puedes abrir. Las ramas de funcionalidades tienen uno de corta duración. Staging recibe una copia de producción, sin datos privados como los correos de los clientes. Producción sigue todo el flujo de actualización de arriba. Fusiona de una a la siguiente, y el mismo pipeline se ejecuta cada vez.
Dónde se quedan cortos los pipelines caseros
La mayoría de las guías de despliegue de Odoo te dan un archivo de GitHub Actions o GitLab CI que hace esto: entrar al servidor por SSH, git pull, ejecutar -u en los módulos del diff, reiniciar y cargar la página de inicio de sesión. Algunas añaden antes un pg_dump.
Eso cubre los pasos 1, 3 y 6, cada uno solo en parte. Y te deja con:
- Claves SSH de tu servidor de producción, guardadas como secretos de CI
- Un runner de CI que tienes que mantener al día
- Una lista de actualización sacada del diff, que se salta los módulos que dependen de él
- Una vuelta atrás que es un script que escribiste una vez y nunca probaste bajo presión
- Sin staging, salvo que construyas tú mismo la limpieza de datos
Nada de esto es difícil de escribir. Lo difícil es que siga funcionando durante tres años mientras también entregas funcionalidades.
Cómo funciona en Skysize
Skysize se conecta a tu repositorio en GitHub, GitLab o Bitbucket. Luego, en cada push:
- Un clon nuevo por build. Cada build tiene su propia copia del código, con los submódulos, públicos o privados, y
requirements.txtinstalados. Dos contenedores de Odoo nunca comparten carpeta. - El addons path, listo para ti. Tus módulos, los submódulos, Enterprise si lo usas, y los módulos de la plataforma van en la ruta, en el orden correcto. Si tus módulos están en una subcarpeta, indicas esa ruta una vez por rama.
- La lista de actualización, sacada de la base de datos. La actualización se hace en los módulos instalados que están en la nueva copia del código. Nunca
-u all. Los módulos que no instalaste no se tocan. - Una copia, la actualización, una comprobación, una vuelta atrás. Antes de la actualización, se copia tu base de datos. Después, se comprueba el nuevo Odoo en su dominio. Si la comprobación falla, vuelve la copia, y también el Odoo anterior, sin que hagas nada.
- Tipos de rama. Las ramas de desarrollo duran poco. Se borran solas tras un tiempo sin un build nuevo. Las ramas de staging pueden empezar desde una copia de producción, sin los datos privados. Producción sigue todo el flujo de actualización.
- Logs de build. Cada build registra sus pasos install, update, tests y requirements. Cuando un build falla, ves en qué paso fue.
- Sin SSH en tu servidor. Si Odoo corre en tu propio servidor, nuestro software se conecta hacia Skysize. No guardamos ningún acceso SSH, no añadimos ninguna clave SSH a tu servidor y no abres ningún puerto.
Mira cada paso en la página de despliegues. El mismo pipeline funciona en el hosting gestionado de Odoo, en tu propio servidor y dentro de tu propia red, para Community y Enterprise.
Para la parte de staging, lee cómo copiar producción de Odoo a staging sin enviar correos a tus clientes.
Míralo funcionar con tu propio repositorio
Trae un repositorio y haremos pasar una rama por el pipeline contigo, en pantalla. O conéctalo tú mismo con la prueba gratis de 7 días. Sin tarjeta.
Skysize está hecho por ex ingenieros de Odoo y tiene la certificación ISO 27001.
Habla con un experto en hosting de Odoo
Preguntas frecuentes
¿Qué es desplegar Odoo con Git? Significa que un git push es la única forma en que el código llega a un servidor de Odoo. El push prepara el código, actualiza los módulos correctos, reinicia Odoo y comprueba que funciona. Cada rama es su propio Odoo en marcha, y nadie despliega por SSH.
¿Desplegar con Git es lo mismo que CI/CD? Casi. CI/CD significa construir, probar y desplegar en cada commit. Desplegar con Git es esa idea aplicada a Odoo, donde lo difícil es la base de datos que cambia con el código.
¿Puedo desplegar Odoo desde GitLab o Bitbucket, no solo GitHub? Sí. Skysize funciona con GitHub, GitLab y Bitbucket. El pipeline es el mismo para los tres.
¿Un push instala módulos nuevos? No. Un push actualiza los módulos que ya están instalados. Instalar un módulo es una decisión que tomas en Odoo.
¿Qué pasa si la actualización falla? Vuelve la copia de la base de datos hecha antes de la actualización, y también el Odoo anterior. Quedas donde estabas antes del push.
¿Funcionan los submódulos y las dependencias de Python? Sí. Los submódulos se descargan en cada build, públicos o privados. Cada submódulo privado tiene su propia clave de despliegue. requirements.txt se instala en el build.
¿Puedo tener un CI/CD como el de Odoo.sh en Odoo Community? Sí. Los entornos por rama, staging desde producción, desplegar con un push y la vuelta atrás funcionan en Community, que Odoo.sh no aloja. También funcionan en Enterprise.