Cómo Deployar Módulos Custom en Odoo.sh: Nuestro Workflow Automatizado

Guía práctica para el equipo de soporte: cómo deployar un módulo custom en 10-15 minutos
30 de marzo de 2026 por
Cómo Deployar Módulos Custom en Odoo.sh: Nuestro Workflow Automatizado
Jinzo

¿Tenés un módulo custom listo y necesitás deployarlo en Odoo.sh? Esta guía paso a paso te muestra exactamente qué hacer.

Antes de Empezar

Asegurate de tener esta información:

  • 📦 Módulo desarrollado y listo para deploy
  • 🏢 Nombre del cliente (ej: FORLI, Smarttrack)
  • 📁 Repositorio del cliente en GitHub
  • 🌿 Rama de deploy (stg_05_08_2025, stg4, main)
  • 🔢 Versión de Odoo (18.0, 17.0, 16.0)
⚠️ Importante: Este proceso se realiza en staging primero. Nunca deployar directo a producción sin probar.

Paso 1: Iniciar el Deploy con Jinzo

Contactá a Jinzo (nuestro asistente IA) vía Telegram con este mensaje:

Necesito deployar un módulo para [CLIENTE]

Información:
- Cliente: [nombre del cliente]
- Módulo: [nombre del módulo]
- Funcionalidad: [qué hace el módulo]
- Versión Odoo: [18.0 / 17.0 / 16.0]
- Rama: [nombre de la rama]
- Repo: [nombre del repositorio]

Ejemplo real:

Necesito deployar un módulo para FORLI

Información:
- Cliente: FORLI PLASTIC
- Módulo: export_bom
- Funcionalidad: Exportar lista de materiales (BoM) a Excel
- Versión Odoo: 18.0
- Rama: stg_05_08_2025
- Repo: FEMAPLASTIC

Paso 2: Autorizar los 5 Pasos Automatizados

Jinzo va a ejecutar 5 pasos y te va a pedir confirmación antes de cada uno. Simplemente respondé "sí" o "si" a cada paso:

Paso 2.1: Crear módulo ✅

Jinzo pregunta: "¿Autorizo crear el módulo hito_forli_export_bom?"

👉 Respondés: si

Paso 2.2: Pushear a hito-devman ✅

Jinzo pregunta: "¿Autorizo ejecutar PASO 2 (pushear a hito-devman)?"

👉 Respondés: si

Paso 2.3: Clonar repo del cliente ⏱️

Jinzo pregunta: "¿Autorizo ejecutar PASO 3 (clonar repo)?"

👉 Respondés: si

⏱️ Este paso tarda 5-10 minutos - Odoo tiene muchos submódulos (OCA, ingadhoc, etc). Es normal.

Paso 2.4: Inicializar submódulo ✅

Jinzo pregunta: "¿Autorizo ejecutar PASO 4 (inicializar hito-devman)?"

👉 Respondés: si

Paso 2.5: Actualizar submódulo ✅

Jinzo pregunta: "¿Autorizo ejecutar PASO 5 (actualizar submódulo)?"

👉 Respondés: si

Paso 3: Verificar que el Deploy Terminó OK

Cuando Jinzo termine, te va a mostrar:

✅ DEPLOY COMPLETADO EXITOSAMENTE!

Módulo: hito_forli_export_bom
Versión: 18.0
Commit: abc1234
URL: https://github.com/wsf/hito-devman/tree/18.0/hito_forli_export_bom

Si ves esto, el deploy salió perfecto. Seguí al paso 4.

Paso 4: Instalar el Módulo en Odoo.sh

4.1. Esperar el Rebuild (1-2 minutos)

Odoo.sh necesita tiempo para detectar el cambio y rebuildar la instancia. Esperá 1-2 minutos antes de continuar.

4.2. Entrar a la Instancia

Ingresá a la instancia de staging del cliente:

Ejemplo: https://forli-stg-05-08-2025.odoo.com

4.3. Actualizar Lista de Apps

  1. Ir a Apps (Aplicaciones)
  2. Click en "Update Apps List"
  3. Confirmar
⚠️ CRÍTICO: Si no hacés "Update Apps List", el módulo NO va a aparecer.

4.4. Buscar e Instalar

  1. En el buscador de Apps, escribí el nombre del módulo
  2. Ejemplo: export_bom o hito_forli_export_bom
  3. Click en "Instalar"
  4. Verificar que se instaló sin errores

Troubleshooting

❓ "El módulo no aparece en Apps"

Solución:

  • Esperá 2-3 minutos más (rebuild puede tardar)
  • Refrescá la página (F5)
  • Volvé a hacer "Update Apps List"

❓ "Error al instalar el módulo"

Solución:

  • Copiá el mensaje de error completo
  • Contactá al equipo de desarrollo
  • Puede ser error de dependencias o código

❓ "El proceso se quedó colgado en PASO 3"

Solución:

  • Esperá 10-15 minutos
  • Es normal que tarde (muchos submódulos)
  • Si después de 20 min sigue sin terminar, contactá a Ale o Lucas

Checklist Final

Antes de dar por terminado, verificá:

  • ☐ Jinzo completó los 5 pasos sin error
  • ☐ El commit llegó a GitHub (verificar URL)
  • ☐ Esperaste 1-2 min para rebuild
  • ☐ Hiciste "Update Apps List"
  • ☐ El módulo aparece en Apps
  • ☐ El módulo se instaló sin errores
  • ☐ Avisaste al cliente que está listo

Tiempo Total del Proceso

Paso Tiempo
Paso 1: Crear módulo 30 segundos
Paso 2: Push a hito-devman 1 minuto
Paso 3: Clone repo cliente 5-10 minutos
Paso 4: Init submódulo 1 minuto
Paso 5: Update submódulo 1 minuto
Espera rebuild Odoo.sh 1-2 minutos
Instalación en Apps 1 minuto
TOTAL 10-15 minutos

🎉 ¡Listo!

Con esta guía, cualquier miembro del equipo de soporte puede deployar módulos custom de forma rápida y segura.

¿Necesitás ayuda con Odoo?

En Hitofusion somos especialistas en implementación, desarrollo y soporte de Odoo. Automatizamos procesos complejos para que tu equipo trabaje más eficientemente.

Contactanos

Leer siguiente
Caso de Estudio: Cómo resolvimos el bug de "Pago Automático en $0"
EGP - Ticket #2026/03794 - Guía para el equipo de soporte