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
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
- Conectar clústeres: añade otro clúster con el agente, que solo abre conexiones salientes.
- Métodos de instalación: todas las demás formas de ejecutar KubeBolt (Compose, binario único, Homebrew, contenedor, krew).
- KubeBolt Cloud: si prefieres no alojarlo tú.