Home Projects Portfolio Dashboard Export PDF Log in

Simplificando el Desarrollo: Dockerizando API y PostgreSQL con Sincronización Prisma

Contexto del Proyecto

En el proyecto OpsMind, nos enfocamos en optimizar las operaciones. Una parte crucial de este esfuerzo ha sido mejorar y estandarizar nuestro entorno de desarrollo. Recientemente, abordamos la tarea de "dockerizar" nuestra API y su base de datos PostgreSQL, integrando la sincronización automática del esquema de la base de datos a través de Prisma.

El Desafío

Antes de esta implementación, configurar el entorno de desarrollo para OpsMind podía ser un proceso tedioso y propenso a errores. Cada desarrollador necesitaba instalar PostgreSQL, configurar la base de datos y asegurarse de que el esquema estuviera sincronizado con la última versión del código. Esto llevaba a inconsistencias entre entornos, largos tiempos de configuración para nuevos miembros del equipo y desafíos al implementar nuevas funcionalidades que dependían de cambios en la base de datos.

La Solución

La solución consistió en encapsular tanto la API como la base de datos PostgreSQL en contenedores Docker. Esto permite a los desarrolladores levantar todo el entorno con un solo comando, garantizando consistencia. Además, integramos Prisma para manejar la sincronización automática del esquema de la base de datos, lo que significa que los cambios en el modelo de datos se aplican automáticamente al contenedor de PostgreSQL cuando se inicia o se actualiza.

Así es como se ve una configuración básica en docker-compose.yml:

version: '3.8'
services:
  api:
    build: .
    ports:
      - "3000:3000"
    depends_on:
      - db
    environment:
      DATABASE_URL: "postgresql://user:password@db:5432/mydb?schema=public"
    command: bash -c "npx prisma migrate deploy && npm run dev"
  db:
    image: postgres:14
    restart: always
    environment:
      POSTGRES_USER: user
      POSTGRES_PASSWORD: password
      POSTGRES_DB: mydb
    volumes:
      - db_data:/var/lib/postgresql/data

volumes:
  db_data:

En esta configuración, el servicio api se encarga de ejecutar npx prisma migrate deploy antes de iniciar la aplicación, asegurando que el esquema de la base de datos en el contenedor db esté siempre actualizado.

Decisiones Clave

  1. Uso de docker-compose: Para orquestar fácilmente múltiples servicios (API y base de datos) y sus interdependencias.
  2. Imágenes oficiales de PostgreSQL: Garantiza una base de datos robusta y bien mantenida.
  3. Integración de Prisma migrate deploy: Permite la aplicación automática de migraciones de la base de datos al inicio del contenedor de la API, eliminando la configuración manual del esquema.
  4. Montaje de volumen para PostgreSQL: Persiste los datos de la base de datos incluso si el contenedor se detiene o se reconstruye.

Resultados

La dockerización de OpsMind ha resultado en una mejora significativa en la experiencia del desarrollador:

  • Configuración simplificada: Los nuevos desarrolladores pueden tener el entorno listo y funcionando en minutos.
  • Consistencia ambiental: Elimina los problemas de "funciona en mi máquina" al garantizar que todos los entornos sean idénticos.
  • Desarrollo acelerado: Los desarrolladores pueden enfocarse en el código de la aplicación en lugar de preocuparse por la infraestructura de desarrollo.

Lecciones Aprendidas

La principal lección es que invertir en la estandarización y automatización del entorno de desarrollo mediante herramientas como Docker y Prisma es fundamental. Facilita la incorporación de nuevos miembros, mejora la productividad del equipo existente y garantiza la consistencia entre los entornos de desarrollo, prueba y producción. Siempre busquemos formas de reducir la fricción en el flujo de trabajo del desarrollador.


Generated with Gitvlg.com

Simplificando el Desarrollo: Dockerizando API y PostgreSQL con Sincronización Prisma
Lenin Moreno

Lenin Moreno

Author

Share: