SSD Nodes Learn Hosting plans →
Anleitungen Matt ConnorVon Matt Connor

k3s auf einem einzelnen VPS: Lohnt sich das?

Erfahren Sie, ob k3s auf einem VPS sinnvoll ist. Wir analysieren den RAM-Verbrauch, den Port-80-Konflikt bei der Installation und den Vergleich zu einfachem Docker Compose.

Was k3s ist und was Ihnen ein einzelner k3s-Knoten bietet

k3s ist eine vollständige Kubernetes-Distribution, die als einzelne Binärdatei bereitgestellt wird. Wenn Sie k3s auf einem einzelnen VPS ausführen, erhalten Sie die echte Kubernetes-API, ohne eine aus drei Rechnern bestehende Control Plane zu benötigen. k3s ist eine zertifizierte Kubernetes-Distribution. Daher kann ein Manifest, das hier angewendet wird, später auch auf einen verwalteten Cluster angewendet werden. Die Installation erfolgt mit einem einzigen Befehl und dauert etwa eine Minute. Dafür steht weniger Arbeitsspeicher für Ihre Anwendungen zur Verfügung. Außerdem entstehen Fehlerfälle, die bei Docker Compose nicht auftreten.

SUSE entwickelt k3s für Edge-Standorte und kleine Installationen. Die Abweichungen vom Upstream-Kubernetes dienen dazu, k3s kleiner zu machen und den Betrieb zu vereinfachen. Der standardmäßige Datenspeicher ist sqlite hinter einem Shim namens kine und nicht etcd. Daher muss kein etcd-Quorum verwaltet werden. containerd ist in die Binärdatei eingebettet und wird nicht separat installiert. Dieselbe Binärdatei enthält außerdem CoreDNS für die Cluster-DNS-Auflösung, Traefik als Ingress-Controller, ServiceLB (auch klipper-lb genannt), damit LoadBalancer-Services ohne dahinterliegenden Cloud-Provider funktionieren, den local-path provisioner für persistente Volumes, metrics-server und flannel für die Pod-Netzwerkkommunikation. Alle diese Komponenten werden standardmäßig gestartet. Diese Standardeinstellungen belegen die Ports 80 und 443 für Traefik. Legen Sie daher vor der Installation fest, welcher Dienst diese Ports verwenden soll, wenn auf dem VPS bereits ein anderer Dienst ausgeführt wird.

Wenn sich ein einzelner k3s-Node lohnt

Verwenden Sie k3s, wenn Sie die Kubernetes-API benötigen: Sie lernen Kubernetes auf einer von Ihnen kontrollierten Maschine, oder die gewünschte Software wird nur als Helm-Chart veröffentlicht. Auch die Portabilität von Manifests ist relevant, weil ein hier erstelltes Deployment unverändert in einen verwalteten Cluster übernommen werden kann. Verwenden Sie Docker Compose, wenn Sie die Anwendungen selbst benötigen. Compose startet dieselben Container mit deutlich weniger Komponenten, und eine Compose-Datei auf einem VPS ist ein Jahr später leichter zu lesen als ein Verzeichnis mit Manifests.

Beachten Sie, was ein einzelner Node nicht bietet.

  • Keine Hochverfügbarkeit. Wenn der VPS neu gestartet wird, werden alle Workloads beendet. Kubernetes plant einen Pod auf einem anderen Node ein. Einen anderen Node gibt es jedoch nicht.
  • Kein Rolling Update, bei dem ein Dienst verfügbar bleibt, es sei denn, die Anwendung unterstützt zwei Replikate auf derselben Maschine und der Node bietet Platz für beide.
  • Speicher, der an diese Maschine gebunden ist, aus dem im folgenden Abschnitt zu local-path beschriebenen Grund.
  • Eine Control Plane, die ungefähr ein Gigabyte RAM benötigt, unabhängig davon, ob Sie etwas bereitstellen.

Das macht k3s nicht zu einer schlechten Wahl. Es macht k3s zu einer schlechten Wahl für den Grund, den viele normalerweise nennen: Zuverlässigkeit. Wenn Sie tatsächlich mehrere Maschinen benötigen, um einen echten Multi-Node-Cluster aufzubauen, steht diese Entscheidung an erster Stelle: Proxmox auf eigener Hardware im Vergleich zu einem gemieteten VPS legt fest, woher die Nodes kommen, bevor k3s festlegt, was darauf ausgeführt wird.

Welche RAM- und CPU-Ressourcen k3s benötigt, bevor Sie etwas bereitstellen

Das k3s-Projekt veröffentlicht gemessene Werte statt Schätzungen. Lesen Sie diese Werte sorgfältig, denn die häufig zitierte Zahl beschreibt nicht den Leerlaufverbrauch von k3s.

DiagrammPublished k3s resource use, 95th percentile, Intel 8375C, k3s v1.26.5
Die Daten hinter diesem Diagramm
[
  {
    "label": "Server, sqlite datastore",
    "ram_mb": "1,596",
    "cpu_percent_of_one_core": 6
  },
  {
    "label": "Server, embedded etcd",
    "ram_mb": "1,606",
    "cpu_percent_of_one_core": 6
  },
  {
    "label": "Agent node only",
    "ram_mb": "275",
    "cpu_percent_of_one_core": 3
  }
]

Ein Server-Node in diesem Test verwendete im 95. Perzentil 1,596 MB RAM und etwa 6 Prozent eines CPU-Kerns. Das sind veröffentlichte Werte und keine Messungen aus dieser Anleitung. Im Test lief k3s v1.26.5 mit allen aktivierten mitgelieferten Komponenten sowie einem Monitoring-Stack aus Prometheus und Grafana. Der Cluster war daher nicht leer, sondern ausgelastet. Das Projekt gibt jedoch an, dass die Werte nur den Kubernetes-Datenspeicher und die Control Plane abdecken und anwendungsspezifische Anforderungen ausschließen. Ihre eigenen Container kommen zusätzlich hinzu. Durch den Wechsel von sqlite zu eingebettetem etcd stieg der Verbrauch auf 1,606 MB. Ein Agent-Node, der kubelet und containerd ohne Control Plane ausführt, verwendete 275 MB. Als dokumentiertes Minimum für einen Server gelten 2 Kerne und 2 GB RAM. Dieses Minimum deckt k3s und seine mitgelieferten Komponenten ab, bevor Sie eigene Workloads ausführen.

Die praktische Schlussfolgerung: Auf einer VPS mit 2 GB RAM bleibt Ihnen nach der Control Plane und den mitgelieferten Add-ons nur sehr wenig Speicher. Bei Speicherdruck evicted kubelet Pods. Steigt die Speichernutzung jedoch schnell an, kann der OOM-Killer des Kernels eingreifen, bevor kubelet den Druck erkennt. 4 GB sind eine komfortable Untergrenze für einen Node mit einigen kleinen Diensten. Messen Sie Ihr eigenes System, statt einer veröffentlichten Zahl zu vertrauen, auch nicht dieser.

free -h
sudo k3s kubectl top node
sudo k3s kubectl get pods -A

Führen Sie free -h vor der Installation aus und erneut, sobald jeder Pod in kube-system den Status Running hat. Die Differenz zeigt, wie viele Ressourcen die Control Plane auf Ihrer Hardware benötigt. k3s kubectl top node gibt in den ersten ein bis zwei Minuten nach der Installation error: Metrics API not available zurück, weil metrics-server noch keine Daten erfasst hat. Das ist kein Fehler. Wenn Sie einen Server gleichzeitig für diesen Zweck und für andere Aufgaben dimensionieren, gilt die Berechnung unter RAM und CPU für eine VPS dimensionieren auch hier unverändert.

k3s auf eine feste Version und nicht auf latest installieren

Die Quickstart-Zeile, die viele kopieren, verwendet den Stand des Stable-Kanals an dem Tag, an dem Sie sie ausführen. Auf einem System, das dauerhaft betrieben werden soll, sollten Sie die Version festlegen. k3s stellt für jede Kubernetes-Minolversion einen eigenen Kanal bereit. Daher folgt INSTALL_K3S_CHANNEL=v1.36 den Patch-Versionen innerhalb von v1.36 und wechselt nicht unerwartet zu einer anderen Minor-Version. Im Oktober 2026 verweist der Stable-Kanal auf v1.36.5+k3s1.

Erstellen Sie zuerst die Konfigurationsdatei und installieren Sie k3s anschließend. k3s liest beim Start /etc/rancher/k3s/config.yaml ein. Die darin enthaltenen Einstellungen gelten daher bereits für den ersten Start und für alle späteren Starts.

sudo mkdir -p /etc/rancher/k3s
sudo tee /etc/rancher/k3s/config.yaml >/dev/null <<'EOF'
tls-san:
  - k3s.example.com
EOF
curl -sfL https://get.k3s.io | INSTALL_K3S_CHANNEL=v1.36 sh -

Um statt eines Kanals eine bestimmte Version festzulegen, verwenden Sie INSTALL_K3S_VERSION=v1.36.5+k3s1. Das Pluszeichen ist Teil des Tags. Prüfen Sie anschließend, ob der Dienst gestartet ist.

k3s --version
sudo systemctl status k3s
sudo k3s kubectl get node
sudo k3s kubectl get pods -A

kubectl get node sollte innerhalb von etwa dreißig Sekunden einen Knoten mit dem STATUS Ready anzeigen. Jeder Pod in kube-system sollte den Status Running oder Completed erreichen. Wenn ein Knoten bei NotReady hängen bleibt, wurde die Container-Runtime meist nicht gestartet. Lesen Sie dann sudo journalctl -u k3s -n 100 --no-pager. Auf einem ungewöhnlichen VPS-Image führen Sie sudo k3s check-config aus, bevor Sie weitere Fehler analysieren. Der Befehl meldet fehlende Kernel-Funktionen. Das liefert meist schneller eine Antwort als das Lesen der Logs.

Warum Port 80 bereits verwendet wird und was Sie dafür aufgeben müssen

Dieser Fehler tritt häufig auf einem VPS auf, der bereits einen Dienst bereitstellt. Die Installation ist erfolgreich, aber Traefik erhält keine Adresse, wenn ein anderer Kubernetes-Pod auf dem einzigen Node denselben hostPort reserviert.

Der Mechanismus: Das mitgelieferte Traefik-Chart erstellt einen Service vom Typ LoadBalancer für die Ports 80 und 443. ServiceLB erfüllt diese Anforderung, indem es einen DaemonSet mit kleinen Pods erstellt. Deren Namen beginnen mit dem Präfix svclb-. Diese Pods beanspruchen die Portnummern auf jedem Node als hostPort. hostPort leitet den Datenverkehr von einem Node-Port über Netzwerkregeln an den Pod weiter. Der Scheduler prüft die von Kubernetes-Pods deklarierten hostPorts, nicht die von Host-Diensten oder eigenständigen Docker-Containern belegten Sockets. Ein anderer Pod, der denselben hostPort reserviert, verhindert die Einplanung. Ein auf Port 80 lauschendes nginx, Caddy, Apache oder ein eigenständiger Docker-Container verursacht diese Ablehnung durch den Scheduler dagegen nicht.

sudo k3s kubectl -n kube-system get pods
sudo k3s kubectl -n kube-system get svc traefik
sudo ss -lntp '( sport = :80 or sport = :443 )'

Wenn ein anderer Kubernetes-Pod den hostPort reserviert, sehen Sie den svclb-Pod im Status Pending und den Service ohne externe Adresse:

svclb-traefik-8f2c1a-r6k9x   0/2   Pending   0   3m
traefik   LoadBalancer   10.43.62.11   <pending>   80:31480/TCP,443:30219/TCP

kubectl -n kube-system describe pod svclb-traefik-... nennt die Ursache direkt:

0/1 nodes are available: 1 node(s) didn't have free ports for the requested pod ports.

ss -lntp zeigt, welcher Prozess auf dem Port lauscht. Die vom Scheduler geprüften hostPort-Reservierungen werden dabei nicht angezeigt. Es gibt mehrere Lösungen, und jede davon hat einen Nachteil.

Überlassen Sie die Ports k3s. Entfernen Sie alle kollidierenden hostPort-Reservierungen anderer Kubernetes-Pods. Beenden und deaktivieren Sie außerdem den vorhandenen Webserver auf dem Host, damit Traefik den eingehenden Datenverkehr auf 80 und 443 verarbeitet. Das ist die richtige Lösung, wenn der VPS ausschließlich als k3s-Host dienen soll und alle bisher bereitgestellten Dienste hinter einen Ingress verschoben werden.

Deaktivieren Sie ServiceLB und behalten Sie Ihren vorhandenen Proxy. Installieren Sie mit --disable=servicelb. Ein Service vom Typ LoadBalancer weist weiterhin einen NodePort zu. Traefik bleibt dadurch über einen hohen Port wie 31480 erreichbar, und Ihr nginx oder Caddy leitet Anfragen an 127.0.0.1:31480 weiter. Sie verzichten dabei auf die externe Adresse: Der Service meldet dauerhaft <pending>. Das sieht wie ein Fehler aus, obwohl es eine bewusste Entscheidung ist.

Deaktivieren Sie Traefik und verwenden Sie Ihren eigenen Proxy für das Routing. Installieren Sie mit --disable=traefik. Dann gibt es keinen Ingress-Controller. Ingress-Objekte haben daher überhaupt keine Wirkung: Sie bleiben in der API, ohne dass ein Controller sie überwacht. Das ist sinnvoll, wenn Sie den Datenverkehr von einem Proxy auf dem Host zu NodePorts leiten. Es ist außerdem die klare Entscheidung, wenn Sie bereits wissen, wie HTTP verarbeitet werden soll. Wenn Sie noch nicht entschieden haben, welcher Dienst vorgeschaltet werden soll, klären Sie die Auswahl zwischen nginx, Caddy und Traefik als Reverse Proxy, bevor Sie etwas deaktivieren.

Beide Flags gehören zum Installer oder in die Konfigurationsdatei:

tls-san:
  - k3s.example.com
disable:
  - traefik
  - servicelb

Sie können die Datei auch nach der Installation bearbeiten und anschließend sudo systemctl restart k3s ausführen. Das funktioniert, weil --disable beim Installieren nicht nur eine Komponente überspringt. Der Befehl löscht auch eine bereits bereitgestellte Komponente. Dadurch wird die Änderung in einem laufenden Cluster wirksam.

Wenn Sie Traefik behalten, aber die Konfiguration des Charts ändern möchten, bearbeiten Sie /var/lib/rancher/k3s/server/manifests/traefik.yaml nicht. k3s schreibt diese Datei bei jedem Start mit den Standardwerten neu. Legen Sie stattdessen eine separate Datei im selben Verzeichnis an. Alles in /var/lib/rancher/k3s/server/manifests wird beim Start und bei Änderungen an der Datei automatisch angewendet.

apiVersion: helm.cattle.io/v1
kind: HelmChartConfig
metadata:
  name: traefik
  namespace: kube-system
spec:
  valuesContent: |-
    ports:
      web:
        forwardedHeaders:
          trustedIPs:
            - 10.0.0.0/8

Dieses Beispiel setzt einen Wert des Traefik-Charts: die Adressen vertrauenswürdiger Proxys. Mit demselben Mechanismus können Sie jeden anderen vom Chart bereitgestellten Wert setzen, einschließlich der Ports.

Persistenter Speicher auf einem Knoten

k3s liefert standardmäßig eine StorageClass namens local-path, die vom lokalen local-path-Provisioner von Rancher bereitgestellt wird. Ein PersistentVolumeClaim ohne storageClassName verwendet diese StorageClass. Die Volumes liegen unter /var/lib/rancher/k3s/storage, jeweils in einem eigenen Unterverzeichnis auf der lokalen Festplatte des Knotens.

sudo k3s kubectl get storageclass
sudo k3s kubectl get pvc -A
sudo ls -l /var/lib/rancher/k3s/storage

Aus „auf der lokalen Festplatte des Knotens“ ergeben sich zwei Folgen. Beide werden erst später relevant.

Die StorageClass verwendet volumeBindingMode: WaitForFirstConsumer. Ein neuer PVC bleibt daher im Status Pending, bis ein Pod ihn tatsächlich einbindet. kubectl describe pvc gibt Folgendes aus:

waiting for first consumer to be created before binding

Das ist normal. Wenn Sie einen PVC allein erstellen und abwarten, wird dieser Status daher nie aufgehoben.

Nach dem Binden erhält das Volume eine Node-Affinität für den Knoten, auf dem es erstellt wurde. Dadurch bleibt jeder Pod, der diesen Claim verwendet, während der gesamten Lebensdauer des Volumes an diesen Knoten gebunden. Auf einem einzelnen Knoten fällt das nicht auf. Wenn Sie später einen zweiten Knoten hinzufügen, wirkt ein Pod, der nicht auf diesen Knoten verschoben werden kann, wie ein Fehler im Scheduler. Führen Sie dann kubectl get pv -o yaml aus. Dort finden Sie den Hostnamen in nodeAffinity.

Für die Backups sind Sie verantwortlich. Beim Neuaufbau der VPS wird dieses Verzeichnis gelöscht. Das gilt auch für das folgende Deinstallationsskript. Sichern Sie /var/lib/rancher/k3s/storage sowie das SQLite-Datastore-Verzeichnis /var/lib/rancher/k3s/server/db/. Kopieren Sie dieses bei gestopptem Dienst, da es sich um eine aktive Datenbank handelt. Sichern Sie außerdem die Server-Token-Datei unter /var/lib/rancher/k3s/server/token. Das Token ist erforderlich: In der k3s-Dokumentation steht, dass Sie diese Datei wiederherstellen oder ihren Wert beim Wiederherstellen des Datastores aus einem Backup an --token übergeben müssen. Alternativ können Sie den Cluster als entbehrlich behandeln und jedes Manifest in git speichern.

Ingress und TLS

Bei aktiviertem Traefik benötigen Sie nur ein standardmäßiges Ingress-Objekt.

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: hello
  annotations:
    cert-manager.io/cluster-issuer: letsencrypt
spec:
  ingressClassName: traefik
  tls:
    - hosts:
        - hello.example.com
      secretName: hello-tls
  rules:
    - host: hello.example.com
      http:
        paths:
          - path: /
            pathType: Prefix
            backend:
              service:
                name: hello
                port:
                  number: 80

Zertifikate werden nicht automatisch erstellt. Üblicherweise verwenden Sie dafür cert-manager, das aus seinem veröffentlichten Manifest installiert wird, sowie einen ClusterIssuer. Die Version v1.21.3, veröffentlicht am 23. Oktober 2026, ist im Oktober 2026 aktuell.

sudo k3s kubectl apply -f https://github.com/cert-manager/cert-manager/releases/download/v1.21.3/cert-manager.yaml
apiVersion: cert-manager.io/v1
kind: ClusterIssuer
metadata:
  name: letsencrypt
spec:
  acme:
    email: you@example.com
    server: https://acme-v02.api.letsencrypt.org/directory
    privateKeySecretRef:
      name: letsencrypt-account-key
    solvers:
      - http01:
          ingress:
            ingressClassName: traefik

Bei der HTTP-01-Challenge verbindet sich der ACME-Server (Automatic Certificate Management Environment) aus dem öffentlichen Internet mit http://hello.example.com/.well-known/acme-challenge/.... Der DNS-Eintrag des Hostnamens, ein A-Record oder ein AAAA-Record, wenn der VPS über IPv6 erreichbar ist, muss daher bereits auf den VPS zeigen. Außerdem muss Port 80 Traefik erreichen. Wenn beide Adressen vorhanden sind, versucht Let's Encrypt zuerst die IPv6-Adresse. Läuft die anfängliche IPv6-Verbindung in einen Timeout, wird auf IPv4 zurückgefallen. Andere Fehler, einschließlich einer falschen Challenge-Antwort, lösen diesen Fallback nicht aus. Für umgeleitete Anfragen erfolgt kein erneuter Versuch. Korrigieren oder entfernen Sie einen veralteten AAAA-Record. Wenn Sie ServiceLB deaktiviert und einen eigenen Proxy vorgeschaltet haben, muss dieser Proxy auch den Challenge-Pfad weiterleiten. Andernfalls bleibt cert-manager hängen und zeigt im Challenge-Objekt Folgendes an:

Waiting for HTTP-01 challenge propagation: wrong status code '404', expected '200'

Überwachen Sie die Ausstellung mit sudo k3s kubectl describe certificate hello-tls und sudo k3s kubectl get order,challenge -A.

Die kubeconfig und warum der API-Server privat bleibt

k3s schreibt die Administratorzugangsdaten nach /etc/rancher/k3s/k3s.yaml. Die Datei gehört root und wird standardmäßig mit dem Modus 600 angelegt. Sie enthält ein Clientzertifikat mit cluster-admin-Berechtigungen. Jeder, der die Datei lesen kann, kontrolliert damit den Cluster.

sudo k3s kubectl get node
export KUBECONFIG=/etc/rancher/k3s/k3s.yaml
kubectl get node

Ein separat installiertes kubectl kennt die k3s-Datei nicht. Wenn KUBECONFIG nicht gesetzt ist, liest kubectl ~/.kube/config. Existiert diese Datei nicht, schlägt der Aufruf mit The connection to the server localhost:8080 was refused - did you specify the right host or port? fehl, weil überhaupt kein Cluster konfiguriert ist. Setzen Sie KUBECONFIG, kopieren Sie die Datei wie unten gezeigt nach ~/.kube/config oder verwenden Sie sudo k3s kubectl. Dieses Programm liest automatisch die richtige Datei.

Häufig wird --write-kubeconfig-mode 644 empfohlen, damit ein normaler Benutzer kubectl ausführen kann. Beachten Sie, was dadurch geschieht: Ein Cluster-Administratorzugang wird für jedes lokale Konto auf dem Rechner lesbar. Auf einem Rechner mit nur einem Administrator kann dieser Kompromiss akzeptabel sein. Auf einem gemeinsam genutzten Rechner ist er es nicht. Durch das Kopieren der Datei erhält stattdessen ein einzelner Benutzer Zugriff, ohne die Datei für andere bereitzustellen:

mkdir -p ~/.kube
sudo install -o $USER -g $USER -m 600 /etc/rancher/k3s/k3s.yaml ~/.kube/config

Die Zeile server: in dieser Datei lautet https://127.0.0.1:6443. Um kubectl von Ihrem Laptop aus zu verwenden, öffnen Sie Port 6443 nicht im Internet. Eine öffentlich erreichbare Kubernetes-API ist ein dauerhaftes Ziel für Angriffe. Ein offener API-Server führt dazu, dass kleine Cluster für das Mining von Kryptowährungen durch Dritte missbraucht werden. Leiten Sie den Zugriff über SSH weiter und lassen Sie die Adresse in der Datei unverändert:

ssh -N -L 6443:127.0.0.1:6443 user@your-vps
KUBECONFIG=./k3s.yaml kubectl get node

Wenn Sie die API über eine private Netzwerkadresse erreichen müssen, installieren Sie k3s mit tls-san, wobei Sie diesen Namen oder diese Adresse angeben. Ändern Sie anschließend in der kopierten Datei die Zeile server: entsprechend. Ohne den SAN-Eintrag (subject alternative name) verweigert kubectl die Verbindung:

x509: certificate is valid for 127.0.0.1, 10.43.0.1, not 203.0.113.10

Die dokumentierten eingehenden Ports für einen Cluster sind TCP 6443 für die API, UDP 8472 für flannel VXLAN zwischen den Knoten und TCP 10250 für kubelet-Metriken. Auf einem einzelnen Knoten muss keiner dieser Ports im Internet geöffnet sein.

containerd ist nicht Docker

k3s verwendet ein eigenes eingebettetes containerd und teilt keinen Image-Speicher mit Docker. Ein Image, das Sie gerade mit docker build erstellt haben, ist für k3s nicht sichtbar. Deshalb schlägt der Pod mit ErrImagePull fehl, obwohl docker images das Image auflistet. Importieren Sie es ausdrücklich:

docker save myapp:0.1 | sudo k3s ctr images import -
sudo k3s crictl images

Verwenden Sie anschließend für diesen Container nicht den Tag :latest. :latest verwendet standardmäßig ein imagePullPolicy von Always, und der kubelet greift deshalb trotzdem auf eine Registry zu. Jeder andere Tag verwendet standardmäßig IfNotPresent und nutzt damit das importierte Image. Beide Systeme können auf einem VPS betrieben werden. Dabei ist wichtig zu wissen, dass eine normale Docker-Installation auf einem VPS und k3s auf demselben Rechner jeweils einen eigenen Image-Speicher und eigene iptables-Regeln verwenden.

So entfernen Sie k3s

Das Installationsprogramm legt ein Deinstallationsskript an. Eine teilweise Entfernung und eine Rückgängig-Funktion gibt es nicht.

sudo /usr/local/bin/k3s-uninstall.sh

Das Skript beendet und entfernt den Dienst, löscht den Datenspeicher und die Daten persistenter Volumes, entfernt die Knotenkonfiguration und löscht die vom Installationsprogramm hinzugefügten Werkzeuge. Auf einem Agent-Knoten heißt das Skript stattdessen k3s-agent-uninstall.sh. Kopieren Sie zunächst alle Daten unter /var/lib/rancher/k3s/storage vom System, weil dieses Verzeichnis zusammen mit k3s entfernt wird. Prüfen Sie anschließend mit ip link show und sudo ss -lntp, dass keine Prozesse mehr Ports oder Netzwerkschnittstellen belegen. Eine verbliebene cni0- oder flannel.1-Schnittstelle wird beim nächsten Reboot entfernt.

Zu entscheiden, dass ein Kubernetes-Knoten für die Aufgabe mehr Aufwand als Nutzen bedeutet, ist ein normales Ergebnis und kein Fehlschlag. Die Workloads zurück zu Compose zu verschieben, dauert normalerweise einen Nachmittag.

Fehlerbilder und die angezeigten Meldungen

Node NotReady oder k3s wird fortlaufend neu gestartet. Lesen Sie zuerst sudo journalctl -u k3s -n 200 --no-pager. Auf einem kleinen VPS ist häufig der Out-of-Memory-Killer des Kernels die Ursache. Er beendet den Prozess. In dmesg erscheint dann eine Zeile mit dem Namen k3s-server. Das dokumentierte Minimum von 2 GB ist eine reale Untergrenze.

Ein Pod bleibt im Status Pending. kubectl describe pod nennt die Ursache in jedem Fall. Insufficient memory oder Insufficient cpu bedeutet, dass auf dem Node kein Platz mehr verfügbar ist. didn't have free ports bedeutet, dass ein anderer Kubernetes-Pod einen kollidierenden hostPort reserviert. waiting for first consumer bei einer PVC bedeutet, dass WaitForFirstConsumer ordnungsgemäß arbeitet.

ImagePullBackOff. Der Node konnte das Image nicht abrufen. Prüfen Sie den Namen und den Tag des Images, den Zugriff auf die Registry und die Zugangsdaten. Prüfen Sie außerdem, ob Sie das Image mit Docker erstellt, aber nie in containerd importiert haben.

Traefik antwortet, die Anwendung jedoch nicht. Ein Antworttext mit 404 page not found stammt direkt von Traefik. Er bedeutet, dass die Anfrage angekommen ist, aber kein Router darauf zutrifft. Prüfen Sie, ob die Ingress-host mit dem eingegebenen Namen übereinstimmt und ob ingressClassName auf traefik gesetzt ist.

Die Cluster-DNS-Auflösung schlägt fehl, während der Host Namen korrekt auflöst. Prüfen Sie CoreDNS mit sudo k3s kubectl -n kube-system logs -l k8s-app=kube-dns. Eine Meldung wie plugin/loop: Loop ... detected for zone "." verhindert den Start von CoreDNS. Die Ursache ist, dass CoreDNS Anfragen an einen Resolver weiterleitet, der sie wiederum an CoreDNS zurückleitet. Genau das bewirkt eine Loopback-Adresse in /etc/resolv.conf. Verweisen Sie k3s mit --resolv-conf /run/systemd/resolve/resolv.conf auf die tatsächliche Upstream-Datei.

FAQ

Lohnt sich k3s auf einem einzelnen VPS?

k3s lohnt sich, wenn Sie die Kubernetes-API benötigen: um sie auf einer von Ihnen verwalteten Maschine zu erlernen, Deployments als portable Manifeste zu verwalten, Software auszuführen, die nur ein Helm-Chart veröffentlicht, oder etwas aufzubauen, das Sie später in einen verwalteten Cluster verschieben. Wenn Sie nur Container ausführen möchten, lohnt es sich nicht, weil Docker Compose dies mit deutlich weniger Verwaltungsaufwand und ungefähr einem Gigabyte mehr freiem RAM erledigt. Ein einzelner Node bietet keine Hochverfügbarkeit. Zuverlässigkeit ist daher kein Grund, sich dafür zu entscheiden.

Warum bleibt mein k3s-LoadBalancer-Service im Status Pending?

ServiceLB erstellt svclb- Pods, die die Ports des Service auf dem Node als hostPort belegen. Sie werden daher nur auf Nodes eingeplant, auf denen diese Ports frei sind. Wenn bereits ein anderer Kubernetes-Pod denselben hostPort reserviert, bleibt der Pod im Status Pending und der Service erhält nie eine externe Adresse. Ein Host-Proxy oder ein eigenständiger Docker-Container, der auf Port 80 lauscht, verursacht diese Ablehnung der Einplanung nicht selbst. kubectl -n kube-system describe pod svclb-... meldet 0/1 nodes are available: 1 node(s) didn't have free ports for the requested pod ports. Entfernen Sie die hostPort-Reservierung des konfligierenden Pods oder deaktivieren Sie ServiceLB mit --disable=servicelb und leiten Sie Anfragen an den NodePort weiter, den der Service weiterhin zuweist.

Wie viel RAM benötigt k3s auf einem VPS?

Das dokumentierte Minimum für einen Server-Node beträgt 2 Kerne und 2 GB. Dies deckt k3s und seine mitgelieferten Komponenten ab, bevor Ihre Workloads ausgeführt werden. Das Profiling-Projekt hat die Speicherbelegung der Control Plane und des Datastore eines Server-Nodes mit 1,596 MB gemessen, während darauf ein Monitoring-Stack lief. Dieser Wert schließt den eigenen Speicherbedarf des Workloads nicht ein. Betrachten Sie 2 GB daher als Untergrenze und 4 GB als erste Größe, bei der ein einzelner Node ausreichend Reserven hat. Messen Sie Ihr eigenes System mit free -h vor der Installation und erneut, nachdem jeder Pod in kube-system den Status Running meldet.

Kann ich Docker und k3s auf demselben VPS ausführen?

Ja, die beiden Umgebungen bleiben getrennt. k3s verwendet sein eigenes eingebettetes containerd. Ein mit docker build erstelltes Image ist daher erst sichtbar, nachdem Sie docker save myapp:0.1 | sudo k3s ctr images import - ausgeführt haben. Beide schreiben außerdem eigene iptables-Regeln und verwenden eigene Bridge-Netzwerke. Überwachen Sie den gesamten Speicherverbrauch, weil Docker, k3s und Ihre Container den RAM des Systems gemeinsam nutzen.

Wie entferne ich k3s vollständig?

Führen Sie auf einem Server-Node sudo /usr/local/bin/k3s-uninstall.sh oder auf einem Agent sudo /usr/local/bin/k3s-agent-uninstall.sh aus. Dadurch wird der Dienst gestoppt, der Datastore gelöscht, die persistenten Volume-Daten unter /var/lib/rancher/k3s/storage entfernt und die mitgelieferten Tools werden gelöscht. Kopieren Sie alle Daten, die Sie behalten möchten, zuerst vom System, da die Aktion nicht rückgängig gemacht werden kann. Eine zurückgebliebene Netzwerkschnittstelle cni0 oder flannel.1 verschwindet beim nächsten Reboot.

War dieser Artikel hilfreich?