Spazi

Uno Spazio è una fetta di un cluster Kubernetes che kubehz gestisce e protegge, con namespace che sono tuoi e nodi che sono tuoi. Le macchine le porti tu; il control plane lo gestiamo noi.

Porta una VM da 4 € e ottieni un namespace Kubernetes gestito.

Quale percorso è questo?

kubehz ha tre forme. Self-hosted: il tuo cluster sul tuo account, kubehz osserva. Hosted: gestiamo noi il control plane, i worker girano sul tuo account Hetzner. Spazi: gestiamo un control plane condiviso da molti clienti, e tu ci registri le tue macchine. Gli Spazi sono i più economici dei tre, perché la parte costosa (il control plane) è condivisa.

Cosa ottieni

• Uno o più namespace su un control plane che gestiamo, aggiorniamo e di cui facciamo il backup.
• I tuoi nodi. Li compri tu, sono tuoi, e li paghi a chi te li vende: Hetzner, un altro provider o la macchina sotto la tua scrivania. kubehz non li provisiona mai e non li fattura mai.
• Accesso kubectl ai tuoi namespace, tramite il tuo login kubehz.
• Un endpoint API stabile per tutta la vita del tuo Space: https://<tuo-space>.k8s.kubehz.cloud. Usa un certificato con attendibilità pubblica (nessun download della CA) e resta lo stesso attraverso ogni migrazione eseguita dalla piattaforma. Impostalo una volta in kubeconfig e CI, poi dimenticalo.
• La base della piattaforma già in funzione: CNI, ingress, certificati, DNS.

Cosa non ottieni, di proposito

Nessun accesso al control plane condiviso. Per il plane su cui uno Spazio parte non esiste una kubeconfig di amministrazione. È condiviso con altri clienti: consegnare cluster-admin significherebbe consegnare anche i loro dati. È questo scambio a rendere possibile il prezzo. Quando ti sta stretto, aggiungi il tuo control plane: dedicato, sui tuoi nodi, cluster-admin incluso.

In concreto significa:

• Niente kubectl get nodes -A sul cluster e nessun oggetto a livello di cluster tuo (niente CRD, niente ClusterRole, niente webhook di admission).
• Nessun CNI personalizzato e nessuna modifica alla rete del cluster.
• Vedi i tuoi namespace e i tuoi nodi. I carichi degli altri sono invisibili a te, e i tuoi a loro.

Se ti serve una di queste cose, ti serve un cluster tuo: prendi il percorso hosted o self-hosted. Salire è una migrazione supportata, non una ricostruzione.

Come funziona l’isolamento

Quattro confini, ciascuno applicato in modo indipendente:

1. I tuoi pod girano solo sui tuoi nodi. Ogni namespace porta un selettore di nodi per il tuo tenant, e i tuoi nodi portano un’etichetta corrispondente più un taint che tiene fuori tutti gli altri. Un tuo pod non può atterrare sulla macchina di un altro cliente, né la sua sulla tua.
2. La tua rete è chiusa per impostazione predefinita. Ogni namespace parte con una regola di default-deny. Il traffico tra i tuoi namespace, il DNS e internet sono aperti per te; i namespace di altri non sono raggiungibili, in nessuna direzione e su nessun protocollo.
3. Le tue credenziali funzionano solo sulle tue cose. L’accesso è limitato ai tuoi namespace. Una richiesta per lo Spazio di qualcun altro risponde non trovato (non vietato), così l’elenco di chi altro c’è sul cluster non è qualcosa che puoi sondare.
4. Lo storage e il traffico di controllo della piattaforma sono irraggiungibili da qualsiasi nodo cliente.

I nodi sono tuoi, e vale in entrambi i sensi

kubehz pianifica i carichi sulle tue macchine. Non le provisiona, non vi accede, non le aggiorna e non ne sorveglia i dischi. Se un nodo muore alle 3 di notte, i tuoi carichi si ripianificano sugli altri tuoi nodi – se hai altri nodi.

Questa è la versione onesta del patto, e conviene pianificarla:

• Tieni almeno due nodi per tutto ciò che deve restare su.
• Il sistema operativo è tuo: aggiornamenti del kernel, spazio su disco, il firewall della macchina. Pubblichiamo un firewall consigliato: è un servizio per te, non un controllo su di te; hai root e puoi cambiarlo.
• Rimuovere la registrazione di un nodo dalla dashboard non spegne la macchina. Ne ritira le credenziali e la toglie dal cluster. Spegnere la scatola (e fermarne il costo) tocca a te.

Limiti

Uno Spazio ha due budget: quanti nodi puoi registrare e quanti namespace puoi avere. Entrambi sono mostrati, contati in tempo reale, nella pagina dello Spazio in dashboard. I tetti seguono la modalità del tuo account:

Modalità account	Nodi per Space	Namespace per Space
Free	2	1
Supporter	5	3
Enterprise	10	5

Ti serve di più? Chiedi un limite più alto dalla pagina dello Spazio in dashboard, oppure con POST /api/spaces/{id}/limit-requests (la risorsa, il valore che vuoi e una breve motivazione). Esaminiamo ogni richiesta a mano e alziamo il tetto sullo Spazio stesso, quindi la modalità del tuo account non cambia.

La dashboard è autorevole

La tabella mostra i valori predefiniti di oggi. La dashboard mostra sempre i limiti sotto cui il tuo Spazio sta davvero girando; fidati di quelli, non di un numero scritto in una documentazione.

Per iniziare

1. Crea uno Spazio da CLI: scrivi un cluster.lok8s.yaml con kind: Kubehz e spec.kubehz.hosting: shared, esporta KUBEHZ_TOKEN (un token API dalla dashboard, Accesso → Token API), poi esegui lo provision. La dashboard elenca e gestisce gli Spazi; non ha ancora un modulo di creazione.
2. Aggiungi il primo nodo.
3. Fai il deploy nel tuo namespace con kubectl, esattamente come faresti ovunque.

Prima di qualcosa con stato vale la pena leggere Archiviazione in uno Spazio. Quanto costa uno Spazio è nella pagina dei prezzi: il primo Spazio, il suo primo namespace e due nodi sono gratuiti.

Stato del documento

Aspetto	Dettaglio
Stato	live: Spaces attivi; tetti per modalità account con richieste di limite; prezzi pubblicati
Ultima revisione	2026-09-05