Simplificando el Desarrollo con Docker: API Node.js y PostgreSQL con Prisma
En el proyecto OpsMind, nos esforzamos por crear un ecosistema de desarrollo eficiente y reproducible. Uno de los desafíos recurrentes en cualquier proyecto de software es asegurar que todos los miembros del equipo puedan configurar rápidamente su entorno de desarrollo, con las versiones correctas de todas las dependencias y servicios. Este post describe cómo abordamos esta necesidad incorporando Docker para nuestra API basada en Node.js y nuestra base de datos PostgreSQL, junto con la gestión automática de Prisma.
El Desafío
Antes de la implementación de Docker, configurar un nuevo entorno de desarrollo para OpsMind implicaba una serie de pasos manuales: instalar Node.js (asegurando la versión correcta), configurar PostgreSQL localmente, crear la base de datos, ejecutar migraciones de Prisma y gestionar variables de entorno. Este proceso era propenso a errores, inconsistencias entre diferentes máquinas y un cuello de botella para la incorporación de nuevos desarrolladores.
La Solución Propuesta
La respuesta a estos desafíos fue la contenedorización. Al encapsular nuestra API Node.js y nuestra base de datos PostgreSQL dentro de contenedores Docker, podemos garantizar un entorno de desarrollo aislado, coherente y reproducible para todos. Docker Compose, en particular, nos permite orquestar estos servicios con una única configuración y un comando simple.
Detalles de Implementación
La clave de esta solución reside en un Dockerfile para la API de Node.js y un archivo docker-compose.yml para definir y vincular los servicios. El Dockerfile se encarga de construir la imagen de nuestra aplicación:
FROM node:20-alpine
WORKDIR
COPY package*.json ./
RUN npm install
COPY . .
EXPOSE 3000
CMD ["npm", "run", "start"]
Este Dockerfile utiliza una imagen base ligera de Node.js (Alpine), instala las dependencias de la aplicación y expone el puerto necesario. La orquestación se gestiona a través de docker-compose.yml:
version: '3.8'
services:
api:
build:
context: .
dockerfile: Dockerfile
ports:
- "3000:3000"
environment:
DATABASE_URL: "postgresql://user:password@db:5432/mydb?schema=public"
depends_on:
- db
volumes:
- .:/app
command: bash -c "npx prisma generate && npx prisma migrate deploy && npm run dev"
db:
image: postgres:15-alpine
environment:
POSTGRES_DB: mydb
POSTGRES_USER: user
POSTGRES_PASSWORD: password
volumes:
- pgdata:/var/lib/postgresql/data
ports:
- "5432:5432"
volumes:
pgdata:
En esta configuración, el servicio api se construye a partir de nuestro Dockerfile, mientras que el servicio db utiliza una imagen oficial de PostgreSQL. Las variables de entorno para la conexión a la base de datos se configuran de manera segura. Es crucial destacar la sección command del servicio api: npx prisma generate && npx prisma migrate deploy. Esto asegura que el cliente de Prisma se genere automáticamente y que las migraciones de la base de datos se apliquen en cada inicio del contenedor, manteniendo el esquema de la base de datos sincronizado.
También se utiliza un volumen (pgdata) para asegurar la persistencia de los datos de PostgreSQL, de modo que la información no se pierda al detener o reiniciar los contenedores.
Cómo Funciona
Iniciar todo el entorno de desarrollo es ahora tan sencillo como ejecutar un solo comando en la raíz del proyecto:
docker compose up --build
Este comando construye las imágenes si es necesario, crea los contenedores para la API y la base de datos, ejecuta las migraciones de Prisma y levanta la aplicación. Los desarrolladores pueden centrarse en codificar, en lugar de en la configuración.
Los Beneficios
La implementación de Docker y Docker Compose ha traído consigo múltiples beneficios:
- Reproducibilidad: Se garantiza que el entorno de desarrollo sea idéntico en todas las máquinas, eliminando el problema "funciona en mi máquina".
- Onboarding Rápido: Los nuevos miembros del equipo pueden tener un entorno de desarrollo completamente funcional en cuestión de minutos, con una curva de aprendizaje mínima.
- Aislamiento: Los servicios están aislados del sistema operativo anfitrión, evitando conflictos de versiones con otras aplicaciones.
- Pruebas Consistentes: Facilita la ejecución de pruebas en un entorno controlado y predecible.
Esta mejora en OpsMind ha optimizado significativamente nuestro flujo de trabajo de desarrollo, permitiéndonos construir y desplegar con mayor eficiencia y confianza.
Generated with Gitvlg.com