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
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:
- Correo y contraseña. Tu nombre, tu correo, el nombre de una organización, un país y una contraseña de al menos 8 caracteres; todos los campos son obligatorios. El correo es tu usuario para iniciar sesión. Marca I’m an individual / freelancer y el nombre de la organización se rellena con el tuyo. Los nombres de organización son únicos en todo KubeBolt Cloud: si el tuyo ya está en uso, el formulario te lo dice tal cual.
- Google, Microsoft o GitHub. Inicia sesión con el proveedor y después ponle nombre a tu organización y elige un país. No hay contraseña que elegir. El proveedor tiene que haber verificado tu dirección de correo; si no lo ha hecho, se rechaza el inicio de sesión.
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:
- Abre el enlace. Te lleva a una página de KubeBolt que pide el código.
- Introduce el código del mismo correo. Tras cinco códigos incorrectos, ese enlace deja de aceptar ninguno; envía un correo nuevo.
- El enlace y el código valen 24 horas desde el registro. Reenviar no amplía ese plazo.
- Resend email, en el banner, envía uno nuevo, como mucho una vez cada cinco minutos.
- Confirmar en otra pestaña quita el banner aquí: la app vuelve a comprobarlo cuando la ventana recupera el foco.
- Si pasan las 24 horas, la app queda bloqueada tras «Verify your email to continue» y reenviar no sirve (todos los enlaces caducan en el mismo plazo). Te enviamos un recordatorio con un enlace y un código nuevos que abre otra ventana de 24 horas; si no te llega, ponte en contacto con soporte.
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:
- Un clúster de Kubernetes, y una terminal con
kubectlyhelmapuntando a él. - Permisos para crear un namespace y un ClusterRole en ese clúster.
- HTTPS saliente desde el clúster hacia
agent.kubebolt.io:443. Nada se conecta hacia dentro.
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:
-
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.
-
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
kubectlapunte 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-tokenEl token va en un Secret, nunca en los values de Helm. Puedes ejecutar el bloque dos veces sin problema:
applyreemplaza el Secret yupgrade --installactualiza la release.rbac.mode=readerle da a KubeBolt una vista completa de solo lectura del clúster; los cambios (escalar, reiniciar, exec, editar) necesitanoperator(consulta el modo RBAC). -
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:
- El clúster aparece en Fleet y en el selector de clústeres.
- Home lo cuenta, con sus nodos y pods.
- El Overview del clúster muestra los recursos en vivo de inmediato. Las gráficas históricas necesitan que el agente envíe antes unos minutos de muestras, así que un clúster recién conectado se ve escaso durante sus primeros minutos. Es normal, no es un fallo.
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 ves | Qué significa |
|---|---|
Nada en kubebolt-system | kubectl 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 found | La 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 refused | El 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 log | Tu 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
- Kobi Copilot:
⌘J. En Cloud la IA es gestionada y consume los créditos de IA mensuales de tu plan; no hay clave que configurar ni paso de activación. Necesita un correo confirmado. - Home y Fleet: las dos pantallas en las que vas a pasar el día.
- Seguridad y cumplimiento: lo que aparece en cuanto instalas un escáner.