Zum Inhalt springen

Einen Knoten entfernen

Es gibt einen Befehl, und er ist destruktiv. Lies das, bevor du ihn ausführst.

Terminal-Fenster
sudo scripts/tc-operator/tc-operator uninstall --config operator.yaml

In dieser Form ist er sicher. Er:

  1. Nimmt zuerst einen Datenbank-Dump, nach /etc/trusted-codes/backup-<zeitstempel>.sql.gz, Modus 0600.
  2. Zählt echte Nutzerzeilen.
  3. Verweigert die Ausführung, wenn es welche gibt, und sagt dir, wo das Backup liegt.

Diese Verweigerung ist die Schutzschiene. Den Stack abzubauen entfernt die Datenvolumes, und auf einem Knoten mit echten Nutzern ist das von nichts mehr auf der Box wiederherstellbar.

Terminal-Fenster
sudo scripts/tc-operator/tc-operator uninstall --config operator.yaml --purge

Das ist der destruktive Weg. Er nimmt weiterhin zuerst den Dump, und bittet dich dann, den Projektnamen im Terminal einzutippen, um zu bestätigen. Nach dieser Bestätigung baut er den Stack samt seiner Volumes ab und entfernt die erzeugten Zertifikate und Geheimnisse.

Was das konkret bedeutet:

  • Die Datenbank ist weg, mit jedem Konto, jeder Verbindung, jedem Codewort und jedem Tresor auf dem Knoten.
  • /etc/trusted-codes/secrets.env wird entfernt. Damit gehen die Föderationsidentität des Knotens und der Schlüssel verloren, der persönliche Daten entschlüsselt. Der Backup-Dump, den er gerade geschrieben hat, ist ohne diese Datei unlesbar.
  • Das mTLS-Zertifikat wird entfernt. Eine spätere Installation prägt ein neues mit einem neuen Fingerabdruck, das erneut verifiziert und aufgenommen werden muss.

Also, bevor du purgest: Kopiere das Backup und eine Kopie von secrets.env von der Box, falls es eine Chance gibt, dass du die Daten zurückhaben willst. Nur den Dump zu kopieren gibt dir eine Datei, die niemand lesen kann.

Nur zwei Befehle in tc-operator verlangen, dass du etwas zurücktippst: diesen und rollback. Alles andere läuft ohne getippte Bestätigung, weil alles andere nur deine eigene Box betrifft und wiederherstellbar ist. Dieser hier ist es nicht.

Terminal-Fenster
tc-operator uninstall --local --config operator.yaml --purge

Derselbe Befehl, gerichtet auf das isolierte Loopback-Projekt, das eine --local-Installation anlegt. Er lässt einen echten Knoten auf derselben Maschine unangetastet.

Er entfernt deinen Knoten von deiner Box. Er entfernt ihn nicht aus der Registry.

Der Aufnahmeeintrag deines Knotens, und der zentrale Datensatz davon, werden von Trusted Codes entfernt — der Befehl dafür ist zentral und überhaupt nicht Teil der Operator-Distribution. Legst du einen Knoten endgültig still, sag es ihnen, damit eine spätere Neuinstallation bei null beginnt statt mit einem veralteten Eintrag zu kollidieren.

Peers, die deinen Knoten bereits in ihrer Kopie der Registry halten, hören auf, ihm zu vertrauen, sobald die signierte Registry ohne ihn erneut veröffentlicht wird. Das geschieht nicht sofort, und es ist nichts, was du von der Box aus steuerst.

Wahrscheinlich willst du gar nicht uninstall.

  • Um eine Web-Oberfläche zu stoppen: tc-operator service stop <oberfläche>. Das Bundle bleibt erhalten, und ein Neustart ist schnell. Siehe Den Knoten betreiben.
  • Um keine neuen Konten mehr zu akzeptieren: setze auth.registration_mode: closed und lade neu.
  • Um andere Server davon abzuhalten, Einladungen auf deinem Knoten zu platzieren: der eingehende Notschalter in der Admin-App, unter Node Settings. Er lässt sich aus jedem Zustand heraus auf Verweigern setzen.
  • Um das Mesh zu verlassen, ohne den Knoten zu verlassen: Schalte die Föderations-Flags in operator.yaml aus und lade neu.

Jedes davon ist umkehrbar. Uninstall ist es nicht.