Bundle de agentes de Moonin

El bundle de agentes de Moonin es el paquete in-cluster soportado para conectar un cluster de Kubernetes con Moonin. El chart público actual instala tres agentes:

• Discovery Agent
• Scaling Rules Agent
• Node Agent

Recursos publicos:

• Repositorio del chart Moonin Agent
• Repositorio Helm público

Agentes actuales de un vistazo

Agente	Responsabilidad principal	Lee del cluster	Escribe en el cluster	Envia a Moonin
Discovery Agent	Inventario, topologia, revisiones, CronJobs, metadata de nodos y del cluster	Namespaces, nodes, pods, services, ConfigMaps, Secrets, Deployments, ReplicaSets, HPAs, Jobs, CronJobs, Ingresses, NetworkPolicies y algunos objetos RBAC	No muta workloads. Solo actualiza Lease de leader election	Inventario, revisiones, errores, CronJobs, ejecuciones de CronJob, snapshots de nodos y metadata del cluster
Scaling Rules Agent	Ejecución de escalamiento temporal mediante HPA	Pods, Deployments y HPAs, más los templates activos desde Moonin	Crea, actualiza o elimina HPAs administrados y puede actualizar replicas del Deployment durante apply o revert	Eventos de ejecución y rollback
Node Agent	Observabilidad runtime de workloads en nodos Linux	Trafico runtime soportado, señales de proceso, métricas de cgroups y contexto Kubernetes del workload	No muta workloads	Eventos, trazas, dependencias, señales de error runtime y métricas

Como encaja el bundle en la plataforma

Ciclo de vida después de instalar

1. El cluster se registra en la Consola de administración y recibe PROJECT_ID, CLUSTER_ID y CLUSTER_TOKEN.
2. El chart guarda esos valores en un Secret compartido y despliega los agentes en el namespace moonin-agent.
3. El Discovery Agent hace una sincronización inicial de namespaces, Deployments y CronJobs antes de pasar a monitoreo por informers y heartbeats periodicos.
4. El Discovery Agent mantiene actualizado a Moonin con revisiones, imágenes, snapshots de HPA, historial de CronJobs, snapshots de nodos y metadata del cluster.
5. El Scaling Rules Agent reconcilia cada 30 segundos, obtiene los templates del cluster, evalua cuáles deben correr y luego carga sus acciones.
6. Las acciones activas se aplican en orden priority_up. Si el Deployment objetivo no tiene HPA, el agente puede crear primero un HPA provisional administrado.
7. Los HPAs administrados se revierten en orden priority_down cuando termina la ventana de ejecución o cuando el template se deshabilita antes de terminarla.
8. Node Agent corre en nodos worker Linux seleccionados y envia telemetria runtime observada a Moonin, donde está disponible en los flujos de observabilidad de portal.moonin.app.

Modelo operativo

• El chart público usa por defecto dos replicas de Discovery Agent y una replica de Scaling Rules Agent.
• Node Agent es un DaemonSet: se programa un pod en cada nodo worker Linux seleccionado.
• Discovery usa leader election para que solo una replica ejecute las operaciones de sincronización que escriben en la plataforma al mismo tiempo.
• Todos los agentes reutilizan el mismo Secret de credenciales del cluster.
• El Scaling Rules Agent se puede deshabilitar si el cluster debe quedar solo en modo inventario.

Mapa de documentación

Página	Que cubre
Resumen de agentes	Ciclo de vida y modelo de decisión de Discovery Agent y Scaling Rules Agent
Recolección de datos	Que sale del cluster, como se deriva y que evidencia de ejecución se guarda
Node Agent	Captura de telemetria runtime, requisitos de host y como explorarla en portal.moonin.app
Protocolos de comunicación	Credenciales, flujos API, polling y patrones de request
Permisos requeridos	Alcance RBAC necesario por agente
Modelo de seguridad	Manejo de secretos, sanitización, ownership y seguridad del rollback
Límites y alcance	Límites intencionales, comportamiento best effort y lo que el bundle no hace