AudioLab Docker Services Setup¶

📋 Resumen de Servicios¶

Servicio	Puerto	Descripción	URL
MkDocs	8000	Documentación técnica	http://localhost:8000
FossFLOW	8080	Diagramas isométricos 3D	http://localhost:8080
Nexus	8081	Repository manager	http://localhost:8081
PostgreSQL	5432	Base de datos	-
PgAdmin	5433	Admin de BD	http://localhost:5433
Typesense	8108	Motor de búsqueda	http://localhost:8108

🚀 Instalación Rápida¶

1. Estructura de carpetas¶

06_BRAIN/06_docker/
├── services/
│   ├── fossflow/
│   │   └── docker-compose.yml
│   ├── mkdocs/
│   │   └── docker-compose.yml
│   ├── nexus/
│   │   └── docker-compose.yml
│   ├── postgres/
│   │   ├── docker-compose.yml
│   │   └── init/
│   │       └── init.sql
│   └── typesense/
│       └── docker-compose.yml
└── scripts/
    └── audiolab-stack.ps1

2. Copiar archivos¶

Copia cada archivo docker-compose.yml a su carpeta correspondiente en 06_BRAIN/06_docker/services/

3. Crear la red compartida¶

docker network create audiolab_network --subnet=172.25.0.0/16

4. Iniciar todos los servicios¶

cd 06_BRAIN/06_docker/scripts
.\audiolab-stack.ps1 -Action start -Service all

🎯 Uso del Script de Gestión¶

Comandos disponibles:¶

# Ver estado de todos los servicios
.\audiolab-stack.ps1 -Action status

# Iniciar servicios específicos
.\audiolab-stack.ps1 -Action start -Service docs    # Solo MkDocs y FossFLOW
.\audiolab-stack.ps1 -Action start -Service data    # Solo PostgreSQL y Typesense
.\audiolab-stack.ps1 -Action start -Service fossflow # Solo FossFLOW

# Detener servicios
.\audiolab-stack.ps1 -Action stop -Service all

# Reiniciar servicios
.\audiolab-stack.ps1 -Action restart -Service fossflow

# Ver logs
.\audiolab-stack.ps1 -Action logs -Service postgres

# Limpiar todo (¡cuidado!)
.\audiolab-stack.ps1 -Action clean

🔧 Configuración Individual¶

FossFLOW (Diagramas)¶

Puerto: 8080
Datos: volumes/fossflow_data
Iconos: 04_ASSETS/02_graphics/1_icons/
Templates: 04_ASSETS/03_templates/3_fossflow/

MkDocs (Documentación)¶

Puerto: 8000
Contenido: 07_META/03_documentation/
Config: mkdocs.yml

PostgreSQL (Base de datos)¶

Puerto: 5432
Usuario: audiolab
Password: audiolab_dev_2024
Base de datos: audiolab_main

PgAdmin (Admin BD)¶

Puerto: 5433
Email: admin@audiolab.local
Password: admin

Typesense (Búsqueda)¶

Puerto: 8108
API Key: audiolab_search_key_2024

Nexus (Repository)¶

Puerto: 8081
Admin inicial: admin
Password: Ver en /nexus-data/admin.password

📊 Verificar que todo funciona¶

Ejecuta:

.\audiolab-stack.ps1 -Action status

Deberías ver:

📊 ESTADO DE SERVICIOS
==================================================
  mkdocs (Documentación) - ✅ http://localhost:8000
  fossflow (Diagramas 3D) - ✅ http://localhost:8080
  nexus (Repository) - ✅ http://localhost:8081
  postgres (Base de datos) - ✅ http://localhost:5432
  pgadmin (Admin DB) - ✅ http://localhost:5433
  typesense (Búsqueda) - ✅ http://localhost:8108

🎨 Integración con AudioLab¶

Crear iconos para FossFLOW¶

04_ASSETS/02_graphics/1_icons/
├── 10_vector/fossflow/    → SVG icons
└── 11_raster/fossflow/    → PNG icons

Exportar diagramas a docs¶

07_META/03_documentation/docs/3_diagrams/
├── images/                → PNGs exportados
└── sources/               → JSONs originales

🚨 Troubleshooting¶

Si un servicio no inicia:¶

# Ver logs del servicio
docker logs audiolab_[servicio]

# Reiniciar servicio
.\audiolab-stack.ps1 -Action restart -Service [servicio]

Si el puerto está ocupado:¶

# Ver qué usa el puerto
netstat -an | findstr :[puerto]

# Cambiar el puerto en el docker-compose.yml correspondiente

Resetear todo:¶

# ⚠️ Esto borra TODO
.\audiolab-stack.ps1 -Action clean

# Volver a empezar
docker network create audiolab_network
.\audiolab-stack.ps1 -Action start -Service all

📝 Notas Importantes¶

Desarrollo: Estos servicios son para desarrollo local, no para producción
Seguridad: Las contraseñas son básicas, cambiarlas para cualquier uso serio
Backup: Los volúmenes Docker persisten datos, pero hacer backups regulares
Recursos: Todos los servicios juntos pueden usar ~4GB RAM

🎯 Próximos Pasos¶

Accede a FossFLOW: http://localhost:8080
Importa los diagramas de ejemplo (JSONs creados anteriormente)
Verifica MkDocs: http://localhost:8000
Configura Nexus para tus artifacts

¿Problemas? Revisa los logs con .\audiolab-stack.ps1 -Action logs -Service [servicio]