Home Projects Portfolio Dashboard Export PDF Log in

Resolviendo Bloqueos en Despliegues con Prisma y Supabase: La Importancia de DIRECT_URL

En el desarrollo de aplicaciones modernas, la gestión de la base de datos es un componente crítico. Recientemente, en el proyecto OpsMind, nos encontramos con un desafío particular durante los despliegues que involucraban npx prisma db push en entornos de Render utilizando Supabase como base de datos. El comando de migración de Prisma se quedaba colgado, impidiendo que los despliegues se completaran exitosamente.

El Problema: Prisma y el Connection Pooler de Supabase

La raíz del problema residía en cómo Prisma intentaba aplicar los cambios de esquema. Por defecto, Prisma CLI (y la aplicación en tiempo de ejecución) suele usar la variable de entorno DATABASE_URL para conectarse a la base de datos. Sin embargo, en configuraciones como la de Supabase, DATABASE_URL a menudo apunta a un Connection Pooler (como PgBouncer), el cual está optimizado para conexiones de aplicaciones que son de corta duración y no para tareas administrativas o de migración de larga duración.

Cuando npx prisma db push intentaba ejecutar sus operaciones a través del Connection Pooler, este último no manejaba bien las transacciones de esquema complejas, lo que provocaba que el comando se "colgara" y el despliegue nunca terminara.

La Solución: Priorizando DIRECT_URL

La solución implementada fue asegurar que Prisma CLI priorice la variable de entorno DIRECT_URL sobre DATABASE_URL cuando resuelva las variables de conexión de la base de datos para tareas administrativas. DIRECT_URL es una variable específica que permite una conexión directa a la base de datos (generalmente a través del puerto 5432), saltándose el Connection Pooler.

Al utilizar DIRECT_URL para operaciones como db push, Prisma puede establecer una conexión robusta y directa con la base de datos. Esto permite que la sincronización del esquema se complete sin interrupciones, garantizando que las migraciones se apliquen correctamente y que los despliegues finalicen como se espera.

Configuración de Variables de Entorno

Es fundamental configurar ambas variables en tu archivo .env o en el panel de variables de entorno de tu proveedor de despliegue (como Render):

// .env (ejemplo)
DATABASE_URL="postgresql://user:[email protected]:5432/postgres?pgbouncer=true"
DIRECT_URL="postgresql://user:[email protected]:5432/postgres"

Donde DATABASE_URL sería utilizada por tu aplicación en producción para aprovechar el pooler, y DIRECT_URL es la conexión directa que Prisma CLI necesita para sus comandos de desarrollo y despliegue (como db push o generate).

Impacto

Esta pequeña pero crucial optimización en la resolución de variables de entorno ha eliminado un cuello de botella significativo en nuestros procesos de despliegue. Ahora, las actualizaciones de esquema con Prisma son fluidas y confiables, lo que mejora la eficiencia y la estabilidad de nuestros despliegues continuos.

Priorizar DIRECT_URL es una buena práctica al trabajar con Prisma y proveedores de bases de datos que utilizan poolers de conexión para evitar problemas en tareas que requieren una conexión persistente y directa a la base de datos, como las migraciones.


Generated with Gitvlg.com

Resolviendo Bloqueos en Despliegues con Prisma y Supabase: La Importancia de DIRECT_URL
Lenin Moreno

Lenin Moreno

Author

Share: