Servicios compartidos para desarrollo local: bases de datos, caché y captura de correo. Todos corren en contenedores con Docker Compose y se conectan a una red común (shared-network) para que los proyectos los puedan usar.
Esta copia vive en
~/.docker-services/y ya no está ligada al repositorio de origen. Los cambios se hacen directamente aquí.
| Servicio | Imagen | Puerto(s) | Uso |
|---|---|---|---|
| PostgreSQL | postgres:17 |
5432 |
Base de datos principal |
| MySQL | mysql:8.0 |
3306 |
Base de datos MySQL |
| Redis | redis:7-alpine |
6379 |
Caché / colas |
| Mailpit | axllent/mailpit |
1025 (SMTP), 8025 (web) |
Captura los correos que envían las apps |
Todos los contenedores usan restart: unless-stopped: arrancan solos con Docker hasta que los detengas a mano.
.docker-services/
├── README.md
└── services/
├── docker-compose.yml # Definición de los servicios
├── .env.example # Plantilla de variables
├── .env # Tus credenciales (se crea a partir del ejemplo)
└── init-scripts/
└── 01-create-databases.sql # Bases de PostgreSQL que se crean al iniciar
cd ~/.docker-services/services
# 1. Crear el archivo de variables y ajustar las credenciales
cp .env.example .env
$EDITOR .env
# 2. Levantar los servicios
docker compose up -d
# 3. Revisar que estén corriendo
docker compose ps| Variable | Descripción |
|---|---|
POSTGRES_DB |
Base de datos que se crea por defecto en PostgreSQL |
POSTGRES_USER |
Usuario de PostgreSQL |
POSTGRES_PASSWORD |
Contraseña de PostgreSQL |
MYSQL_ROOT_PASSWORD |
Contraseña del usuario root de MySQL |
PGADMIN_EMAIL / PGADMIN_PASSWORD |
Reservadas para pgAdmin (todavía no hay un servicio que las use) |
Desde el equipo (apps que corren fuera de Docker), usa localhost:
| Servicio | Conexión |
|---|---|
| PostgreSQL | postgresql://$POSTGRES_USER:$POSTGRES_PASSWORD@localhost:5432/<base> |
| MySQL | mysql://root:$MYSQL_ROOT_PASSWORD@localhost:3306/<base> |
| Redis | redis://localhost:6379 |
| Mailpit SMTP | host localhost, puerto 1025, sin autenticación ni TLS |
| Mailpit web | http://localhost:8025 |
Desde otro contenedor, únelo a la red shared-network y usa el nombre del contenedor como host (postgres, mysql, redis, mailpit):
# docker-compose.yml de tu proyecto
services:
app:
# ...
networks:
- shared-network
networks:
shared-network:
external: trueinit-scripts/01-create-databases.sql crea estas bases si no existen:
ticketsreportskendotest
Para agregar otra, copia uno de los bloques del archivo:
SELECT 'CREATE DATABASE mi_base'
WHERE NOT EXISTS (
SELECT FROM pg_database WHERE datname = 'mi_base'
)\gexecImportante: PostgreSQL solo ejecuta los scripts de
init-scripts/la primera vez, cuando el volumen de datos está vacío. Si el volumen ya existe, crea la base a mano:docker exec -it postgres sh -c 'psql -U "$POSTGRES_USER" -c "CREATE DATABASE mi_base;"'o reinicia desde cero (borra todos los datos de PostgreSQL):
docker compose down docker volume rm services_postgres-data docker compose up -d
Los datos se guardan en volúmenes de Docker con nombre: postgres-data, mysql-data y redis-data. Compose les antepone el nombre del proyecto (por defecto, el de la carpeta: services_postgres-data, etc.). Sobreviven a docker compose down, pero no a docker compose down -v.
docker volume ls | grep services_Ejecútalos desde ~/.docker-services/services:
docker compose up -d # Levantar todo
docker compose up -d postgres # Levantar solo un servicio
docker compose stop # Detener sin borrar contenedores
docker compose down # Detener y borrar contenedores (los datos se conservan)
docker compose logs -f postgres # Ver los logs de un servicio
docker compose pull && docker compose up -d # Actualizar imágenes
docker exec -it postgres sh -c 'psql -U "$POSTGRES_USER"' # Consola de PostgreSQL
docker exec -it mysql mysql -uroot -p # Consola de MySQL
docker exec -it redis redis-cli # Consola de Redisport is already allocated: otro proceso usa el puerto (por ejemplo, un PostgreSQL instalado en el sistema). Detenlo o cambia el puerto del lado del host endocker-compose.yml("5433:5432").network shared-network not founden otro proyecto: levanta primero estos servicios, que son los que crean la red.- No aparece una base de datos nueva: revisa la nota sobre
init-scriptsmás arriba.