josedario87
aa5ac70c7c
- Agregado servicio mcp-docker con imagen docker:cli - Configurado MCP Gateway en modo streaming (puerto 8080) - Expuesto a través de Traefik sin autenticación Authentik - Montado socket de Docker en modo solo lectura - Agregada variable MCP_DOMAIN al .env.example - Actualizado README con documentación del servicio
63 lines
1.8 KiB
Markdown
63 lines
1.8 KiB
Markdown
# Nucleo Docs
|
|
|
|
Sistema de documentación para el ecosistema Nucleo basado en Nuxt 4 con autenticación mediante Authentik Proxy Outpost.
|
|
|
|
## Propósito
|
|
|
|
Este repositorio contiene la documentación del funcionamiento del sistema Nucleo, incluyendo:
|
|
- Arquitectura del sistema
|
|
- Guías de desarrollo
|
|
- Documentación de servicios
|
|
- Procedimientos operativos
|
|
|
|
## Estructura del Proyecto
|
|
|
|
```
|
|
.
|
|
├── nuxt4/ # Aplicación Nuxt 4 con la documentación
|
|
├── docker-compose.yml # Configuración de despliegue
|
|
└── .gitea/ # Gitea Actions CI/CD
|
|
```
|
|
|
|
## Características
|
|
|
|
- ✅ Nuxt 4
|
|
- ✅ Autenticación con Authentik Proxy Outpost
|
|
- ✅ Docker y Docker Compose
|
|
- ✅ CI/CD con Gitea Actions
|
|
- ✅ Traefik para proxy reverso y SSL
|
|
- ✅ Claude Code hooks para monitoreo de Actions
|
|
- ✅ MCP Server Docker para gestión de contenedores
|
|
|
|
## Servicios
|
|
|
|
### Aplicación Principal (`app`)
|
|
Aplicación Nuxt 4 con la documentación del sistema Nucleo, expuesta mediante Traefik con autenticación Authentik.
|
|
|
|
### MCP Docker Server (`mcp-docker`)
|
|
Servidor MCP oficial de Docker (`docker:cli`) que permite gestionar contenedores Docker mediante lenguaje natural. Este servicio:
|
|
- Usa el MCP Gateway en modo streaming (puerto 8080)
|
|
- Tiene acceso al socket de Docker del host (solo lectura)
|
|
- Se ejecuta en las redes `principal` y `traefik-network`
|
|
- **Expuesto públicamente a través de Traefik SIN autenticación Authentik**
|
|
- Accesible en el dominio configurado en `MCP_DOMAIN`
|
|
- Incluye soporte para WebSocket y streaming
|
|
|
|
## Desarrollo Local
|
|
|
|
```bash
|
|
cd nuxt4
|
|
npm install
|
|
npm run dev
|
|
```
|
|
|
|
## Despliegue
|
|
|
|
El proyecto se despliega automáticamente en `docs.nucleoriofrio.com` mediante Gitea Actions cuando se hace push a la rama `master`.
|
|
|
|
Variables y secrets configurados correctamente en Gitea.
|
|
|
|
## Licencia
|
|
|
|
MIT
|