Configuración
Multiclúster
Contextos de kubeconfig, clústeres conectados con agente y clústeres solo de métricas en un único registro persistente.
Tipos de conexión
El registro de clústeres mezcla tres tipos de clústeres:
- Contextos de kubeconfig: se descubren automáticamente en tu kubeconfig al arrancar, o se añaden después subiendo un kubeconfig (admin). La conexión inicial apunta al current-context. Cuando KubeBolt corre dentro de un clúster sin archivo kubeconfig (la instalación con Helm), ese clúster es su único contexto y se rechazan las subidas: añade otros clústeres con el agente.
- Clústeres conectados con agente: se añaden con el asistente Add cluster; el agente abre la conexión saliente hacia KubeBolt, así que no hace falta ninguna ruta de red entrante ni compartir un kubeconfig. El exec remoto, el port-forward y el explorador de archivos funcionan por el mismo canal (consulta Clústeres remotos). Aparecen en el selector cuando su agente se conecta por primera vez, lo que requiere tener activado el autorregistro de clústeres: es el valor por defecto del chart de Helm, pero viene desactivado por defecto en el binario y en Docker Compose (Administration → Agents & Ingest → Configuration, sin reiniciar).
- Clústeres solo de métricas: el agente corre con
rbac.mode=metrics, así que envía telemetría pero ninguna llamada al apiserver cruza su túnel. Ideal para clústeres que solo quieres ver en los paneles; las vistas de recursos y los insights necesitan un agentereaderuoperator.
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úster | Se 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 KubeBolt | Siempre |
| Contexto de kubeconfig | Mientras 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étricas | Sin 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:
| Nivel | Cuándo | Qué se muestra |
|---|---|---|
| Al día | Ejecuta la última versión | Nada |
| Update available | Existe 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 recommended | Una 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 olvidan | Un 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
- Se ejecuta contra el contexto actual de kubectl: comprueba que es ese clúster
(
kubectl config current-context) o añade--kube-context <name>. - Si se instaló con otro nombre de release u otro namespace, cambia
kubebolt-agentykubebolt-system. --reset-then-reuse-valuesconserva tus ajustes y toma los valores por defecto del chart nuevo (Helm 3.14 o posterior). Una release instalada con una copia completa del archivo de valores del chart conserva los valores por defecto antiguos como ajustes:helm get values kubebolt-agent -n kubebolt-systemmuestra lo que conserva.- Con Argo CD o Flux, fija la versión del chart en la Application o en la HelmRelease.
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.