Node-RED: Authentik, URLs e IaC
Estado: desplegado 2026-08-04
Esta página registra la migración de autenticación y URL de River Oaks Node-RED.
Es una referencia operativa para TI, no un reemplazo de la configuración de origen
en el repositorio riveroaks/infra.
Estado actual
Los editores activos de River Oaks Node-RED están protegidos por Authentik OIDC y
son accesibles a través del namespace interno *.nodered.riveroaks.cc:
| Instancia | URL canónica del editor | Runtime |
|---|---|---|
| Studio | https://studio.nodered.riveroaks.cc |
VM studio-nr |
| MPR | https://mpr.nodered.riveroaks.cc |
VM mpr-nr |
| MDF | https://mdf.nodered.riveroaks.cc |
VM mdf-nr |
| Telegram | https://telegram.nodered.riveroaks.cc |
VM telegram-nr |
| DB | https://db.nodered.riveroaks.cc |
rocc-db-local en rocc-db |
La instancia DB es parte de esta migración. Sus rutas de navegador/editor requieren
Authentik, mientras que /public/... permanece disponible sin inicio de sesión de navegador para
llamadores existentes de Portal, webhooks y automatización.
La instancia histórica de Archivo no tiene backend activo y no fue restaurada ni incluida como objetivo en vivo.
Autenticación y política de red
- Authentik es el proveedor OIDC para cada editor activo.
- Cada aplicación Authentik de Node-RED está vinculada al grupo
IT. Los usuarios fuera deITno deben ser admitidos en el editor. - Un perfil de Authentik admitido recibe los permisos del editor de Node-RED
configurados en el
settings.jscorrespondiente. - El certificado comodín dedicado cubre
*.nodered.riveroaks.cc. - DNS interno apunta los hosts canónicos a
rocc-db(10.200.24.42). - Nginx permite solo rangos de red privada (
10/8,172.16/12y192.168/16) para las rutas canónicas del editor y deniega otras fuentes.
El editor está protegido en /. La excepción de DB está deliberadamente limitada a
/public; no elimine esa división sin auditar primero los llamadores de Portal y automatización.
Compatibilidad de URL
La migración no eliminó inmediatamente los nombres antiguos porque otros servicios pueden todavía contener URL de Node-RED. Los siguientes alias de compatibilidad permanecen en vigor y se verificaron durante la migración:
studio-nr.riveroaks.ccyedit-studio-nr.riveroaks.ccmpr-nr.riveroaks.ccyedit-mpr-nr.riveroaks.ccmdf-nr.riveroaks.ccyedit-mdf-nr.riveroaks.cctelegram-nr.riveroaks.ccyedit-telegram-nr.riveroaks.ccdb-nr.riveroaks.cc
El antiguo nombre DNS db.nodered.ro.church también se conserva para la limpieza de dependencias. Durante la migración de agosto, su borde externo heredado devolvió HTTP 403.
Una sonda externa el 2026-10-28 falló el reconocimiento del nombre de host TLS, por lo que esa respuesta histórica no es una garantía de salud actual. No es la URL canónica del editor interno. No lo elimine ni lo reoriente hasta que se hayan identificado los llamadores restantes.
Los llamadores activos de Portal se cambiaron a nombres canónicos .nodered.riveroaks.cc
en el repositorio riveroaks/portal. Home Assistant y cualquier otro propietario de automatización externa aún
necesitan ser verificados antes de que los alias de compatibilidad puedan ser retirados.
Fuente de verdad de Git e IaC
El repositorio riveroaks/infra
es el propietario de la configuración desplegable de Node-RED:
| Configuración | Ubicación del repositorio |
|---|---|
| Flujos, configuraciones, paquetes | nodered/instances/<instance>/ |
| Destino y comandos de despliegue | deploy/targets/nodered/ |
| Planos OIDC de Authentik | apps/authentik/blueprints/custom/*-nodered.yaml |
| Hosts virtuales de Nginx | nginx/hosts/rocc-db/sites-enabled/ |
| Fragmento de acceso a red privada | nginx/hosts/rocc-db/snippets/nodered-internal.conf |
Los archivos administrados incluyen flows.json, settings.js, package.json,
package-lock.json, la estrategia compartida de Authentik y la configuración del cliente
de Authentik del destino. Las credenciales, flows_cred.json, secretos de cliente, archivos de entorno, módulos instalados y otros secretos en tiempo de ejecución permanecen en el host y no deben ser confirmados.
Realizar un cambio en Node-RED
- Trate el editor/host como un lugar para probar o capturar un cambio, no como la fuente de verdad permanente.
- Exporte o copie el flujo/configuración resultante en el directorio
nodered/instances/<instance>/correspondiente. Elimine credenciales y secretos. - Actualice el manifiesto o plano correspondiente cuando el comportamiento del runtime o de la autenticación cambie.
- Ejecute la validación del repositorio y las comprobaciones de salud del destino.
- Abra una MR, revísela y despliegue desde la rama fusionada.
Un cambio de flujo o settings.js en el lado del editor que no se capture en Git es
deriva del runtime. Un despliegue posterior de IaC puede sobrescribir archivos administrados, así que registre los cambios importantes del editor antes de desplegar cualquier otra cosa en esa instancia.
El destino DB tiene una puerta de enlace de despliegue explícita DB_NODERED_MIGRATION porque
sus flujos tienen más dependencias. Debe desplegarse y verificarse al final cuando se realice un cambio en toda la flota.
Verificación y reversión
La migración de 2026 se completó a través de:
- IaC MR !56, fusionado como
7a149b3. - Portal MR !328, fusionado como
6001ce5. - Pipeline final de IaC merged-main 6060: todos los trabajos de validación, Nginx, despliegue de DB y verificación de Node-RED pasaron.
- Pipeline de Portal 6054: pruebas y despliegue pasaron.
Las comprobaciones posteriores al despliegue confirmaron:
- Los cinco editores canónicos devuelven la página de inicio de sesión de Authentik a través de TLS válido.
- Los alias heredados
.riveroaks.cctodavía responden. - Portal devuelve HTTP 200.
- Las sondas de compatibilidad de DB
/publicdevuelven la respuesta esperada de la aplicación sin redirigir al inicio de sesión del navegador. - Todas las comprobaciones de salud de Node-RED y los procesos PM2 están en línea.
El despliegue estuvo protegido por instantáneas de Proxmox llamadas
nodered-pre-merge-20260804-182845 para los VMID 100, 103, 104, 105 y
106. En rocc-db, se almacenaron archivos de respaldo pre-fusión solo para root bajo:
/root/nginx-preswap-backups/merge-pre-20260804-182845/
El mecanismo de despliegue también mantiene copias de seguridad por versión de los archivos administrados y
archivos de respaldo pre-fusión de Nginx. Utilice esas copias de seguridad o las instantáneas de Proxmox para una
reversión; no restaure flows_cred.json u otros secretos de Git.
Trabajo pendiente
- Auditar Home Assistant y otras automatizaciones externas en busca de URL antiguas de DB y
*.nodered.ro.church. - Mantener los alias de compatibilidad hasta que esos llamadores se migren y se observe que usan los nombres canónicos.
- Decidir si el antiguo borde
db.nodered.ro.churchdebe retirarse o convertirse en una ruta de compatibilidad interna intencional. - Continuar monitoreando la renovación del certificado comodín y las copias de seguridad normales de Proxmox.