KubeBolt docs
ENES GitHub

Primeros pasos

Primeros pasos en Cloud

Regístrate en app.kubebolt.io, confirma tu correo y conecta tu primer clúster con el asistente del primer clúster, que te da un solo bloque para pegar.

En esta página
  1. 1. Crea tu cuenta
  2. 2. Confirma tu correo antes de conectar un clúster
  3. 3. Conecta tu primer clúster
  4. 4. Qué ves cuando funciona
  5. Siguientes pasos

Este es el camino desde cero hasta tener un clúster en pantalla en app.kubebolt.io. No hay nada que alojar: instalas un agente en tu propio clúster y él se conecta hacia fuera. Qué es Cloud y en qué se diferencia de alojarlo tú está en KubeBolt Cloud.

1. Crea tu cuenta

Empieza en app.kubebolt.io/signup. Al registrarte se crean un usuario y una organización en un solo paso, y tú eres el Admin de esa organización. Hay dos formas de entrar:

Una organización nueva empieza en el plan Free: 2 clústeres, 10 nodos, 150 pods, 3 usuarios, 15 días de historial y 100 créditos de IA al mes. Los límites de Free son topes estrictos: no se factura nada. Los planes y lo que incluye cada uno están en Precios; Administration → Billing muestra el tuyo.

2. Confirma tu correo antes de conectar un clúster

Conectar un clúster requiere un correo confirmado. El paso que emite el token de ingesta del agente depende de ello, igual que el chat de Kobi, invitar usuarios, crear equipos y emitir tokens de API. Si abres primero el asistente del clúster, se detiene en el paso de instalación con «Confirm your email to get your install command» y no hay nada que pegar. Confirma en otra pestaña y el paso continúa solo.

Si te registraste con Google, Microsoft o GitHub, tu correo ya está confirmado: el proveedor ya lo verificó, y KubeBolt lo registra al darte de alta. No tienes que hacer nada; pasa al paso 3.

Si te registraste con correo y contraseña, un banner en la parte superior de la app dice «Confirm your email — we sent a code to …». El correo trae un enlace y un código de seis dígitos:

  1. Abre el enlace. Te lleva a una página de KubeBolt que pide el código.
  2. Introduce el código del mismo correo. Tras cinco códigos incorrectos, ese enlace deja de aceptar ninguno; envía un correo nuevo.

Un banner que dice «Email delivery isn’t configured on this install» nunca aparece en Cloud: indica un despliegue autoalojado multiorganización que no tiene SMTP configurado.

3. Conecta tu primer clúster

Justo después de registrarte llegas a una página de bienvenida, «Your first cluster, live in about two minutes». Enumera lo que necesitas:

Connect my cluster abre el asistente del primer clúster. No cluster at hand? Try it on your laptop abre el mismo asistente, con un comando de kind, k3d o minikube primero. Someone else installs it? Invite them lleva a Administration → Access. Skip for now te lleva a Home, cuyo botón Connect cluster abre el mismo asistente más tarde (igual que Fleet → Connect cluster mientras la organización no tiene ningún clúster).

El asistente tiene tres pasos:

  1. Name it. Cómo aparece el clúster en KubeBolt: letras, números, puntos, guiones y guiones bajos; puedes renombrarlo después. Elige A cluster I already have o A cluster on my laptop.

  2. Install. El asistente emite un token de ingesta para tu organización y te da un único bloque de instalación con el token ya dentro. El token se muestra una sola vez; Copy all copia el valor real aunque en pantalla aparezca enmascarado. Si ningún agente lo usa en 7 días deja de funcionar, y el asistente dice hasta cuándo; una vez que un agente lo ha usado, sigue funcionando. Ejecuta el bloque en una terminal donde kubectl apunte al clúster. Se parece a esto (copia el tuyo del asistente, que lleva tu token y el nombre de tu clúster):

    kubectl create namespace kubebolt-system --dry-run=client -o yaml | kubectl apply -f -
    kubectl -n kubebolt-system create secret generic kubebolt-agent-token \
      --from-literal=token=<your-token> --dry-run=client -o yaml | kubectl apply -f -
    helm upgrade --install kubebolt-agent oci://ghcr.io/clm-cloud-solutions/kubebolt/helm/kubebolt-agent \
      --namespace kubebolt-system --create-namespace \
      --set backendUrl=agent.kubebolt.io:443 \
      --set cluster.name=<your-cluster-name> \
      --set rbac.mode=reader \
      --set tls.enabled=true \
      --set hubble.enabled=false \
      --set auth.mode=ingest-token \
      --set auth.ingestToken.existingSecret=kubebolt-agent-token

    El token va en un Secret, nunca en los values de Helm. Puedes ejecutar el bloque dos veces sin problema: apply reemplaza el Secret y upgrade --install actualiza la release. rbac.mode=reader le da a KubeBolt una vista completa de solo lectura del clúster; los cambios (escalar, reiniciar, exec, editar) necesitan operator (consulta el modo RBAC).

  3. Go live. Haz clic en I ran it y el asistente espera al agente (siguiente sección).

Advanced setup, enlazado desde el asistente, abre el asistente completo Add cluster: nivel de RBAC, Hubble, Prometheus, OpenCost, recursos y qué equipo es dueño del clúster. Abierto desde el asistente del primer clúster, reutiliza el token, el nombre y el equipo de ese asistente en lugar de emitir un segundo token, y Back to the simple setup vuelve a él. Abierto por su cuenta, emite el token por separado: marcas «I’ve copied and saved the token — it can’t be shown again», ejecutas su comando kubectl para crear el Secret y luego su comando helm install.

Un clúster siempre se registra con un equipo. Un token emitido sin equipo recibe el único equipo de tu organización; si hay varios, el tuyo cuando perteneces exactamente a uno y, si no, el equipo default de la organización. Unassigned sigue siendo una elección explícita en Advanced setup y en Agent Tokens, cuyos selectores Owner team empiezan en Automatic. Cuando tu organización ya tiene un clúster, Connect cluster y Add cluster abren un menú cuya entrada Install agent es este asistente. Todas las opciones que configura están descritas en Conectar clústeres. En Cloud, instala siempre el agente: Import kubeconfig necesita que KubeBolt se conecte a tu API server, y nuestro backend no tiene ruta hacia tu red.

4. Qué ves cuando funciona

Tras I ran it, el asistente busca el clúster nuevo cada pocos segundos y muestra «<name> is connected» con un botón Open <name> en cuanto el agente se registra, normalmente en un par de minutos, contando la descarga de la imagen. Nunca se rinde: pasados cinco minutos comprueba con menos frecuencia, y Close — keep it running solo cierra la ventana. El clúster aparece en Home cuando el agente se conecte, sea cuando sea.

Después, por orden:

Tras dos minutos sin el agente, el asistente muestra qué comprobar:

kubectl -n kubebolt-system get pods
kubectl -n kubebolt-system logs ds/kubebolt-agent --tail=20
Lo que vesQué significa
Nada en kubebolt-systemkubectl apuntaba a otro clúster. Cambia de contexto y vuelve a ejecutar el bloque
Pods atascados en ContainerCreating, y kubectl -n kubebolt-system describe pod dice secret "kubebolt-agent-token" not foundLa línea del Secret no se ejecutó. Vuelve a ejecutar el bloque entero
Líneas de log shipper session ended, will reconnect con un timeout o connection refusedEl clúster no llega a agent.kubebolt.io:443. Permite el tráfico saliente hacia ese destino
cluster cap reached (2/2) for plan "free" en el logTu organización ya tiene tantos clústeres como permite su plan. Borra uno en Clusters o cambia de plan

Todo lo demás está en Solución de problemas.

Siguientes pasos