Schnellstart

Diese Seite legt den ersten Cluster deines Teams an, in etwa zehn Minuten. Am Ende hast du einen k3s-Cluster in deinem eigenen Hetzner-Projekt, hast kubectl gegen ihn laufen lassen und kannst ihn für den Lernpfad oder eine App behalten, oder ihn mit allem löschen, was das Portal für ihn angelegt hat.

In Arbeit: noch nicht buchbar

Gebaut im Labor: Am 2026-10-10 hat das Portal Cluster auf echten Hetzner-Servern angelegt und gelöscht. Dieser Lauf startete Anlegen und Löschen über Verwaltungsbefehle; das Formular unten ist In Arbeit. Diese Seite zeigt die Schritte so, wie das Portal sie umsetzt; seine Oberfläche ist englisch, darum stehen ihre Beschriftungen hier auf Englisch. Nachgehen kannst du sie noch nicht. Sag mir, wenn es buchbar ist.

Was er kostet

Der erste Cluster deines Teams startet das Abonnement des Teams, und er kostet einen vollen Monat, 29 € inkl. MwSt., außerhalb der EU 29 US-$ zzgl. anfallender Steuern, auch wenn du ihn nach Minuten löschst. Solange er der einzige Cluster des Teams ist, schreibt das Löschen den Rest des Monats nicht gut: Das Abonnement endet mit dem schon bezahlten Monat. Leg ihn darum als einen Cluster an, den du behalten kannst. Ein Cluster, den du daneben anlegst, wird für den Teil des Monats berechnet, in dem es ihn gibt, und sein Löschen schreibt den Rest gut. Den Server rechnet Hetzner stundenweise ab, zu seinem eigenen Preis. In Arbeit Die Abrechnung über Paddle ist noch nicht gelaufen; Kosten und Abrechnung hat die Einzelheiten.

Was du brauchst

• Ein Hetzner-Cloud-Projekt, in dem sonst nichts liegt. Ein Hetzner-API-Token öffnet sein ganzes Projekt, lesend und schreibend, also gib deinen Clustern ein eigenes Projekt.
• Ein API-Token dieses Projekts mit der Berechtigung Read & Write, angelegt in der Hetzner-Konsole unter Security → API tokens.
• kubectl auf deinem Rechner und einen Browser mit JavaScript.

Einen Cluster anlegen

1. Öffne im Portal PaaSbox Clusters → Hetzner projects und wähle Add a Hetzner project. Trag einen Project name ein, füge das Token unter HCLOUD_TOKEN (read/write) ein und wähle Validate & connect. Das Portal prüft das Token, indem es dein Projekt auflistet, und speichert es verschlüsselt.

2. Öffne PaaSbox Clusters und wähle New cluster. Beim ersten Mal nimmt ein Team-Admin die Bedingungen für das Team an und startet das Abo im Checkout von Paddle In Arbeit.

3. Nenne den Cluster first. Wähle dein Projekt, einen Standort in deiner Nähe und den Servertyp cpx22. Wähle unter Hetzner token inside the cluster die Option A copy of the project’s token: Für den Anfang reicht ein Token; Lernschritt 1 zeigt, warum ein Cluster, den du lange betreibst, ein eigenes bekommt. Lass alles andere, wie es ist.

4. Wähle Create cluster. Die Seite des Clusters zeigt jeden Schritt, den das Portal abarbeitet. Der Cluster ist bereit, wenn pbx-agent auf dem Server eine gesunde Kubernetes-API meldet. Im Labor dauerte das 2 Minuten 46 Sekunden; 69 Sekunden davon gingen in das Kopieren des Node-Images ins Projekt, auf das nur der erste Cluster eines Projekts wartet.

Ihn benutzen

1. Wähle auf dem Reiter Access des Clusters die Rolle admin und 1 hour, dann Get kubeconfig und Download kubeconfig. Dein Browser hat für diese Anfrage ein Schlüsselpaar erzeugt, und die Kubeconfig wurde auf dem Server dafür verschlüsselt; das Portal konnte sie unterwegs nicht lesen.

2. Richte kubectl darauf:

   export KUBECONFIG=~/Downloads/first-admin.kubeconfig
   kubectl get nodes
   kubectl get pods -A

   Ein Node, first-cp-1, im Zustand Ready. Die Pods sind das, womit jeder Cluster startet: CoreDNS, Traefik für Ingress, metrics-server, der Hetzner Cloud Controller und der Treiber für Volumes auf der Platte des Servers.

3. Lass etwas laufen und ruf es auf:

   kubectl create deployment hello --image=nginx
   kubectl rollout status deployment/hello
   kubectl port-forward deployment/hello 8080:80

   Öffne http://localhost:8080: die Willkommensseite von nginx, aus deinem Cluster, über die Kubernetes-API. Beende das Port-Forwarding mit Strg-C.

Ihn behalten oder löschen

Behalte den Cluster, wenn du weitermachst: Eine App kann auf ihm laufen, und der Lernpfad beginnt mit einem Cluster aus bewussten Entscheidungen. Legst du diesen zuerst an und löschst dann diesen hier, ist er nicht mehr der einzige Cluster des Teams, und der Rest seines Monats wird gutgeschrieben.

So löschst du ihn:

1. Nimm auf dem Reiter Settings des Clusters unter Delete den Haken bei Take a final snapshot first heraus: Ohne Bucket landete der Snapshot auf der Platte des Servers, und die wird mitgelöscht. Tippe first ein und wähle Delete cluster.

2. Das Portal löscht den Server, das Netz, die Firewall, die IP-Adresse und den DNS-Namen. Im Labor dauerte das 14 Sekunden, und keine Ressource mit dem Label des Clusters blieb im Projekt übrig. Das Node-Image bleibt im Projekt, damit der nächste Cluster nicht darauf wartet.

In Arbeit War es der einzige Cluster des Teams, endet das Abonnement mit dem schon bezahlten Monat, ohne Gutschrift; ein Cluster, den du vor dem Ende des Monats anlegst, nutzt ihn.

Darauf ist der Ansatz gebaut: ein Cluster, für einen Zweck angelegt, in Minuten. Wegwerf-Cluster für Tests kommen neben einen Cluster, den du behältst; dort kostet jeder nur seinen Anteil am Monat (Warum isolierte Cluster für Agenten).

Deinen ersten Cluster anlegenLernschritt 1: ein Cluster, den du behältst, mit bewussten Entscheidungen, und jedes seiner Teile wiedergefunden.

Das passende SetupWie viele Cluster, welcher Servertyp, Produktion oder nicht, welche Add-ons.