KubeBolt docs
ENES GitHub

Primeros pasos

Inicio rápido

Pon KubeBolt en marcha en menos de 2 minutos: instálalo con el chart de Helm o con Docker Compose, obtén la contraseña de admin y completa el Setup Wizard.

En esta página
  1. Lo más rápido: el chart de Helm
  2. Métricas en vivo frente a historial
  3. Obtener la contraseña de admin
  4. El Setup Wizard del primer inicio de sesión
  5. Docker Compose
  6. ¿Prefieres Cloud?
  7. Siguientes pasos

Lo más rápido: el chart de Helm

Necesitas kubectl apuntando al clúster, Helm 3 (3.14 o posterior para los comandos de actualización de esta documentación) y permisos para crear un namespace y un ClusterRole.

helm install kubebolt \
  oci://ghcr.io/clm-cloud-solutions/kubebolt/helm/kubebolt \
  --namespace kubebolt --create-namespace --wait

kubectl -n kubebolt get secret kubebolt-admin-password \
  -o jsonpath='{.data.password}' | base64 -d ; echo

kubectl -n kubebolt port-forward svc/kubebolt 3000:80

Abre http://localhost:3000 e inicia sesión como admin con la contraseña que se imprimió. --wait termina cuando los pods están listos (para entonces la contraseña generada ya está en su Secret) y el port-forward se queda en primer plano (Ctrl+C lo detiene). El chart despliega la API, la interfaz web y un VictoriaMetrics de un solo nodo para el historial (PVC de 10 GiB, retención de 30 días). Deberías ver tres pods en Running:

kubectl -n kubebolt get pods
# kubebolt-api-…, kubebolt-web-…, kubebolt-victoriametrics-0

Llegas a Home; elige el clúster para abrir su panel. KubeBolt vigila el clúster en el que corre a través de su propia ServiceAccount; los demás clústeres se unen con el agente (Conectar clústeres).

El chart necesita una StorageClass por defecto: crea dos PVCs, 10 GiB para VictoriaMetrics y 1 GiB para los datos propios de KubeBolt (usuarios, ajustes). AKS, GKE, kind y k3s traen una. En EKS, instala antes el complemento (add-on) del driver EBS CSI, o los dos PVCs se quedan en Pending y --wait agota el tiempo de espera; consulta Solución de problemas.

Métricas en vivo frente a historial

De serie tienes CPU y memoria en vivo, leídas de Metrics Server: solo el valor actual. Todo lo que va en el tiempo (las gráficas de historial, los flujos de red, la pestaña Cost) necesita algo que envíe muestras al VictoriaMetrics incluido: el agente, o un remote_write de Prometheus una vez activado el receptor (--set metrics.remoteWrite.enabled=true). Sin ninguno de los dos, los paneles de historial se quedan vacíos.

Para el agente junto a esta instalación basta un comando más, sin token, porque se conecta al Service de ingesta del propio clúster:

helm install kubebolt-agent \
  oci://ghcr.io/clm-cloud-solutions/kubebolt/helm/kubebolt-agent \
  --namespace kubebolt \
  --set backendUrl=kubebolt-agent-ingest.kubebolt.svc.cluster.local:9090

kubectl -n kubebolt get pods -l app.kubernetes.io/name=kubebolt-agent

Un pod del agente por nodo, en Running; las gráficas de historial empiezan a llenarse en pocos minutos. Los flujos de red de Hubble están desactivados por defecto: añade --set hubble.enabled=true si el clúster usa Cilium con Hubble.

Más fuentes (leer un Prometheus existente, ofertas de Prometheus gestionado) en Métricas.

Obtener la contraseña de admin

La autenticación está activada por defecto y el chart crea un usuario admin en el primer arranque. Hay tres formas de conocer la contraseña, de la más útil a la menos:

1. Lee el Secret. Cuando KubeBolt corre dentro del clúster, la API guarda la contraseña generada en un Secret de su propio namespace en el primer arranque (solo si la generó ella, no si la fijaste tú). Es la que puedes leer en cualquier momento:

kubectl -n kubebolt get secret kubebolt-admin-password \
  -o jsonpath='{.data.password}' | base64 -d ; echo

2. Fíjala tú al instalar, y no tendrás nada que buscar:

helm install kubebolt \
  oci://ghcr.io/clm-cloud-solutions/kubebolt/helm/kubebolt \
  --namespace kubebolt --create-namespace \
  --set auth.adminPassword=YourSecurePassword

En producción, mantenla fuera del historial de tu shell con un Secret existente (auth.existingSecret, claves admin-password y jwt-secret); consulta el README del chart o Autenticación.

3. Lee la línea del log. La misma contraseña se imprime una sola vez, en el primer arranque:

kubectl -n kubebolt logs deployment/kubebolt-api | grep "Generated admin password"

La línea del log se imprime una sola vez, en el primer arranque. Si te la perdiste, lee el Secret; no reinstales. El Secret solo se crea en el primer arranque, así que no refleja los cambios de contraseña posteriores. Si olvidaste una contraseña que ya cambiaste, consulta las vías de recuperación en Autenticación.

El Setup Wizard del primer inicio de sesión

La primera vez que un admin inicia sesión con la autenticación activada, KubeBolt abre una ventana superpuesta de cuatro pasos: Password, AI Copilot (Kobi, con tu propia clave de API), Agent y Notifications.

Todos los pasos son opcionales. «Next» siempre avanza sin guardar; cada paso tiene su propio botón de guardar por si quieres fijar ese valor en ese momento. A propósito, la ventana no se cierra con Esc ni con un clic fuera: la única salida es el botón Skip wizard, presente en todos los pasos. Saltarlo o terminarlo lo marca como hecho, así que no vuelve a aparecer en tu siguiente inicio de sesión.

Nada de esto es un requisito. Los cuatro siguen accesibles después: tu contraseña desde el menú del avatar → Change password, y el resto en Administration: AI (Kobi), Agents & Ingest y System → Notifications.

Docker Compose

Compose ejecuta KubeBolt desde el repositorio git: el archivo de compose y el script auxiliar del kubeconfig son archivos del repositorio, no artefactos publicados, así que primero hay que clonar:

git clone https://github.com/clm-cloud-solutions/kubebolt.git
cd kubebolt

# El archivo de compose monta /tmp/docker-kubeconfig, así que toda instalación
# ejecuta antes el script auxiliar. En clústeres remotos no reescribe nada: solo copia.
./deploy/docker-kubeconfig.sh
cd deploy && docker compose up -d

Frontend en http://localhost:3000; el nginx del contenedor web hace de proxy de la API y de sus WebSockets hacia el backend de Go. Inicia sesión como admin con la contraseña que la API imprime una sola vez en el primer arranque:

docker compose logs api | grep "Generated admin password"

La referencia completa de Compose (puertos, imágenes, credenciales de EKS) está en Métodos de instalación.

¿Prefieres ejecutar KubeBolt desde el código fuente? La configuración de desarrollo local está documentada en un solo lugar, en Contribuir.

¿Prefieres Cloud?

En KubeBolt Cloud no hay nada que alojar: regístrate, confirma tu correo y el asistente del primer clúster te da un bloque para pegar (el agente, su token y el comando helm), y tu clúster queda en vivo, con Kobi incluido desde el plan Free. Paso a paso en Primeros pasos en Cloud.

Siguientes pasos