KubeBolt docs
ENES GitHub

Configuración

Multiclúster

Contextos de kubeconfig, clústeres conectados con agente y clústeres solo de métricas en un único registro persistente.

En esta página
  1. Tipos de conexión
  2. Cambiar el nombre
  3. Cambiar de clúster
  4. Agentes desactualizados
  5. API

Tipos de conexión

El registro de clústeres mezcla tres tipos de clústeres:

El registro es persistente: los kubeconfigs subidos y los clústeres conectados con agente sobreviven a los reinicios, y un clúster conectado con agente sigue en la lista, sin contacto, mientras su agente no está, hasta que un admin lo borra. En el selector, los clústeres solo de métricas llevan la insignia Monitored-only.

Cambiar el nombre

Cualquier clúster se puede renombrar desde la UI (solo admin). Los nombres visibles se guardan en el registro. En KubeBolt Cloud, el nombre que anuncia el agente nunca sobrescribe un cambio de nombre manual. En la edición open source sí: un clúster conectado con agente vuelve a <cluster.name> (via agent) cuando su agente se reconecta o KubeBolt se reinicia, así que nombra esos clústeres con cluster.name del chart del agente.

Cambiar de clúster

Al cambiar de clúster, el gestor aparca el conector actual en lugar de desmontarlo: sus informers, el colector de métricas y el motor de insights siguen corriendo en segundo plano, así que volver a un clúster que ya abriste es instantáneo. Un clúster que todavía no has abierto se conecta la primera vez que lo usas: se ejecuta la sonda de permisos para él y después se cargan sus cachés de informers. Seleccionar el clúster que ya está activo no hace nada, y sus port-forwards siguen abiertos.

Mientras un clúster carga (su primera conexión, después de reiniciar KubeBolt o después de perder la conexión), la página dice cuánto falta en lugar de mostrar un spinner: los pasos (Agents connected, Access checked, Loading the cluster, First health check), una barra que sigue los datos que faltan por llegar, lo que ya ha llegado y, en un clúster conectado con agente, su CPU y su memoria. Las vistas se abren todas juntas cuando el clúster está listo. Durante un cambio de clúster, el menú no muestra los conteos del clúster anterior, y la píldora de estado dice Connecting. La página lee GET /clusters/progress, que nunca inicia una conexión ni la espera.

Una conexión que falla queda en el log (cluster runtime failed to connect, con el motivo) y no la reinicia cada petición: las peticiones esperan 30 segundos, luego 1, 2 y 4 minutos, 5 como máximo, y su 503 dice cuándo será el siguiente intento. Un agente que se reconecta y un cambio explícito a ese clúster lo intentan en el acto. Una conexión falla cuando no llega nada del clúster durante más tiempo que su timeout; una que sigue recibiendo páginas continúa, hasta 10 minutos (consulta Solución de problemas).

Cuánto tiempo sigue evaluándose un clúster, y por tanto notificando, depende de su tipo:

ClústerSe evalúa
Conectado con agente (reader, operator)Desde que su agente se conecta, abierto o no, mientras el agente siga conectado
El clúster en el que corre KubeBoltSiempre
Contexto de kubeconfigMientras está abierto; después queda aparcado 30 minutos tras cambiar a otro, con hasta ocho aparcados a la vez. Volver después de eso cuesta otra vez la conexión en frío
Solo de métricasSin insights: no hay vistas de recursos que evaluar

Así que las notificaciones cubren más que el clúster que tienes en pantalla. La página Fleet (/fleet) muestra todos los clústeres a la vez.

Agentes desactualizados

Desde la 2.7.0, KubeBolt avisa cuando el agente de un clúster está desactualizado, por qué, y con qué comando se actualiza. Nunca actualiza el agente por su cuenta: el agente es tu release de Helm, a menudo gestionada con GitOps, y actualizarlo desde KubeBolt exigiría permisos de escritura sobre su DaemonSet.

Un clúster se juzga por el más antiguo de sus agentes conectados:

NivelCuándoQué se muestra
Al díaEjecuta la última versiónNada
Update availableExiste una versión más nueva y nada de esta necesita arreglo (hoy, el agente 1.4.9)Un chip neutro en la tarjeta del clúster en Clusters
Update recommendedUna versión más nueva arregla algo que esta hace mal: por debajo de la 1.4.8 la red de cada pod se guarda dos veces (hasta el triple de series); por debajo de la 1.4.9, con los flujos de Hubble activados, las claves de flujo nunca se olvidanUn chip ámbar en Clusters, una etiqueta en la tarjeta del clúster en Fleet y una fila en Needs your attention de Home

El chip abre los motivos y el comando para copiar, con lo que hay que comprobar antes de ejecutarlo:

helm upgrade kubebolt-agent oci://ghcr.io/clm-cloud-solutions/kubebolt/helm/kubebolt-agent \
  --namespace kubebolt-system --version 1.4.10 --reset-then-reuse-values

Kobi responde si el agente de un clúster está desactualizado y da el mismo comando; nunca lo ejecuta. Los agentes anteriores a la 1.4.4 informan todos 1.0.0, así que aparecen como before 1.4.4, nunca como 1.0.0; Applications muestra el chart realmente instalado. En KubeBolt Cloud, los admins de la organización reciben además un correo cuando se recomienda actualizar.

API

Cualquier llamada a la API puede apuntar a un clúster distinto del activo con la cabecera X-KubeBolt-Cluster: <context-name>.

GET    /api/v1/clusters                      → list registered clusters
GET    /api/v1/clusters/progress             → how far the cluster's connect has gone
POST   /api/v1/clusters/switch               → { "context": "production-eks" }
POST   /api/v1/clusters                      → { "kubeconfig": "<yaml>" }         (admin)
PUT    /api/v1/clusters/{context}/rename     → { "displayName": "prod-us-east" }   (admin)
DELETE /api/v1/clusters/{context}            → remove an uploaded context          (admin)
DELETE /api/v1/clusters/by-id/{clusterId}    → remove an agent-connected cluster   (admin)

POST /api/v1/clusters también acepta el kubeconfig en bruto con Content-Type: application/yaml, hasta 1 MB. Un displayName vacío borra el cambio de nombre.