Dashboard e account

La dashboard kubehz (app.kubehz.cloud) è il luogo in cui vedi i tuoi cluster, dimostri la proprietà e gestisci chi ha accesso. Il tuo login e le impostazioni di sicurezza personali risiedono nel tuo account kubehz su auth.kubehz.cloud/account.

Accesso

Non hai ancora un account? Crearlo è gratuito e richiede circa un minuto. Apri app.kubehz.cloud, scegli Crea un account e registrati con e-mail, Google o GitHub. Il piano gratuito copre fino a due cluster registrati e non richiede dati di pagamento.

La registrazione è aperta per i primi 25 account. Dopo serve un codice d’invito da un account esistente (vedi Codici d’invito). Gli account interni e di test di kubehz non contano nei 25.

Apri app.kubehz.cloud e accedi con il tuo account kubehz. L’autenticazione passa attraverso il servizio di identità di kubehz su auth.kubehz.cloud.

Codici d’invito

Ogni account riceve 2 codici d’invito. Il titolare dell’account li trova in Impostazioni → Account, nella sezione I tuoi inviti. Ogni codice mostra il suo stato: Non usato, Usato, Scaduto o Revocato.

• Un codice crea un account. Funziona una sola volta.
• Un codice non usato scade 30 giorni dopo che kubehz lo emette.
• La nuova persona inserisce il codice in Codice di invito quando si registra. Maiuscole o minuscole vanno bene, e i trattini sono facoltativi.

I numeri (25 account, 2 codici, 30 giorni) possono cambiare.

Cluster

Elenco

Dopo l’accesso, i tuoi cluster sono elencati nella pagina principale, ognuno mostra il suo nome, lo stato e l’ultimo heartbeat, così puoi capire a colpo d’occhio cosa è connesso.

Dettaglio

Apri un cluster per vedere la salute riportata dall’agent heartbeat nel cluster per un cluster registered:

• Versione Kubernetes: la versione che il cluster sta eseguendo
• Nodi e stato: nome, ruolo e prontezza di ogni nodo
• Salute dei componenti del control plane: apiserver, etcd, scheduler, controller-manager
• Scadenza dei certificati: quando i certificati del cluster devono essere rinnovati

Questi sono esattamente i dati che l’agent invia, niente di più. Vedi Come funziona: i tuoi dati.

Il tier gestito aggiunge di più

Le funzionalità di gestione (politiche di self-healing, monitoraggio della capacità e gestione dello stato desiderato con flussi di aggiornamento/scaling) appartengono al tier gestito (access: managed), che è attivo e richiede un abbonamento Supporter o superiore. Le singole funzionalità che agiscono vengono rilasciate gradualmente dietro interruttori per-funzionalità. Per un cluster registered la dashboard mostra la salute in sola lettura descritta sopra.

Rivendicare un cluster

Un cluster appena registrato ha lo stato Creating finché non viene rivendicato. La pagina Claim lo collega al tuo account e dimostra la proprietà; una volta rivendicato, il cluster è di tua proprietà. Il flusso è concettualmente register → claim → owned; vedi Registrazione.

Accesso

Da Accesso inviti membri, assegni a ciascuno un tier di accesso, definisci ruoli personalizzati (una matrice di permessi, opzionalmente limitata ai namespace), scegli a quali cluster hosted si applica l’accesso di ciascun membro e, facoltativamente, federi il tuo SSO. Su un cluster hosted, tutto questo si mappa direttamente all’accesso Kubernetes.

Vedi Accesso e ruoli per il modello completo.

In Accesso → Chiavi agente crei le chiavi per agenti di IA e pipeline: vedi Chiavi agente.

Impostazioni

La pagina Impostazioni della dashboard ha queste schede:

• Account: la tua identità, il tier del tuo account e il tuo ruolo. Il titolare dell’account qui trova anche i codici d’invito.
• Tenant: il nome del tenant attivo e i limiti di frequenza API del tuo account.
• GitHub: collega un repository GitHub, così kubehz può mostrare la differenza tra stato dichiarato e stato reale e aprire pull request di bootstrap.
• App IA: vedi quali app di IA, come Claude o ChatGPT, possono agire per te.
• Notifiche: scegli quali notifiche email ti invia kubehz.
• Privacy: esporta i dati che kubehz conserva su di te, o elimina il tuo account.
• Recesso: il titolare dell’account vede questa scheda finché un consumatore può ancora recedere dal contratto (14 giorni).

Ogni cluster ha anche una propria scheda Impostazioni. Progetto assegna il cluster a un progetto, Dimensionamento modifica gli API server, il limite di stato e gli add-on di un cluster hosted, e Cluster contiene l’impostazione della cronologia e il pulsante per eliminarlo.

Il tuo account (sicurezza)

Gestisci il tuo login personale su auth.kubehz.cloud/account, l’interfaccia account brandizzata di kubehz:

• Cambiare la password
• Autenticazione a due fattori: registra o rimuovi un autenticatore TOTP
• Sessioni: visualizza le sessioni attive e revoca quelle che non riconosci

Risoluzione dei problemi

Se un cluster non compare, verifica che l’agent heartbeat sia presente e in esecuzione:

# Is the CronJob there and not suspended?
kubectl -n kubehz-system get cronjob kubehz-heartbeat

# Read the last run's logs
kubectl -n kubehz-system logs -l app=kubehz-heartbeat

Un 4xx in quei log di solito significa che il cluster non è registrato (o è stato deregistrato). Riesegui lo kubehz register.

Prossimi passi

• Registrazione: collega un cluster self-hosted
• Come funziona: il modello e i tuoi dati
• Control plane hosted: il percorso delegato

---

Stato del documento

Aspetto	Dettaglio
Stato	attivo
Ultima revisione	2026-10-30