Docker Health Build Validation

Validaciones:

• ✓ Builds completados sin errores
• ✓ Imágenes creadas correctamente
• ✓ Tamaños razonables (no tienen megabytes innecesarios)

3️⃣ Iniciar Servicios

docker-compose up -d

Esperar a que se estabilicen (15-30 segundos)

4️⃣ Verificar Servicios Corriendo

docker-compose ps

Todos deben estar en estado running (no exited o restarting)

5️⃣ Chequear Health Endpoints

Backend - Health Check General:

curl -s http://localhost:3001/api/health | jq .

Respuesta esperada:

{
  "status": "healthy",
  "timestamp": "...",
  "services": {
    "database": {"healthy": true},
    "qdrant": {"healthy": true},
    "redis": {"healthy": true}
  }
}

Backend - Health Database:

curl -s http://localhost:3001/api/health/database | jq .

Backend - Health Redis:

curl -s http://localhost:3001/api/health/redis | jq .

Backend - Health Qdrant:

curl -s http://localhost:3001/api/health/qdrant | jq .

Frontend - Page Load:

curl -s http://localhost:3011 | grep -q "title" && echo "✓ Frontend respondiendo"

6️⃣ Verificar Logs

# Últimas líneas de cada servicio
docker-compose logs backend --tail=20
docker-compose logs frontend --tail=20
docker-compose logs postgres --tail=10
docker-compose logs redis --tail=10
docker-compose logs qdrant --tail=10

Buscar errores críticos:

• ❌ Connection refused
• ❌ FATAL
• ❌ Error: Cannot find module
• ❌ Segmentation fault

7️⃣ Validar Volúmenes

# Verificar que los datos persisten
ls -la data/postgres/
ls -la data/redis/
ls -la data/qdrant/

8️⃣ Chequear Conectividad Inter-Servicios

# Backend puede conectar a DB desde dentro del container
docker-compose exec backend npm run typeorm -- query "SELECT 1"

# Backend puede contactar Redis
docker-compose exec backend redis-cli -h redis ping

# Backend puede contactar Qdrant
docker-compose exec backend curl -s http://qdrant:6333/health | jq .

9️⃣ Validar Variables de Entorno

docker-compose exec backend env | grep -E "GEMINI|QDRANT|DATABASE|REDIS|JWT"

Verificar que:

• ✓ Todas las vars necesarias están presentes
• ✓ Los valores son los esperados (no vacíos)
• ✓ Las URLs internas usan nombres de container (qdrant, postgres, redis)

🔟 Cleanup

Si todo pasó:

docker-compose down

Si hay errores, dejar containers corriendo para inspeccionar.

Salida Esperada

✅ DOCKER BUILD & HEALTH CHECK REPORT
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

📋 Configuración:
✓ docker-compose.yml sintaxis válida
✓ 5 servicios configurados correctamente

🏗️  Build:
✓ Backend image construida (125MB)
✓ Frontend image construida (850MB)

🚀 Servicios:
✓ postgres running
✓ redis running
✓ qdrant running
✓ backend running
✓ frontend running

❤️  Health Checks:
✓ Backend health: HEALTHY
  - Database: ✓
  - Qdrant: ✓
  - Redis: ✓
✓ Frontend respondiendo
✓ PostgreSQL: conectado
✓ Redis: ping OK
✓ Qdrant: health OK

💾 Volúmenes:
✓ data/postgres: 15MB
✓ data/redis: 2MB
✓ data/qdrant: 5MB

🌍 Conectividad:
✓ Backend↔Database OK
✓ Backend↔Redis OK
✓ Backend↔Qdrant OK

✅ TODO OK - LISTO PARA PRODUCCIÓN

O en caso de problemas:

❌ DOCKER VALIDATION FAILED
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

🔴 Backend build FALLÓ
   Error: Cannot find module '@nestjs/common'
   → Solución: Ejecutar npm install en backend/

🔴 postgres no inicia
   Error: FATAL: password authentication failed
   → Verificar DATABASE_PASSWORD en .env

⚠️  Frontend tardó mucho en cargar
   Consejo: Verificar memoria disponible

🔧 PRÓXIMOS PASOS:
1. Revisa los errores arriba
2. Ejecuta: docker-compose down -v
3. Soluciona los issues
4. Vuelve a ejecutar este check

Uso

Invoca este skill cuando quieras validar tu setup local:

"Valida que Docker funcione bien"
"Test docker build and health"
"¿Está todo correcto en Docker?"
"Antes de hacer push, validación de Docker"

Claude automáticamente ejecutará todas las validaciones y te reportará el estado.38:["$","$L40",null,{"content":"$41","frontMatter":{"name":"Docker Health & Build Validation","description":"Valida la configuración de Docker, construye imágenes y verifica que todos los servicios arranquen correctamente. Chequea health endpoints del backend, frontend y bases de datos.","trigger-phrases":["test docker","validate docker","docker health check","test build","docker-compose check"],"allowed-tools":["bash","read"]}}]