Conceptos
Aplicaciones de Helm
Explora cada release de Helm de tu clúster: chart, values, manifest renderizado, historial de revisiones y dependencias, sin salir del panel.
En esta página
KubeBolt lee tus releases de Helm directamente del clúster y las convierte en una vista de primera clase: chart y versión, los values que produjeron la release, el manifest completamente renderizado, el historial de revisiones y el árbol de dependencias del chart. Responde a la pregunta que todo operador acaba haciéndose (¿qué workload pertenece a qué release?) sin bajar a una terminal.
Cómo funciona
KubeBolt decodifica los Secrets de las releases que Helm 3 guarda en cada
namespace (etiqueta owner=helm, uno por revisión). No hay binario helm ni
SDK de Helm embebido en el backend: lee la misma fuente de verdad que usa el
propio Helm. Eso mantiene la imagen ligera y hace que la vista refleje
exactamente lo que está instalado, incluidas las releases creadas por CI, Argo
CD o el portátil de un compañero.
- La lista de releases se sirve desde una caché del servidor que se refresca más o menos cada 60 segundos; la página vuelve a pedirla cada 30 segundos, así que una release nueva aparece en unos 90 segundos.
- El historial de Helm se queda en el clúster hasta que una vista lo necesita. El Secret de cada revisión guarda la release entera: chart, values y cada manifiesto renderizado. Desde la 2.6.5, la caché de Secrets deja fuera el almacenamiento de Helm: las listas y los conteos leen solo sus metadatos, una vez por minuto. El contenido de una release se lee cuando algo lo necesita: su última revisión, una vez, para la lista de Applications o para un insight sobre una release fallida o atascada. La lista de Secrets, el detalle de un Secret de almacenamiento y los conteos de Overview los siguen mostrando.
- El detalle de una release se lee en vivo, limitado a los Secrets de esa release.
- Como la fuente son Secrets, la identidad que usa KubeBolt (su propia ServiceAccount o la del agente) necesita poder listar Secrets; sin ese permiso, la lista responde not permitted to list Helm release secrets. Las releases guardadas con los drivers de almacenamiento ConfigMap o SQL de Helm no aparecen.
Un elemento Applications, fijado en la barra lateral del clúster, muestra el número de releases distintas. La parte de Helm es de solo lectura: KubeBolt no instala, actualiza, revierte ni desinstala releases.
Endpoints
Los dos bajo /api/v1, para cualquier rol autenticado, en un clúster
conectado.
| Método | Ruta | Devuelve |
|---|---|---|
GET | /helm/releases | Lista de releases de todo el clúster, con la última revisión de cada una |
GET | /helm/releases/{namespace}/{name} | El detalle completo de una release, con su historial de revisiones |
Detalle de una release
Cada release abre una página de detalle con pestañas. Una pestaña sin nada que mostrar (sin dependencias, por ejemplo) se oculta.
- Overview: estado, revisión, versión del chart y de la app, namespace, cuándo se actualizó y cuándo se desplegó por primera vez, el número de recursos, dependencias y revisiones, y las notas del chart.
- Values: los values que aportó el usuario en la última revisión (lo que
devuelve
helm get values), de solo lectura. Los valores por defecto del propio chart no se combinan; si no se aportó ninguno, la pestaña dice que están en vigor los valores por defecto. Las credenciales de los values, detectadas por nombre y por forma, se ocultan. - Manifest: un explorador maestro-detalle de cada objeto renderizado. Los recursos se agrupan por tipo en un carril que puedes redimensionar (130–520px); al seleccionar uno se muestra su YAML, con los valores de los Secrets ocultos como en la vista YAML.
- Related: enlaces directos a los objetos en vivo que creó la release (Deployments, Services, ServiceAccounts y más).
- History: cada revisión con su versión del chart y de la app, su estado, su fecha y su descripción, para que veas cómo evolucionó la release.
- Dependencies: los subcharts que declara el chart y sus versiones.
Explorador del manifest
La pestaña del manifest está pensada para releases grandes:
- Pulsa
/para filtrar (sin distinguir mayúsculas, por nombre, tipo o namespace de un recurso; las coincidencias fuerzan la expansión del carril). - Muévete entre las coincidencias con
↑/↓. - Copy copia el YAML de cualquier recurso individual.
- Open live object salta a la vista de detalle en vivo de ese recurso en KubeBolt, para los tipos que tienen vista en KubeBolt (un ClusterRole, por ejemplo, aparece en la lista pero sin enlace).
Insights de Helm
Dos reglas del motor de insights vigilan tus releases y señalan los problemas automáticamente:
| Insight | Severidad | Se dispara cuando |
|---|---|---|
helm-release-failed | Crítica | La última revisión de una release está en estado failed: su última instalación o actualización no terminó |
helm-release-hook-pending | Advertencia | Una release lleva más de 5 minutos en un estado pending-*: normalmente, un hook del ciclo de vida que nunca terminó y que retiene el bloqueo de la release |
Las dos son reglas de fallo: su severidad es fija y no se pueden desactivar por política, solo silenciar release por release.