Todos los artículos

Getting Started

Qué es CICDoo Primeros pasos: el asistente de incorporación El Panel y el Mapa de Infraestructura

Concepts

Etapas de producción, staging y desarrollo Dominios, subdominios y SSL Versiones y ediciones de Odoo (Community vs Enterprise) Espacios de trabajo y colaboración en equipo

Servers

Añadir un servidor Dominios de servidor y DNS Usar un balanceador de carga Conectar a través de un servidor de salto Acciones de servidor: desplegar, registros y gráficos Deleting a server

Projects & Git

Crear un proyecto Conectar GitHub Project GitHub settings and webhook Conectar GitLab Ramas e instancias Etiquetar y filtrar proyectos Alta disponibilidad con nodos de aplicación Project environments, extensions and deletion

Instances & Console

Crear una instancia Reiniciar, detener y eliminar una instancia Fusionar ramas entre etapas Web IDE y acceso remoto SSH access to instances Explicación de los ajustes de la instancia Despliegues y la cola de trabajos

Agent Tasks

Qué son las tareas del agente Configurar las tareas del agente Ejecutar una tarea y revisar el resultado Tiempo de agente y recargas Agent insights and task filters

Monitoring & Backups

Monitorear tu instancia Copias de seguridad y restauración S3 storage, uploads and bulk backup actions Notificaciones de alerta (correo y SMS)

Workspaces & Permissions

Invitar a miembros del espacio de trabajo Permisos de los miembros y acceso a recursos Un miembro no puede ver o usar un recurso Audit log and server activity

Account & Security

Autenticación de dos factores (2FA) Ajustes de perfil e integraciones Contraseñas y recuperación de cuenta Instance security score and checks The Security page: every instance and member at a glance

Billing & Plans

Planes y precios Mejorar y gestionar tu suscripción Si una suscripción de proyecto queda sin pagar El programa de partners de canal Onboarding a client as a partner

Support & Tickets

Abrir un ticket de soporte Cómo obtener ayuda del equipo de CICDoo

Troubleshooting

Resolución de problemas: no se puede conectar un servidor Resolución de problemas: falló un despliegue Resolución de problemas: git push falla con 403 tras mover un repositorio Resolución de problemas: mi instancia está caída o lenta Resolución de problemas: problemas de dominio o SSL

Proyectos y Git

Alta disponibilidad con nodos de aplicación

Cómo ejecutar una base de datos Odoo de producción en varios servidores, con un proyecto principal que ejecuta la base de datos y nodos de aplicación que la sirven.

Cómo funciona

La alta disponibilidad permite que la producción de una base de datos Odoo se ejecute en varios servidores a la vez. Si un servidor deja de responder, los visitantes se envían a los demás.

Un clúster está formado por proyectos que ejecutan el mismo código:

  • El principal: un proyecto cuya instancia de producción ejecuta Odoo y la base de datos. Su base de datos se abre a los nodos de aplicación, y a nadie más.
  • Nodos de aplicación: otros proyectos, cada uno en un servidor de producción distinto, cuya instancia de producción solo ejecuta Odoo y usa la base de datos del principal.
  • Réplicas: nodos de aplicación que además guardan en su propio servidor una copia en espera de la base de datos del principal, lista para tomar el relevo si se pierde el principal.

Los visitantes usan la dirección del principal. CICDoo apunta esa dirección al principal y a cada nodo de aplicación que responde, y comprueba cada nodo cada pocos minutos. Un nodo que deja de responder se retira de la dirección hasta que se recupera.

La base de datos en sí se ejecuta en un solo servidor, el del principal. Los nodos de aplicación hacen redundante la parte de Odoo. Para proteger también la base de datos, añade una réplica: si se pierde el servidor del principal, promueves la réplica y el sitio continúa desde su copia. Consulta "Réplicas y conmutación por error" más abajo.

Antes de empezar

  • Mismo código: todos los proyectos de un clúster deben usar el mismo repositorio, la misma rama predeterminada, la misma versión de Odoo y la misma edición. Si Time Machine está activado, los commits fijados también deben coincidir.
  • Servidores distintos: cada nodo de aplicación debe tener su propio servidor de producción, distinto del del principal y del de los demás nodos.
  • Proxy de Cloudflare: repartir el tráfico entre los nodos funciona actualmente con servidores que tienen activado el proxy de Cloudflare. Usa servidores de la misma región, ya que cada página que sirve un nodo de aplicación se comunica con la base de datos del principal.
  • Filestore compartido: cada servidor del clúster debe montar el mismo almacenamiento compartido para el filestore de Odoo. Sin él, un adjunto subido a través de un nodo falta en los demás, y un visitante que llega a otro nodo pierde la sesión. Pide ayuda al soporte si la necesitas para configurarlo.
  • Conexiones a la base de datos: cada nodo de aplicación abre sus propias conexiones a la base de datos del principal. A medida que añades nodos, aumenta max_connections en la Configuración de PostgreSQL de la instancia de producción del principal, en la pestaña Ajustes de su consola.
  • Cuántas réplicas: cada réplica necesita su propio servidor de producción. Con los ajustes predeterminados de PostgreSQL, un principal puede alimentar unas nueve réplicas, y cada una puede retener hasta 20 GB de cambios en el disco del principal mientras va con retraso.

Los ajustes de alta disponibilidad están en Ajustes del proyecto, en la pestaña Avanzado, en la tarjeta Alta disponibilidad. Necesitas permiso para cambiar los ajustes del proyecto.

Configurar el principal

Abre el proyecto que ejecutará la base de datos, ve a Ajustes del proyecto > Avanzado y, en Alta disponibilidad, establece Rol en Principal (aplicación + base de datos). Haz clic en Aplicar y confirma.

La instancia de producción se reinicia. Cuando vuelve, su base de datos acepta conexiones de los nodos de aplicación del clúster. Las conexiones entre servidores van cifradas, salvo que tus servidores compartan una red privada.

La instancia de producción debe usar su propia base de datos incluida. Un proyecto cuya instancia de producción apunta a una base de datos externa no puede ser principal.

Añadir un nodo de aplicación

Crea un proyecto para el nodo como lo harías normalmente: mismo repositorio y misma rama predeterminada, misma versión y edición, y un servidor de producción propio. Elimina las instancias de staging y de desarrollo que tenga: un nodo de aplicación solo ejecuta producción, y las ramas de staging y de desarrollo viven en el proyecto principal.

Después abre los Ajustes del proyecto > Avanzado del nodo, establece Rol en Nodo de aplicación (usa la base de datos de un principal), elige el principal en Origen de la base de datos, haz clic en Aplicar y confirma. Solo se ofrecen principales del mismo espacio de trabajo que ejecutan el mismo código.

El nodo no arranca de inmediato. Primero el servidor del principal tiene que dejarlo entrar, lo que ocurre en su siguiente comprobación, normalmente en cinco minutos. Hasta entonces la tarjeta muestra "Esperando a que el principal permita este nodo", y el nodo arranca por sí solo en cuanto se le permite. Unos minutos después de que responda, empieza a recibir visitantes.

En el principal, la tarjeta Alta disponibilidad lista sus nodos de aplicación y si el servidor de la base de datos ha aplicado la lista de acceso actual.

Réplicas y conmutación por error

Una réplica es un nodo de aplicación que además ejecuta una copia en espera de la base de datos del principal. El principal le envía cada cambio, así que normalmente la copia va solo unos segundos por detrás. Odoo en una réplica atiende a los visitantes como en cualquier nodo de aplicación, usando la base de datos del principal.

Para añadir una, prepara un proyecto exactamente igual que para un nodo de aplicación, establece Rol en Réplica (nodo de aplicación + copia en espera de la base de datos), elige el principal en Origen de la base de datos y haz clic en Aplicar. El principal debe ejecutar PostgreSQL 13 o posterior, que es lo predeterminado desde Odoo 15, y la réplica debe usar la misma versión de PostgreSQL. Al unirse, la base de datos propia del proyecto réplica se sustituye por la copia; sus datos antiguos se apartan en el servidor, no se borran. En una base de datos grande la primera copia tarda un rato.

La tarjeta Alta disponibilidad de la réplica muestra el estado de la copia:

  • Copiando: se está tomando la primera copia.
  • Cambiando al nuevo principal: se promovió otra réplica y esta copia se está cambiando a ella. Conserva los datos que ya tiene, así que normalmente es rápido.
  • Sincronizando: la copia sigue al principal.
  • Con retraso: la copia se ha quedado más de unos cientos de MB por detrás, o ha dejado de seguir al principal por ahora.
  • Rota: el principal ya no conserva los cambios que necesita la copia. Haz clic en Reconstruir copia para tomar una nueva.

Si se pierde el servidor del principal, abre la tarjeta Alta disponibilidad de la réplica, haz clic en Promover a principal y escribe el nombre del proyecto para confirmar. La base de datos de la réplica pasa a ser la del clúster, la réplica pasa a ser el principal y todos los demás nodos se reinician contra ella. El sitio conserva su dirección. El principal antiguo pasa a ser un nodo de aplicación: cuando su servidor vuelve, arranca sin base de datos propia y no recibe visitantes hasta haberse reiniciado así. Los cambios que hizo el principal antiguo después de la última sincronización de la copia se pierden, así que promueve solo cuando el principal no pueda recuperarse. La promoción nunca ocurre automáticamente. Las demás réplicas conservan su copia y se cambian al nuevo principal. Si alguna iba por delante de la réplica promovida, se rebobina para que coincida con ella, y solo si eso no es posible vuelve a copiar la base de datos. Si la tarjeta de la réplica indica que otra réplica tenía una copia más reciente, promueve esa: perderás menos cambios.

Una réplica usa los ajustes de PostgreSQL del principal. Después de cambiar la Configuración de PostgreSQL de la instancia de producción del principal, reinicia las réplicas.

Leer de una réplica

En Odoo 18 y posteriores, cualquier proyecto de un clúster puede enviar su trabajo de solo lectura a una réplica: vistas de lista y formulario, vistas agrupadas, informes y exportaciones. Toda escritura sigue yendo al principal, y una petición que resulta necesitar una escritura se reintenta allí automáticamente. Así se quita carga al servidor de base de datos del principal.

Abre los Ajustes del proyecto > Avanzado del proyecto, elige la réplica en Consultas de solo lectura en la tarjeta Alta disponibilidad y haz clic en Aplicar. Una réplica también puede leer de su propia copia. El proyecto se reinicia cuando la réplica lo permite, normalmente en cinco minutos.

Las lecturas de una réplica pueden ir un instante por detrás del principal. Cuando una réplica se retrasa, se detiene o se rompe, CICDoo la cierra a los lectores y Odoo vuelve al principal por sí solo, sin reiniciar. Los lectores vuelven a ella en una media hora como máximo después de que vuelva a sincronizar.

Qué cambia en un nodo de aplicación

  • Su instancia de producción no tiene base de datos propia. Los ajustes de su base de datos los gestiona CICDoo y no se pueden cambiar en la configuración de Odoo de la instancia.
  • Las tareas programadas (crons de Odoo) solo se ejecutan en el principal.
  • Las copias de seguridad se hacen en el principal. Haz copias de seguridad y restaura la base de datos del clúster desde el proyecto principal.
  • Hacer push a la rama de un nodo de aplicación no hace nada por sí solo. El clúster se actualiza desde el principal.
  • La consola de un nodo de aplicación oculta el shell de la base de datos, las copias de seguridad y los ajustes de PostgreSQL, que están en el principal. Una réplica conserva su shell de base de datos, que abre su copia de solo lectura.

Desplegar actualizaciones

Haz push a la rama del principal como siempre. CICDoo actualiza entonces todo el clúster en orden:

  1. Se detiene cada nodo de aplicación.
  2. Se actualiza el principal, incluida cualquier actualización de módulos, mientras ningún otro servidor usa la base de datos.
  3. Se vuelve a iniciar cada nodo de aplicación con el código nuevo.

Puedes seguir cada paso en la pestaña Cola de la instancia en la que se ejecuta. Si la actualización del principal falla, los nodos de aplicación no se vuelven a iniciar, y sus entradas de la cola indican el motivo. Corrige el problema y vuelve a desplegar.

Como las actualizaciones de módulos necesitan la base de datos en exclusiva, el sitio no está disponible mientras se actualiza el principal, igual que con una sola instancia.

Salir de un clúster

Para retirar un nodo de aplicación, vuelve a establecer su Rol en Independiente (base de datos propia) y haz clic en Aplicar. Su instancia de producción se detiene, porque su propia base de datos no contiene los datos del clúster. Restaura una copia de seguridad en ella antes de volver a iniciarla.

Un principal no se puede cambiar mientras todavía tenga nodos de aplicación. Retira primero los nodos.

Solución de problemas

  • El nodo sigue esperando a que se le permita: comprueba que la instancia de producción del principal está en ejecución y que su servidor está en línea. El principal tiene que reiniciarse una vez después de convertirse en principal antes de que se permita ningún nodo.
  • El nodo arranca pero Odoo no se levanta: abre los registros del nodo. Un mensaje que dice que la base de datos del principal no está inicializada significa que el principal no ha terminado su primer arranque.
  • Las subidas o las sesiones no siguen a los visitantes entre nodos: los servidores no comparten el filestore. Consulta "Antes de empezar" más arriba.
  • Una réplica se queda en Copiando: comprueba que la instancia de producción del principal está en marcha. La copia empieza cuando el principal ha permitido la réplica, y el reinicio de la réplica en la pestaña Cola muestra su avance o el error.

Consulta Ramas e instancias para ver cómo se corresponden las instancias con las ramas, y Usar un balanceador de carga para el ajuste de balanceador de carga a nivel de servidor, que es una función distinta.

Ejecuta esto en tus propios servidores con CICDoo

Conecta un servidor y enlaza tu repositorio. Los despliegues, las copias de seguridad y la monitorización vienen configurados, y los ingenieros de Odoo están a un mensaje de distancia.

¿Sigues atascado? Abre un ticket desde la app o habla con un ingeniero.