Configuración de PostgreSQL con Docker y Docker Compose

Contenido del curso

Fundamentos y Primer CRUD

Base de Datos y Persistencia con TypeORM

Autenticación y Autorización

Tu API Completa

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:0016:08

Configuración de PostgreSQL con Docker y Docker Compose

Curso de Backend con NestJS

Clase 11 de 35

Clase 11 / 35

Recursos

Conectar una aplicación backend a una base de datos es parte fundamental del desarrollo moderno. La mejor alternativa, especialmente para proyectos Node.js con TypeScript, es usar contenedores Docker y herramientas como Docker Compose. Así, se agiliza el entorno de desarrollo y se evitan complicaciones de configuración local.

¿Cómo conectar una API backend a base de datos con Docker?

Crear una API suele implicar conectar recursos a sistemas de persistencia. Por lo general, se conectan bases de datos SQL como PostgreSQL, MySQL o MariaDB, aunque también pueden usarse soluciones NoSQL como MongoDB o Couchbase. En este caso, el enfoque está en PostgreSQL sobre Docker, que es ampliamente adoptado y flexible.

Docker permite levantar instancias de bases de datos sin instalarlas directamente en tu máquina, facilitando la portabilidad.
Docker Compose gestiona múltiples servicios y sistemas, usando archivos YAML donde se declara cada servicio a levantar.
Se recomienda evitar configuraciones innecesarias, por ejemplo, declarar drivers o redes personalizadas salvo que sean indispensables.

¿Cuáles son los pasos para levantar PostgreSQL con Docker Compose?

La configuración efectiva implica crear un archivo docker-compose.yaml y adaptarlo con las variables necesarias.

Declarar la imagen de PostgreSQL más reciente como servicio principal.
Definir variables de entorno: nombre de la base de datos, usuario y contraseña. Aquí puedes usar datos simples porque el entorno es local y aislado.
Configurar el puerto 5432 para exponerlo y habilitar conexiones desde fuera del contenedor.
Establecer un volumen para almacenar los datos y evitar perder información al reiniciar o eliminar el contenedor.

Agregar un cliente visual como pgAdmin es útil, y también puede incorporarse vía Docker Compose. Con pgAdmin es más sencillo inspeccionar y gestionar la base de datos mediante interfaz gráfica, sobre todo en pruebas y desarrollo.

¿Cómo acceder a PostgreSQL desde herramientas externas y visuales?

Puedes conectar distintos clientes visuales o de administración de bases de datos según preferencias:

pgAdmin: Permite gestionar PostgreSQL desde el navegador. En Docker, ambos servicios se comunican internamente usando el nombre del servicio como host.
DBeaver, DataGrip u otros: Si corres estos programas por fuera de Docker, debes usar localhost y el puerto que expusiste (por defecto, 5432) como host.
Al agregar la conexión, asegúrate de usar los datos definidos en tu archivo compose para usuario, contraseña y nombre de la base de datos.

La clave es entender cómo Docker expone servicios y cómo los clientes diferencian entre servicios internos (nombre del servicio) y externos (localhost).

¿Qué errores comunes y recomendaciones deben considerar?

El monitoreo de servicios y contenedores desde Docker Desktop (visual) o la terminal es esencial para detectar errores:

Utiliza comandos como docker compose ps o docker compose logs nombre_servicio para verificar el estado y revisar mensajes.
Si algún servicio no está en "verde" (activo), revisa logs y asegúrate de que las variables estén correctamente configuradas.
Ajusta los parámetros en docker-compose.yaml según el entorno, sin exponer datos sensibles si trabajas fuera del entorno local.

Compartir experiencias en la sección de comentarios siempre enriquece la comunidad y ayuda a resolver dudas prácticas sobre la instalación y el uso de Docker para bases de datos en desarrollo.

Comentarios (7)7 comentarios

Josué Eliezer Gómez Soto

Hace un año

El curso está de lujo, solo que el examen que está después del video 10 creo que debería reformularse en algunas preguntas, ya que son confusas:

Maria Alejandra Luna Tito

Si y no pregunta nada de NestJS

Lucas Gabriel Serral

Sentí lo mismo. Justo esa en particular podría reformularse a algo como: "¿Qué debería ocurrir si uno de los campos de una solicitud no cumple con su respectiva validación?" O "¿Qué debería ocurrir si el email en una solicitud no cumple con la validación correspondiente?"

Oscar Monsalve

services:
  postgres:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: my_blog_db
      POSTGRES_USER: blog_user
      POSTGRES_PASSWORD: blog_password
    ports:
      - '5432:5432'
    volumes:
      - postgres_data:/var/lib/postgresql/data

  # Optional: pgAdmin for database management
  pgadmin:
    image: dpage/pgadmin4:latest
    environment:
      PGADMIN_DEFAULT_EMAIL: admin@myblog.com
      PGADMIN_DEFAULT_PASSWORD: admin_password
      PGADMIN_CONFIG_SERVER_MODE: 'False'
    ports:
      - '5050:80'
    volumes:
      - pgadmin_data:/var/lib/pgadmin
    depends_on:
      - postgres

volumes:
  postgres_data:
  pgadmin_data:

services:
  postgres:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: my_blog_db
      POSTGRES_USER: blog_user
      POSTGRES_PASSWORD: blog_password
      PGDATA: /var/lib/postgresql/17/docker
    ports:
      - '5432:5432'
    volumes:
      - postgres_data:/var/lib/postgresql/data

  # Optional: pgAdmin for database management
  pgadmin:
    image: dpage/pgadmin4:latest
    environment:
      PGADMIN_DEFAULT_EMAIL: admin@myblog.com
      PGADMIN_DEFAULT_PASSWORD: admin_password
      PGADMIN_CONFIG_SERVER_MODE: 'False'
    ports:
      - '5050:80'
    volumes:
      - pgadmin_data:/var/lib/pgadmin
    depends_on:
      - postgres

volumes:
  postgres_data:
  pgadmin_data:

Sebastian Morales

Hace 10 meses

Toda la gestión de terminal la estoy haciendo desde Windows PowerShell, y a partir de allí realicé todo el proceso para instalar, verificar y ejecutar Docker Desktop correctamente en Windows 💻🐳. Primero, ingresamos al sitio oficial de Docker para descargar Docker Desktop: 🔗 . Al abrir el menú de descargas, se mostraron varias opciones (Mac Apple Silicon, Mac Intel Chip, Windows AMD64, Windows ARM64 y Linux). Para determinar cuál era la versión correcta para mi equipo, ejecuté en PowerShell el siguiente comando:

wmic os get osarchitecture

Este comando devuelve si tu sistema está usando 64-bit (AMD64) o ARM64, lo cual permite elegir la descarga adecuada. En mi caso, la salida fue:

OSArchitecture
64-bit

Esto confirma que debo instalar Docker Desktop para Windows – AMD64 ✔. Una vez instalado Docker Desktop, verifiqué su funcionamiento ejecutando en PowerShell:

docker --version
docker compose version

Y ambos comandos respondieron correctamente, lo cual confirma que Docker quedó instalado, configurado y accesible desde PowerShell 🎉. Además, también utilicé el comando:

where docker

para confirmar que el ejecutable está correctamente agregado al PATH del sistema. Con estos pasos, Docker Desktop quedó completamente operativo en Windows, lo que permite ejecutar contenedores y usar docker compose sin necesidad de WSL.

En resumen: descargamos Docker Desktop desde la URL oficial, identificamos la arquitectura correcta mediante PowerShell, instalamos la versión adecuada (AMD64), verificamos que docker y docker compose funcionaran, y finalmente confirmamos que todo estuviera correctamente registrado en el PATH del sistema. Ahora Docker Desktop funciona sin problemas dentro de PowerShell 🚀🔥.

Andres Martinez

### docker ps [ver coentenedores activos]
### To run the services, use the command:
# docker-compose up -d --build postgres pgadmin [crear y levantar el contenedor]
### to stop the services, use:
# docker-compose down
### to see logs, use:
# docker-compose logs -f
### to access pgAdmin, navigate to http://localhost:5050 in your web browser.
### Default credentials are :admin123$
### ver imagenes
# docker images
# eliminar imagen
# docker rmi -f dpage/pgadmin4:latest postgres:15-alpine
# ver volumenes
# docker volume ls
# eliminar volumen
# docker volume rm my-blog-api_pgadmin_data my-blog-api_postgres_data
### limpiar los volumenes
# docker system prune -a -f

David Victoria

Para crear la base de Datos también se puede usar DBngin y es super fácil crearla y correrla

Edwin Rudy Quisbert Montalvo

Para los que estén trabajando con solo WSL2 y no conecte con localhost debe utilizar:

ip -a

en la terminal y colocar la ip que les aparezca en el lugar donde esta el localhost

Fundamentos y Primer CRUD

Crea una API RESTful con NestJS

Instalación del CLI de NestJS y primer proyecto con API

Creación de endpoints dinámicos para consultar usuarios en NestJS

Operaciones CRUD en APIs REST con Postman

Método PUT para actualizar usuarios con ID automático

Manejo de status codes HTTP en NestJS

DTOs y validación automática de datos en APIs con NestJS

Servicios y lógica de negocio en NestJS

Variables de entorno seguras en NestJS

Programación modular en NestJS con UserModule

Base de Datos y Persistencia con TypeORM

Configuración de PostgreSQL con Docker y Docker Compose

Configuración de PostgreSQL con TypeORM en aplicaciones NestJS

Creación de entidades ORM con decoradores en TypeScript

Repository Pattern con TypeORM en NestJS

Relaciones uno a uno entre usuarios y perfiles en PostgreSQL

Actualización de DTOs con mapped types en NestJS para perfil y usuario

Generación automática de módulos CRUD con NestJS y AI

Relación uno a muchos con TypeORM

CRUD de categorías con IA en NestJS

Relaciones many-to-many con TypeORM y validación de arrays

Reutilización de servicios entre módulos en NestJS

Migraciones en TypeORM sin perder datos

Cómo evitar perder datos al migrar columnas

Autenticación y Autorización

Hashing de contraseñas con Bcrypt en NestJS

Excluir campos sensibles con ClassTransformer

Autenticación local con Passport en NestJS

Endpoint de login con Passport en NestJS

Implementación de JSON Web Token para autenticación en NestJS

Rutas protegidas con JWT en NestJS

User ID automático desde JWT en NestJS

Tu API Completa

Autogenera resúmenes e imágenes con OpenAI en NestJS

Documentación automática de APIs con Swagger en NestJS

Preparar tu API NestJS para producción

Desplegar aplicación Node.js a producción con Railway y PostgreSQL

Desarrollo de API REST escalable con NestJS en producción

Configuración de PostgreSQL con Docker y Docker Compose