🐳 Containerization - AudioLab Infrastructure¶

Infraestructura completa de contenedores Docker para AudioLab.

📂 Estructura¶

03_05_containerization/
├── 03_06_06_mkdocs_service/     # Servicio de documentación
├── 03_06_07_services_stack/     # Stack completo (Postgres, FossFLOW, MkDocs)
└── scripts/                      # Scripts de gestión

🚀 Inicio Rápido¶

1. Stack Completo¶

# Ir al directorio de scripts
cd scripts/

# Windows (PowerShell)
.\stack-manager.ps1 -Action start

# Linux/Mac
./stack-manager.sh start

2. Solo MkDocs¶

cd 03_06_06_mkdocs_service/
docker-compose up -d

📊 Servicios Disponibles¶

Servicio	Puerto	URL	Descripción
MkDocs	8000	http://localhost:8000	Documentación con navegación automática
FossFLOW	8080	http://localhost:8080	Editor de diagramas isométricos
PostgreSQL	5432	localhost:5432	Base de datos de metadata

🛠️ Scripts de Gestión¶

stack-manager (PowerShell/Bash)¶

# Ver estado
.\stack-manager.ps1 -Action status

# Iniciar servicios
.\stack-manager.ps1 -Action start

# Detener servicios
.\stack-manager.ps1 -Action stop

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

# Backup
.\stack-manager.ps1 -Action backup

backup-all.ps1¶

Backup completo de: - Volúmenes Docker - Configuraciones - Base de datos PostgreSQL

.\scripts\backup-all.ps1

🔄 Escaneo Automático de Jerarquía¶

El servicio MkDocs incluye escaneo automático de la estructura XX_YY_ZZ:

Nivel 0: 2 - FOUNDATION
Nivel 1: 03_INFRA
Nivel 2: 03_05_containerization
Nivel 3: 03_06_06_mkdocs_service

La navegación se genera dinámicamente al iniciar el contenedor.

🗄️ PostgreSQL Schema¶

Schemas incluidos: - audiolab - Plugins y componentes - metadata - Documentación y diagramas - analytics - Métricas de build

Ver detalles: 03_06_07_services_stack/README.md

🔐 Configuración de Secrets¶

# Copiar template
cd 03_06_07_services_stack/
cp .env.example .env

# Editar .env con credenciales seguras
# IMPORTANTE: Cambiar POSTGRES_PASSWORD

🎨 Integración FossFLOW¶

Los diagramas creados en FossFLOW se exportan automáticamente a:

07_META/03_documentation/docs/3_diagrams/

MkDocs los detecta y sirve como assets estáticos.

📋 CI/CD¶

Pipeline de GitHub Actions incluido: scripts/ci-build.yml

Copia a .github/workflows/ para activar:

mkdir -p .github/workflows/
cp scripts/ci-build.yml .github/workflows/build-docs.yml

🔍 Troubleshooting¶

Ver logs¶

docker-compose logs -f

Verificar red¶

docker network inspect audiolab_network

Reiniciar servicios¶

.\stack-manager.ps1 -Action restart

Verificar volúmenes¶

docker volume ls --filter name=audiolab