rmonla/dtic-DIIAA
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

[Docs] Optimización Bitácora y Configuración Homepage

Browse Source
This commit is contained in:
Ricardo Monla
2026-02-16 15:07:18 -03:00
parent 7fe5041088
commit 005b668481
17 changed files with 268 additions and 35 deletions
Download Patch File Download Diff File Expand all files Collapse all files
adn/00_bitacora.md
+33 -30
View File
@@ -2,40 +2,43 @@
Este documento registra la evolución, cambios y eventos significativos en el servidor `srv-NS8`.
> **Estados:** ✅ Completado | ⏳ En Proceso | 🧪 Verificado | ⚠️ Alerta | 📍 Definido
## 2026-02-16
| Hora | E | Acción | Detalle |
| :--- | :--- | :--- | :--- |
| 14:10 | ✅ | Optimización Dashboard | **Exitoso**. Reorganización de `homepage` en 3 columnas (Infra, Gestión, Apps) mediante ajuste de `settings.yaml`. Corrección de widgets Portainer (Auth) y Uptime Kuma (URL). |
| 13:00 | ✅ | Implementación Homepage | **Exitoso**. Despliegue de `gethomepage` en `servicios/homepage`. Integración con Proxmox API, Portainer y logs. Sustitución de página default Nginx por Dashboard dinámico. |
## 2026-02-15
| Hora | Acción | Detalle | Estado |
| Hora | E | Acción | Detalle |
| :--- | :--- | :--- | :--- |
| 21:55 | Consolidación ADN | Se actualiza `01_ontologia.md` con la nueva arquitectura de acceso remoto (Tailscale + RustDesk) y manual de conexión. | Completado |
| 21:35 | Implementación Acceso Remoto | **Exitoso**. Se instala Tailscale (IP `100.88.252.26`) y se verifica RustDesk nativo. Se establece solución de doble capa (Red VPN + GUI). | Completado |
| 20:50 | Sincronización Inicial Repo | **Exitoso**. Se crea `.gitignore` para excluir datos volátiles y se realiza el primer commit masivo de ADN, Scripts y Servicios. | Completado |
| 21:55 | ✅ | Consolidación ADN | Se actualiza `01_ontologia.md` con la nueva arquitectura de acceso remoto (Tailscale + RustDesk) y manual de conexión. |
| 21:35 | ✅ | Implementación Acceso Remoto | **Exitoso**. Se instala Tailscale (IP `100.88.252.26`) y se verifica RustDesk nativo. Se establece solución de doble capa (Red VPN + GUI). |
| 20:50 | ✅ | Sincronización Inicial Repo | **Exitoso**. Se crea `.gitignore` para excluir datos volátiles y se realiza el primer commit masivo de ADN, Scripts y Servicios. |
## 2026-02-11
| Hora | Acción | Detalle | Estado |
| Hora | E | Acción | Detalle |
| :--- | :--- | :--- | :--- |
| 23:25 | Configuración SSL y Reverse Proxy | **Exitoso**. Certificado Let's Encrypt instalado para `ns8.frlr.utn.edu.ar`. Nginx configurado como Reverse Proxy para servir `/portainer/`, `/sysacad/`, `/bitacoras/` bajo HTTPS (Puerto 443), eliminando la necesidad de exponer puertos inseguros. | Completado |
| 23:15 | Configuración Red Híbrida | **Exitoso**. Se ejecuta `configurar_red_hibrida.sh`. El servidor mantiene gateway `10.x` para salida, pero responde correctamente a la IP pública `190.x` mediante Policy Routing. Mecanismo de rollback verificado. | Completado |
| 23:10 | Protocolo de Seguridad | Se incorpora la **Directiva 5: Protocolo de Seguridad de Red (Hombre Muerto)** en `adn/02_protocolo.md`, haciendo obligatorio el uso de mecanismos de reversión automática para cambios de red. | Completado |
| 23:00 | Instalación Nginx Nativo | **Completado**. El usuario ejecutó `instalar_nginx_simple.sh`. Nginx está activo en el Host (Puerto 80) funcionando como Proxy Reverso para Portainer, Bitácoras y SysACAD. | Completado |
| 22:55 | Resolución Conflicto Puerto | Se reconfigura SysACAD para usar puertos 8080/8443, liberando el puerto 80 del host. | Solucionado |
| 22:50 | Saneamiento y Simplificación | Se eliminan scripts de migración de IP complejos por riesgo innecesario. Se consolida `scripts/instalar_nginx_simple.sh` para instalación nativa sin alterar la red. | Completado |
| 22:45 | Cambio de Estrategia: Nginx Nativo | Se decide eliminar el contenedor `proxy` (Docker) y reemplazarlo por **Nginx Nativo** en el host (`10.0.10.8`), manteniendo la configuración de red actual del servidor. | En Proceso |
| 22:15 | Documentación de Red | Se detalla la **Topología de Red** en `adn/01_ontologia.md`. Se aclara el uso de `macvlan` para la IP pública `190.114.205.18` y la IP privada `10.0.10.8` para el host. | Completado |
| 22:10 | Mantenimiento | Se actualiza **Portainer** a la última versión disponible (detectada 2.33.7). Se descargan imágenes y se recrea el contenedor. | Completado |
| 22:05 | Documentación de Accesos | Se incorpora la tabla de **Puntos de Acceso (URLs)** en `adn/01_ontologia.md` para facilitar la navegación a los servicios. | Completado |
| 22:00 | Reactivación de Servicios | Se levantan exitosamente `portainer`, `proxy` (tras corregir conflicto de red), `bitacoras` y `sysacad`. Todos los contenedores operativos y limitados en recursos. | Completado |
| 21:50 | Validación de Servicios | Se ejecutan pruebas de configuración (`docker compose config`) exitosas para todos los servicios migrados. Límites de memoria confirmados correctos. | Verificado |
| 21:40 | Optimización de Recursos | Se completa la migración de archivos (incluidos `.env` y ocultos). Se aplican límites de memoria RAM a los servicios Docker para proteger la VM. | Completado |
| 21:35 | Centralización de Servicios | Se mueven las configuraciones de `portainer`, `bitacoras`, `sysacad` y `proxy` a `dtic-srv-NS8/servicios/`. Se ajusta contexto de build del proxy. Se crean referencias `LEEME_MIGRACION.md` en origen. | Completado |
| 21:22 | Definición de Prioridades | Se establece la VM `PCV_DTIC-RRHH_W732` como servicio **Crítico/Permanente**. Se define el objetivo de **Optimizar** los servicios Docker (no solo reactivar). | Definido |
| 21:15 | Relevamiento Técnico | Se detectan redes Docker sin contenedores activos (`bitacoras`, `sysacad`, `portainer`). VM VirtualBox consume ~4GB RAM. | Alerta |
| 21:07 | Protocolo de Armonía | Se incorpora la directiva de **Armonía y Auto-optimización** en `adn/02_protocolo.md`. | Completado |
| 21:05 | Establecimiento de Protocolo | Se define el **español** como idioma obligatorio. Se crea `adn/02_protocolo.md`. | Completado |
| 21:01 | Inicio del Relevamiento | Inicialización del repositorio y estructura de directorios `adn`, `docs`, `scripts`. | En proceso |
| 23:25 | ✅ | Configuración SSL y Reverse Proxy | **Exitoso**. Certificado Let's Encrypt instalado para `ns8.frlr.utn.edu.ar`. Nginx configurado como Reverse Proxy para servir `/portainer/`, `/sysacad/`, `/bitacoras/` bajo HTTPS (Puerto 443), eliminando la necesidad de exponer puertos inseguros. |
| 23:15 | ✅ | Configuración Red Híbrida | **Exitoso**. Se ejecuta `configurar_red_hibrida.sh`. El servidor mantiene gateway `10.x` para salida, pero responde correctamente a la IP pública `190.x` mediante Policy Routing. Mecanismo de rollback verificado. |
| 23:10 | ✅ | Protocolo de Seguridad | Se incorpora la **Directiva 5: Protocolo de Seguridad de Red (Hombre Muerto)** en `adn/02_protocolo.md`, haciendo obligatorio el uso de mecanismos de reversión automática para cambios de red. |
| 23:00 | ✅ | Instalación Nginx Nativo | **Completado**. El usuario ejecutó `instalar_nginx_simple.sh`. Nginx está activo en el Host (Puerto 80) funcionando como Proxy Reverso para Portainer, Bitácoras y SysACAD. |
| 22:55 | ✅ | Resolución Conflicto Puerto | Se reconfigura SysACAD para usar puertos 8080/8443, liberando el puerto 80 del host. |
| 22:50 | ✅ | Saneamiento y Simplificación | Se eliminan scripts de migración de IP complejos por riesgo innecesario. Se consolida `scripts/instalar_nginx_simple.sh` para instalación nativa sin alterar la red. |
| 22:45 | ✅ | Cambio de Estrategia: Nginx Nativo | Se decide eliminar el contenedor `proxy` (Docker) y reemplazarlo por **Nginx Nativo** en el host (`10.0.10.8`), manteniendo la configuración de red actual del servidor. |
| 22:15 | ✅ | Documentación de Red | Se detalla la **Topología de Red** en `adn/01_ontologia.md`. Se aclara el uso de `macvlan` para la IP pública `190.114.205.18` y la IP privada `10.0.10.8` para el host. |
| 22:10 | ✅ | Mantenimiento | Se actualiza **Portainer** a la última versión disponible (detectada 2.33.7). Se descargan imágenes y se recrea el contenedor. |
| 22:05 | ✅ | Documentación de Accesos | Se incorpora la tabla de **Puntos de Acceso (URLs)** en `adn/01_ontologia.md` para facilitar la navegación a los servicios. |
| 22:00 | ✅ | Reactivación de Servicios | Se levantan exitosamente `portainer`, `proxy` (tras corregir conflicto de red), `bitacoras` y `sysacad`. Todos los contenedores operativos y limitados en recursos. |
| 21:50 | 🧪 | Validación de Servicios | Se ejecutan pruebas de configuración (`docker compose config`) exitosas para todos los servicios migrados. Límites de memoria confirmados correctos. |
| 21:40 | ✅ | Optimización de Recursos | Se completa la migración de archivos (incluidos `.env` y ocultos). Se aplican límites de memoria RAM a los servicios Docker para proteger la VM. |
| 21:35 | ✅ | Centralización de Servicios | Se mueven las configuraciones de `portainer`, `bitacoras`, `sysacad` y `proxy` a `dtic-srv-NS8/servicios/`. Se ajusta contexto de build del proxy. Se crean referencias `LEEME_MIGRACION.md` en origen. |
| 21:22 | 📍 | Definición de Prioridades | Se establece la VM `PCV_DTIC-RRHH_W732` como servicio **Crítico/Permanente**. Se define el objetivo de **Optimizar** los servicios Docker (no solo reactivar). |
| 21:15 | ✅ | Relevamiento Técnico | Se detectan redes Docker sin contenedores activos (`bitacoras`, `sysacad`, `portainer`). VM VirtualBox consume ~4GB RAM. |
| 21:07 | ✅ | Protocolo de Armonía | Se incorpora la directiva de **Armonía y Auto-optimización** en `adn/02_protocolo.md`. |
| 21:05 | ✅ | Establecimiento de Protocolo | Se define el **español** como idioma obligatorio. Se crea `adn/02_protocolo.md`. |
| 21:01 | ✅ | Inicio del Relevamiento | Inicialización del repositorio y estructura de directorios `adn`, `docs`, `scripts`. |
adn/01_ontologia.md
+2 -1
View File
@@ -32,6 +32,7 @@ Este documento define la identidad, propósito y componentes principales del ser
- **`nginx` (Nativo - Proxy Reverso)**
- `bitacoras` (App + DB)
- `sysacad` (App + Nginx interno)
- **`homepage` (Dashboard Unificado)**
- **Protección de Recursos**: Límites de RAM aplicados.
### 3. Acceso Remoto Seguro (Capa de Invisibilidad)
@@ -44,7 +45,7 @@ Este documento define la identidad, propósito y componentes principales del ser
### 4. Puntos de Acceso (URLs)
| Servicio | URL Pública (SSL) | URL Interna (Tailscale) | Descripción |
| :--- | :--- | :--- | :--- |
| **Portal Principal** | `https://ns8.frlr.utn.edu.ar` | `https://100.88.252.26` | Página de bienvenida Nginx |
| **Portal Principal** | `https://ns8.frlr.utn.edu.ar` | `https://100.88.252.26` | **Dashboard Unificado (Homepage)** |
| **Portainer** | `https://ns8.frlr.utn.edu.ar/portainer/` | `http://100.88.252.26:9000` | Gestión de Contenedores |
| **SysACAD** | `https://ns8.frlr.utn.edu.ar/sysacad/` | `http://100.88.252.26:8080` | Sistema Académico |
| **Bitácoras** | `https://ns8.frlr.utn.edu.ar/bitacoras/` | `http://100.88.252.26:5173` | Sistema de Bitácoras |
adn/02_protocolo.md
+12 -1
View File
@@ -26,9 +26,9 @@ Este documento establece las reglas fundamentales para la interacción, document
- **Orden**: Descendente (lo más reciente arriba).
- **Columnas Obligatorias**:
- `Hora` (HH:MM)
- `E` (Estado/Icono)
- `Acción`
- `Detalle/Impacto`
- `Estado`
@@ -42,3 +42,14 @@ Este documento establece las reglas fundamentales para la interacción, document
2. Esperar confirmación explícita del usuario (ej: presionar una tecla) durante un tiempo prudencial (5 minutos).
3. **Si no hay confirmación**: Revertir cambios inmediatamente y restaurar estado anterior.
4. **Si hay confirmación**: Hacer cambios persistentes.
## 6. Referencia de Estados (Bitácora)
Para optimizar espacio horizontal, la columna `Estado` utiliza los siguientes iconos:
| Icono | Significado | Descripción |
| :---: | :--- | :--- |
| ✅ | **Completado** | Tarea finalizada o problema solucionado exitosamente. |
| ⏳ | **En Proceso** | Tarea iniciada pero pendiente de cierre. |
| 🧪 | **Verificado** | Validación técnica o prueba superada. |
| ⚠️ | **Alerta** | Problema detectado, riesgo o atención requerida. |
| 📍 | **Definido** | Hito establecido o prioridad fijada sin ejecución inmediata. |
docs/prompt-00_install_msp_notebooklm.md
+44
View File
@@ -0,0 +1,44 @@
¡Vamos a conectarnos con NotebookLM!
Objetivo: instalar y dejar operativo el MCP server de NotebookLM para que aparezca como conectado en Manage MCP servers y exponga ≥ 32 herramientas (incluida la herramienta para crear notebooks/cuadernos).
Procedimiento (estricto, sin saltos):
1. Diagnóstico del entorno
• Detecta sistema operativo, shell y versión de Python.
• Comprueba si hay un entorno virtual activo.
2. Instalación del servidor MCP
• Si uv está disponible, instala con: uv pip install -U notebooklm-mcp-server.
• Si no, usa: python -m pip install -U notebooklm-mcp-server.
• Confirma la instalación mostrando la versión instalada.
3. Registro del MCP en Antigravity
• Localiza el archivo de configuración MCP usado por Antigravity (ruta real en este sistema).
• Haz copia de seguridad del archivo antes de modificarlo.
• Añade el servidor notebooklm sin sobrescribir otros MCP servers ya definidos.
• Valida que el JSON final sea sintácticamente correcto.
4. Autenticación
• Ejecuta notebooklm-mcp-auth.
• Abre el navegador y guíame paso a paso hasta completar permisos.
• El usuario solo debe iniciar sesión desde el navegador, evita pasos adiocionales o complejos.
• Verifica que las credenciales se guardaron correctamente (sin mostrar secretos).
5. Arranque y visibilidad en la UI
• Inicia el MCP server de NotebookLM.
• Confirma que aparece como activo/conectado en Manage MCP servers.
6. Validación de herramientas (obligatoria)
• Lista todas las herramientas expuestas por el MCP.
• Confirma que hay ≥ 32 herramientas.
• Identifica explícitamente la herramienta para crear notebooks/cuadernos (nombre exacto).
7. Prueba funcional
• Ejecuta una llamada de prueba que liste mis notebooks de NotebookLM.
• Muestra el resultado.
Reglas:
• Muestra los comandos exactos ejecutados.
• Si ocurre un error: detén el proceso, explica la causa y aplica la corrección antes de continuar.
• No avances al siguiente paso sin validar el anterior.
Criterio de éxito:
• MCP visible y conectado en Manage MCP servers.
• ≥ 32 tools disponibles, incluida crear notebook.
• Autenticación completada sin errores.
• Prueba: listado real de notebooks OK.
• Confirmación final: “instalación operativa”.
scripts/respaldar_configs.sh
Regular → Executable
+1
View File
@@ -23,6 +23,7 @@ PATHS=(
"/home/rmonla/.config/rustdesk"
"/var/lib/tailscale"
"/etc/nginx"
"/home/rmonla/Documentos/GitHub/dtic-srv-NS8/servicios/homepage/.env"
)
for SRC in "${PATHS[@]}"; do
servicios/homepage/config/bookmarks.yaml
+16
View File
@@ -0,0 +1,16 @@
- Developer:
- rmGithub:
- abbr: rmGH
href: https://github.com/rmonla
- Social:
- Reddit:
- abbr: RE
href: https://reddit.com/
- Entertainment:
- YouTube:
- abbr: YT
href: https://youtube.com/
- Documentación:
- gethomepage.dev:
- icon: homepage.png
- href: https://gethomepage.dev/
servicios/homepage/config/custom.css
View File
servicios/homepage/config/custom.js
View File
servicios/homepage/config/docker.yaml
+10
View File
@@ -0,0 +1,10 @@
---
# For configuration options and examples, please see:
# https://gethomepage.dev/configs/docker/
# my-docker:
# host: 127.0.0.1
# port: 2375
# my-docker:
# socket: /var/run/docker.sock
servicios/homepage/config/endpoints.json
+1
View File
File diff suppressed because one or more lines are too long
servicios/homepage/config/kubernetes.yaml
+2
View File
@@ -0,0 +1,2 @@
---
# sample kubernetes config
servicios/homepage/config/proxmox.yaml
+5
View File
@@ -0,0 +1,5 @@
---
# pve:
# url: https://proxmox.host.or.ip:8006
# token: username@pam!Token ID
# secret: secret
servicios/homepage/config/services.yaml
+85
View File
@@ -0,0 +1,85 @@
- Infraestructura Virtual:
- Proxmox 1:
icon: proxmox.png
href: "https://pmox.frlr.utn.edu.ar:8006"
description: Nodo 1
widget:
type: proxmox
url: "{{HOMEPAGE_VAR_PROXMOX1_URL}}"
username: "{{HOMEPAGE_VAR_PROXMOX1_USER}}"
password: "{{HOMEPAGE_VAR_PROXMOX1_API_KEY}}"
node: pmox1
- Proxmox 2:
icon: proxmox.png
href: "https://pmox.frlr.utn.edu.ar:8006"
description: Nodo 2
widget:
type: proxmox
url: "{{HOMEPAGE_VAR_PROXMOX1_URL}}"
username: "{{HOMEPAGE_VAR_PROXMOX1_USER}}"
password: "{{HOMEPAGE_VAR_PROXMOX1_API_KEY}}"
node: pmox2
- Proxmox 3:
icon: proxmox.png
href: "https://pmox.frlr.utn.edu.ar:8006"
description: Nodo 3
widget:
type: proxmox
url: "{{HOMEPAGE_VAR_PROXMOX1_URL}}"
username: "{{HOMEPAGE_VAR_PROXMOX1_USER}}"
password: "{{HOMEPAGE_VAR_PROXMOX1_API_KEY}}"
node: pmox3
- SSH/Terminal:
icon: si-gnumetalshell # SimpleIcons
href: "#"
description: Acceso NS8
- Gestión de Servicios:
- Monitor UPT Kuma:
icon: uptime-kuma.png
href: "http://upt.frlr.utn.edu.ar/status/servicios"
description: Status General
widget:
type: uptimekuma
url: "{{HOMEPAGE_VAR_UPTIMEKUMA_URL}}"
slug: "{{HOMEPAGE_VAR_UPTIMEKUMA_SLUG}}"
- Portainer srv-NS8:
icon: portainer.png
href: "https://ns8.frlr.utn.edu.ar/portainer/"
description: Gestión de contenedores
widget:
type: portainer
url: "http://172.17.0.1:9000"
env: 3
key: "{{HOMEPAGE_VAR_PORTAINER_API_KEY}}"
- rmGhDocker:
icon: si-github-#181717 # SimpleIcons
href: "https://github.com/rmonla/rmDocker"
description: Scripts de despliegue
- Aplicaciones y Herramientas:
- Eventos UTNLR:
icon: google-calendar.png
href: "https://calendar.google.com/calendar/u/0/r?cid=s4nnn9vr3vnt1llq7ir7nuu7dg@group.calendar.google.com"
description: Calendario Institucional
widget:
type: calendar
view: agenda
maxEvents: 5
showTime: true
integrations:
- type: ical
url: https://calendar.google.com/calendar/ical/s4nnn9vr3vnt1llq7ir7nuu7dg%40group.calendar.google.com/public/basic.ics
name: Institucional
- Bitácoras:
icon: si-notebook # SimpleIcons
href: "https://ns8.frlr.utn.edu.ar/bitacoras/"
description: Registro de actividades
- SysACAD:
icon: mdi-bookshelf-#FFB441 # MDI Icons
href: "https://ns8.frlr.utn.edu.ar/sysacad/"
description: Sistema Académico
- GEMA Chatbot:
icon: si-google-gemini # SimpleIcons
href: "#"
description: Asistente GEMA
servicios/homepage/config/settings.yaml
+20
View File
@@ -0,0 +1,20 @@
title: NS8 Dashboard
background:
image: https://cdnb.artstation.com/p/assets/images/images/006/897/659/large/mikael-gustafsson-wallpaper-mikael-gustafsson.jpg
blur: sm
saturate: 100
brightness: 50
opacity: 100
theme: dark
color: slate
useEqualHeights: true
layout:
Infraestructura Virtual:
columns: 2
Gestión de Servicios:
columns: 1
Aplicaciones y Herramientas:
columns: 2
servicios/homepage/config/widgets.yaml
+11
View File
@@ -0,0 +1,11 @@
- datetime:
text_size: xl
format:
dateStyle: long
timeStyle: short
hour12: false
- resources:
label: Sistema
cpu: true
memory: true
disk: /
servicios/homepage/docker-compose.yml
+16
View File
@@ -0,0 +1,16 @@
services:
homepage:
image: ghcr.io/gethomepage/homepage:latest
container_name: homepage
ports:
- 3001:3000
volumes:
- ./config:/app/config
- /var/run/docker.sock:/var/run/docker.sock:ro
env_file:
- .env
environment:
PUID: 1000
PGID: 1000
HOMEPAGE_ALLOWED_HOSTS: "ns8.frlr.utn.edu.ar,127.0.0.1,localhost,10.0.10.8,190.114.205.18,srvns8.tail982245.ts.net"
restart: unless-stopped
servicios/nginx/conf.d/ns8.conf
+10 -3
View File
@@ -1,11 +1,15 @@
server {
server_name ns8.frlr.utn.edu.ar;
server_name ns8.frlr.utn.edu.ar 100.88.252.26 190.114.205.18 srvns8.tail982245.ts.net;
root /var/www/html;
index index.html index.htm index.nginx-debian.html;
location / {
try_files $uri $uri/ =404;
proxy_pass http://127.0.0.1:3001/;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
# Portainer
@@ -15,6 +19,9 @@ server {
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
# SysACAD
@@ -49,7 +56,7 @@ server {
listen 80;
server_name ns8.frlr.utn.edu.ar;
server_name ns8.frlr.utn.edu.ar 100.88.252.26 190.114.205.18 srvns8.tail982245.ts.net;
return 404; # managed by Certbot