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 publico actual instala tres agentes:

• Discovery Agent
• Scaling Rules Agent
• Node Agent

Recursos publicos:

• Repositorio del chart Moonin Agent
• Repositorio Helm publico

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	Ejecucion de escalamiento temporal mediante HPA	Pods, Deployments y HPAs, mas los templates activos desde Moonin	Crea, actualiza o elimina HPAs administrados y puede actualizar replicas del Deployment durante apply o revert	Eventos de ejecucion y rollback
Node Agent	Observabilidad runtime de workloads en nodos Linux	Trafico runtime soportado, senales de proceso, metricas de cgroups y contexto Kubernetes del workload	No muta workloads	Eventos, trazas, dependencias, senales de error runtime y metricas

Como encaja el bundle en la plataforma

graph TD
    A[Consola de administracion<br/>registro del cluster] --> B[PROJECT_ID / CLUSTER_ID / CLUSTER_TOKEN]
    B --> C[Secret compartido de credenciales]
    C --> D[Discovery Agent]
    C --> E[Scaling Rules Agent]
    C --> F[Node Agent]
    K[API de Kubernetes] --> D
    K --> E
    K --> F
    D --> G[Discovery API]
    E --> H[Scaling Rules API]
    F --> J[Ingestion API]
    G --> I[app.moonin.app]
    H --> I
    J --> I

Ciclo de vida despues de instalar

1. El cluster se registra en la Consola de administracion 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 sincronizacion 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, imagenes, 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 cuales 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 ejecucion 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 esta disponible en los flujos de observabilidad de app.moonin.app.

Modelo operativo

• El chart publico 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 sincronizacion 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 documentacion

Pagina	Que cubre
Resumen de agentes	Ciclo de vida y modelo de decision de Discovery Agent y Scaling Rules Agent
Recoleccion de datos	Que sale del cluster, como se deriva y que evidencia de ejecucion se guarda
Node Agent	Captura de telemetria runtime, requisitos de host y como explorarla en app.moonin.app
Protocolos de comunicacion	Credenciales, flujos API, polling y patrones de request
Permisos requeridos	Alcance RBAC necesario por agente
Modelo de seguridad	Manejo de secretos, sanitizacion, ownership y seguridad del rollback
Limites y alcance	Limites intencionales, comportamiento best effort y lo que el bundle no hace