226 lines
5.6 KiB
Markdown
226 lines
5.6 KiB
Markdown
# Estado de Despliegue de CLARA
|
|
|
|
**Actualizado:** 2025-12-23
|
|
**Por:** ARCHITECT
|
|
|
|
---
|
|
|
|
## 📊 Estado General
|
|
|
|
| Componente | Estado | Notas |
|
|
|------------|--------|-------|
|
|
| Código | ✅ Completo | Implementación lista |
|
|
| Docker | ✅ Configurado | docker-compose.yml listo |
|
|
| Credenciales | ✅ Generadas | .env con credenciales seguras |
|
|
| Tests | ✅ Incluidos | test_clara.sh disponible |
|
|
| Documentación | ✅ Completa | Múltiples guías |
|
|
| Despliegue DECK | ⏳ Pendiente | SSH bloqueado |
|
|
|
|
---
|
|
|
|
## 🎯 Servidor Objetivo: DECK
|
|
|
|
**IP:** 72.62.1.113
|
|
**Hostname:** tzzrdeck.me
|
|
**Rol:** Servidor personal - Log de entrada
|
|
|
|
---
|
|
|
|
## 📦 Paquete de Despliegue
|
|
|
|
### Ubicación en ARCHITECT
|
|
```
|
|
/home/orchestrator/clara-deployment-deck.tar.gz (16 KB)
|
|
```
|
|
|
|
### Método de transferencia
|
|
- Servidor HTTP: `http://69.62.126.110:8888/clara-deployment-deck.tar.gz`
|
|
- SSH: Bloqueado (requiere configuración)
|
|
- Alternativa: Acceso físico/consola
|
|
|
|
---
|
|
|
|
## 🔑 Credenciales Generadas
|
|
|
|
### H_INSTANCIA (Auth Key para PACKET)
|
|
```
|
|
87f6bdbf490b82435e9e804c115570efd70d3ccb7d89a5ee1ff1dde142151165
|
|
```
|
|
|
|
### PostgreSQL
|
|
- Usuario: `postgres`
|
|
- Password: `PGFRKChQrx3R27eImwRgg57syX2yWd7s+/VwCH2CQuo=`
|
|
- Base de datos: `tzzr`
|
|
|
|
### Cloudflare R2
|
|
- Endpoint: `https://7dedae6030f5554d99d37e98a5232996.r2.cloudflarestorage.com`
|
|
- Bucket: `deck`
|
|
- Access Key: `55125dca442b0f3517d194a5bc0502b8`
|
|
|
|
---
|
|
|
|
## 🚀 Instrucciones de Instalación
|
|
|
|
### En DECK, ejecutar:
|
|
|
|
```bash
|
|
# 1. Descargar paquete
|
|
wget http://69.62.126.110:8888/clara-deployment-deck.tar.gz
|
|
|
|
# 2. Descomprimir
|
|
tar xzf clara-deployment-deck.tar.gz
|
|
cd clara-deployment
|
|
|
|
# 3. Instalar automáticamente
|
|
sudo ./install-deck.sh
|
|
```
|
|
|
|
El script realiza:
|
|
- Verificación de dependencias
|
|
- Instalación en `/opt/clara`
|
|
- Configuración de PostgreSQL
|
|
- Inicio de servicios Docker
|
|
- Tests de verificación
|
|
- Creación de scripts de backup
|
|
|
|
---
|
|
|
|
## ✅ Verificación Post-Instalación
|
|
|
|
```bash
|
|
# Health check
|
|
curl http://localhost:5051/health
|
|
|
|
# Test de ingesta
|
|
curl -X POST http://localhost:5051/ingest \
|
|
-H "X-Auth-Key: 87f6bdbf490b82435e9e804c115570efd70d3ccb7d89a5ee1ff1dde142151165" \
|
|
-H "Content-Type: application/json" \
|
|
-d '{"id":"test-001","archivo_hash":"test-hash-001","origen":{"dispositivo":"test","timestamp_captura":"2025-12-23T20:00:00Z"},"archivo":{"tipo":"image/jpeg","categoria":"imagen"}}'
|
|
|
|
# Listar contenedores
|
|
curl http://localhost:5051/list \
|
|
-H "X-Auth-Key: 87f6bdbf490b82435e9e804c115570efd70d3ccb7d89a5ee1ff1dde142151165"
|
|
```
|
|
|
|
---
|
|
|
|
## 📱 Configuración de PACKET
|
|
|
|
Después del despliegue, configurar en PACKET:
|
|
|
|
**URL:**
|
|
```
|
|
http://72.62.1.113:5051/ingest
|
|
```
|
|
|
|
**Header:**
|
|
```
|
|
X-Auth-Key: 87f6bdbf490b82435e9e804c115570efd70d3ccb7d89a5ee1ff1dde142151165
|
|
```
|
|
|
|
---
|
|
|
|
## 📋 Pendientes
|
|
|
|
### Pre-despliegue
|
|
- [ ] Configurar SSH en DECK (puerto 22 bloqueado actualmente)
|
|
- [ ] O alternativamente: acceder por consola/físicamente
|
|
|
|
### Durante despliegue
|
|
- [ ] Transferir paquete a DECK
|
|
- [ ] Ejecutar `install-deck.sh`
|
|
- [ ] Verificar health check
|
|
- [ ] Ejecutar suite de tests
|
|
|
|
### Post-despliegue
|
|
- [ ] Configurar Nginx (opcional)
|
|
- [ ] Configurar SSL con Let's Encrypt (opcional)
|
|
- [ ] Configurar firewall
|
|
- [ ] Configurar backups automáticos
|
|
- [ ] Configurar PACKET
|
|
- [ ] Test end-to-end desde PACKET
|
|
- [ ] Monitoreo y alertas
|
|
|
|
### Desarrollo futuro
|
|
- [ ] Implementar MASON (enriquecimiento)
|
|
- [ ] Implementar FELDMAN (consolidación)
|
|
- [ ] Dashboard de visualización
|
|
- [ ] Integración con MARGARET (CORP)
|
|
|
|
---
|
|
|
|
## 📁 Archivos Relacionados
|
|
|
|
### En ARCHITECT
|
|
- `/home/orchestrator/clara-deployment/` - Directorio de despliegue
|
|
- `/home/orchestrator/clara-deployment-deck.tar.gz` - Paquete comprimido
|
|
- `/home/orchestrator/INSTRUCCIONES_DESPLIEGUE_CLARA.md` - Guía rápida
|
|
- `/home/orchestrator/CLARA_DEPLOYMENT_SUMMARY.md` - Resumen detallado
|
|
|
|
### En el paquete
|
|
- `install-deck.sh` - Script de instalación automática
|
|
- `DEPLOY_TO_DECK.md` - Guía completa de despliegue
|
|
- `.env` - Credenciales configuradas
|
|
- `docker-compose.yml` - Orquestación
|
|
- `app.py` - Servicio CLARA
|
|
- `init.sql` - Schema PostgreSQL
|
|
- `test_clara.sh` - Suite de tests
|
|
|
|
---
|
|
|
|
## 🔒 Seguridad
|
|
|
|
- ✅ Auth Key de 64 caracteres (SHA-256)
|
|
- ✅ Password de PostgreSQL aleatorio y seguro
|
|
- ✅ Credenciales R2 configuradas
|
|
- ⚠️ Se recomienda SSL para producción
|
|
- ⚠️ Configurar firewall para limitar acceso
|
|
|
|
---
|
|
|
|
## 📊 Servicios Desplegados
|
|
|
|
```
|
|
┌─────────────────────────────────┐
|
|
│ CLARA Service │
|
|
│ - Puerto: 5051 │
|
|
│ - Endpoints: │
|
|
│ * POST /ingest │
|
|
│ * GET /health │
|
|
│ * GET /query/{hash} │
|
|
│ * GET /list │
|
|
└────────────┬────────────────────┘
|
|
│
|
|
┌────────────▼────────────────────┐
|
|
│ PostgreSQL │
|
|
│ - Puerto: 5433 (externo) │
|
|
│ - Puerto: 5432 (interno) │
|
|
│ - Tabla: clara_log (JSONB) │
|
|
└─────────────────────────────────┘
|
|
```
|
|
|
|
---
|
|
|
|
## 🔄 Historial de Cambios
|
|
|
|
### 2025-12-23
|
|
- ✅ Implementación completa del código
|
|
- ✅ Generación de credenciales
|
|
- ✅ Creación de paquete de despliegue
|
|
- ✅ Script de instalación automática
|
|
- ✅ Documentación completa
|
|
- ✅ Servidor HTTP para transferencia
|
|
- ⏳ Pendiente: Transferencia a DECK
|
|
|
|
---
|
|
|
|
## 📞 Soporte
|
|
|
|
**ARCHITECT**
|
|
- Servidor: 69.62.126.110
|
|
- Gitea: https://git.tzzr.me/tzzr/clara
|
|
|
|
---
|
|
|
|
*Documento de estado - Sistema TZZR*
|