EasyUC

Software, Updates und Lizenzdateien finden Sie im Kundenbereich. Zu den Downloads

Nodes hinzufügen und entfernen

Voraussetzungen, Ablauf im Manager, was technisch passiert und warum ein Cluster drei Nodes haben sollte.

Gilt für: EasyUC 4.8.7 Stand: Oktober 2026

Voraussetzungen

  • Eine vorbereitete EasyUC-VM mit der IP-Adresse, die Sie im Manager angeben.
  • Der erste Node erreicht diese VM per SSH auf TCP 15222.
  • Empfohlen: alle Nodes im selben Netzsegment, ohne Firewall-Filterung zwischen den Nodes. Die Ports stehen unter Zwischen den Cluster-Nodes.

Node im Manager hinzufügen

  1. Öffnen Sie im Manager die Übersicht der Nodes.

  2. Wählen Sie Knoten hinzufügen.

  3. Geben Sie die IP-Adresse der vorbereiteten VM ein, optional einen Namen.

  4. Bestätigen Sie. Der Manager richtet den Node ein. Danach erscheint er in der Übersicht mit CPU- und RAM-Auslastung.

Was technisch passiert

Der Manager richtet den neuen Node selbst ein:

Ablauf beim Hinzufügen eines Nodes Der Administrator gibt im Manager IP-Adresse und Namen ein. Der Manager verbindet sich per SSH auf TCP 15222 mit der neuen VM, setzt den Hostnamen und installiert K3s aus lokalen Dateien. Die VM tritt mit dem Cluster-Token über TCP 6443 dem Cluster bei und wird Server-Node. Danach erscheint der Node in der Übersicht. Administrator Browser EasyUC Manager erster Node Neue VM vorbereitet Cluster K3s · etcd Knoten hinzufügen: IP, Name SSH · TCP 15222 Hostname setzen K3s aus lokalen Dateien Beitritt mit Cluster-Token TCP 6443 Server-Node: Control Plane, etcd, Workloads Node in der Übersicht
Ablauf beim Hinzufügen eines Nodes
  • Der Manager verbindet sich per SSH auf TCP 15222 mit der neuen VM.
  • Er setzt den Hostnamen und installiert K3s aus den lokalen Dateien der Appliance.
  • Der Node tritt dem Cluster mit dem Cluster-Token bei, über die Kubernetes-API auf TCP 6443.

Jeder Node ist ein Server

Jeder hinzugefügte Node tritt als vollwertiger K3s-Server bei. Er gehört zur Control Plane, ist Mitglied im etcd-Cluster und führt zugleich Workloads aus. Reine Worker-Nodes bietet der Manager nicht an.

Damit zählt jeder Node für die etcd-Mehrheit, siehe Warum drei Nodes.

Node entfernen

Wenn Sie einen Node im Manager entfernen, läuft Folgendes ab:

  1. Cordon

    Auf dem Node werden keine neuen Workloads mehr eingeplant.

  2. Drain

    Die Workloads ziehen auf andere Nodes um.

  3. Deinstallation

    Der Node wird deinstalliert.

Wichtig

Jeder Dienst läuft in einer Instanz. Beim Drain werden die Komponenten auf dem Node beendet und auf einem anderen Node neu gestartet, die betroffenen Dienste sind dabei kurz unterbrochen. Entfernen Sie Nodes deshalb in einem Wartungsfenster.

Hinweis

Den letzten Node können Sie nicht entfernen. Die IP-Adresse lässt sich nur bei Installationen mit einem einzelnen Node ändern.

Warum drei Nodes

Die Control Plane bleibt funktionsfähig, solange die Mehrheit der Server-Nodes verfügbar ist. Das ist ein allgemeines Prinzip von etcd und damit von Kubernetes.

etcd-Mehrheit und tolerierte Ausfälle
Server-NodesMehrheitTolerierte AusfälleBedeutung
1 1 0 Keine Redundanz
2 2 0 Kein Gewinn an Ausfallsicherheit. Fällt ein Node aus, fehlt die Mehrheit.
3 2 1 Übersteht den Ausfall eines Nodes. Unsere Empfehlung.
5 3 2 Übersteht den Ausfall von zwei Nodes.

Für Redundanz empfehlen wir drei Nodes, allgemein eine ungerade Anzahl. Damit ist die Control Plane abgesichert. Wie die Dienste selbst auf einen Ausfall reagieren, beschreibt Redundanz.

Platzierung der Komponenten

  • Mehrere Web- und API-Komponenten dürfen nicht zweimal auf demselben Node laufen (Anti-Affinity pro Host).
  • teams-sbc läuft auf dem Node, auf dem acd-media läuft.
  • Beide nutzen das Host-Netzwerk. RTP-Freigaben und das 1:1-NAT für Teams müssen deshalb auf diesen Node zeigen.