Tres semanas antes de nuestro lanzamiento todo parecía impecable. La app funcionaba fluida en desarrollo, Prisma gestionaba las transacciones sin fricción y estábamos listos para salir a producción.
Luego hicimos deploy a producción.
Transaction failed not in a replica set fueron seis palabras que convirtieron la semana del lanzamiento en una maratón de depuración. Te suena
Si alguna vez intentaste ejecutar transacciones de MongoDB en producción, seguro conoces este dolor. Lo que va perfecto en local se rompe justo cuando más lo necesitas. Hoy compartimos el montaje de MongoDB listo para producción que finalmente resolvió el rompecabezas.
El problema que no vimos venir
En desarrollo usábamos una instancia simple de MongoDB. Pero al usar transacciones de Prisma en producción, todo se vino abajo. La causa MongoDB exige un replica set para ejecutar transacciones incluso en un despliegue de un solo nodo.
Esto no está claro en la documentación y nos tomó por sorpresa. Y no estamos solos a muchos equipos les ocurre en su primer despliegue real.
La solución que sí funciona
Tras tres días de investigación y pruebas implementamos una configuración sólida con MongoDB 8.0 que habilita transacciones, endurece la seguridad y asegura persistencia de datos. Aquí va el paso a paso.
Paso 1 Base del proyecto y credenciales
Organiza el proyecto y gestiona secretos de forma segura crea las carpetas y un archivo .env para tus variables confidenciales. Define al menos MONGO_ROOT_USER y MONGO_ROOT_PASS. Consejo nunca incrustes credenciales en imágenes o archivos de despliegue.
Paso 2 KeyFile de seguridad necesario incluso con un solo nodo
Genera la clave y fija permisos adecuados para la comunicación interna del replica set ejecuta openssl rand -base64 756 > ./mongo-key/mongodb.key luego chmod 400 ./mongo-key/mongodb.key y finalmente chown 999:999 ./mongo-key/mongodb.key. El id 999 corresponde al usuario de MongoDB dentro del contenedor. Si esto falla verás errores de autenticación difíciles de rastrear.
Paso 3 Configuración de Docker Compose que realmente funciona
Elementos clave imagen mongo 8.0 nombre del contenedor mongodb_prod hostname mongodb_prod puerto 27017 variables MONGO_INITDB_ROOT_USERNAME y MONGO_INITDB_ROOT_PASSWORD leyendo desde .env comando de arranque con parametros para habilitar el replica set y el keyfile usa los flags --replSet rs0 y --keyFile ruta del keyfile volúmenes persistentes para data y config y un volumen de solo lectura para el keyfile. Asegúrate de que el hostname sea el mismo que referenciarás en el replica set.
Paso 4 Inicialización única del replica set
Arranca el contenedor con docker compose up -d espera unos 20 a 30 segundos y luego inicializa el replica set con mongosh autenticado sobre la base admin y ejecuta rs.initiate con un id rs0 y un miembro cuyo host sea mongodb_prod:27017. El objeto de ejemplo sería rs.initiate({ _id: rs0, members: [ { _id: 0, host: mongodb_prod:27017 } ] }). Busca en la salida ok 1 para confirmar que todo quedó correcto.
Paso 5 Cadena de conexión que habilita transacciones
Usa el formato DATABASE_URL=mongodb://usuario:password@mongodb_prod:27017/nombre_bd?authSource=admin&replicaSet=rs0
Claves authSource=admin indica dónde autenticar y replicaSet=rs0 activa el soporte de transacciones.
Lecciones aprendidas
1 Prueba tu arquitectura de producción cuanto antes no esperes a la semana del lanzamiento para descubrir que necesitas replica set. 2 Documenta tu proceso de despliegue tu yo del futuro y tu equipo te lo agradecerán. 3 Monitorea desde el primer minuto con docker compose logs -f mongodb_prod detectas problemas temprano. 4 Haz copias de seguridad desde el día uno aunque haya volúmenes persistentes los backups periódicos nos salvaron durante una migración de servidor.
Qué sigue
Este montaje es la base de nuestra infraestructura actual. Después añadimos monitoreo con Prometheus, backups automatizados y optimizaciones de rendimiento. El núcleo se mantiene igual porque simplemente funciona.
En Q2BSTUDIO ayudamos a empresas a diseñar, desplegar y operar plataformas modernas y seguras con aplicaciones a medida, software a medida, servicios cloud aws y azure, ciberseguridad, inteligencia artificial e ia para empresas, agentes IA, así como servicios inteligencia de negocio y power bi. Si necesitas un equipo experto para revisar tu arquitectura, automatizar despliegues o migrar a un replica set robusto, podemos ayudarte.
Descubre cómo creamos soluciones escalables y seguras de software a medida y aplicaciones a medida y cómo optimizamos tu infraestructura con servicios cloud aws y azure listos para producción.
Si te encontraste con errores similares en MongoDB producción, cuéntanos tu experiencia y qué ajustes te funcionaron. Compartir aprendizajes en comunidad nos ahorra horas de frustración y mejora la confiabilidad de los sistemas.