Aller au contenu

Retirer un nœud

Il y a une commande, et elle est destructrice. Lis ça avant de la lancer.

Fenêtre de terminal
sudo scripts/tc-operator/tc-operator uninstall --config operator.yaml

Sous cette forme, c’est sans danger. Ça :

  1. Prend un vidage de la base de données d’abord, vers /etc/trusted-codes/backup-<timestamp>.sql.gz, mode 0600.
  2. Compte les lignes d’utilisateurs réels.
  3. Refuse s’il y en a, et te dit où se trouve la sauvegarde.

Ce refus est le garde-fou. Démonter la pile retire les volumes de données, et sur un nœud avec de vrais utilisateurs ce n’est récupérable depuis rien de ce qui reste sur la machine.

Fenêtre de terminal
sudo scripts/tc-operator/tc-operator uninstall --config operator.yaml --purge

C’est le chemin destructeur. Ça prend quand même le vidage d’abord, puis te demande de taper le nom du projet au terminal pour confirmer. Passé cette confirmation, ça démonte la pile avec ses volumes et retire les certificats et secrets générés.

Ce que ça signifie concrètement :

  • La base de données a disparu, avec chaque compte, connexion, code et coffre sur le nœud.
  • /etc/trusted-codes/secrets.env est retiré. Avec lui part l’identité de fédération du nœud et la clé qui déchiffre les données personnelles. Le vidage de sauvegarde qui vient d’être écrit est illisible sans ce fichier.
  • Le certificat mTLS est retiré. Une future installation en frappe un nouveau avec une nouvelle empreinte, qui doit être vérifiée et admise à nouveau.

Donc avant de purger : copie la sauvegarde et une copie de secrets.env hors de la machine, s’il y a la moindre chance que tu veuilles récupérer les données un jour. Copier le vidage seul te donne un fichier que personne ne peut lire.

Seules deux commandes dans tc-operator te font taper quelque chose en retour : celle-ci, et rollback. Tout le reste tourne sans confirmation tapée, parce que tout le reste ne touche que ta propre machine et est récupérable. Celle-ci ne l’est pas.

Fenêtre de terminal
tc-operator uninstall --local --config operator.yaml --purge

Même commande, pointée vers le projet de bouclage isolé qu’une installation --local crée. Ça laisse tranquille un vrai nœud sur la même machine.

Ça retire ton nœud de ta machine. Ça ne le retire pas du registre.

L’entrée d’admission de ton nœud, et le registre central de celle-ci, sont retirés par Trusted Codes — la commande qui le fait est centrale, et ne fait pas partie de la distribution de l’exploitant du tout. Si tu retires un nœud pour de bon, dis-le-leur, pour qu’une future installation reparte de zéro plutôt que d’entrer en collision avec une entrée périmée.

Les pairs qui détiennent déjà ton nœud dans leur copie du registre cessent de lui faire confiance quand le registre signé se republie sans lui. Ce n’est pas instantané, et ce n’est pas quelque chose que tu contrôles depuis la machine.

Si tu veux seulement arrêter de servir quelque chose

Section intitulée « Si tu veux seulement arrêter de servir quelque chose »

Tu ne veux probablement pas uninstall du tout.

  • Pour arrêter une surface web : tc-operator service stop <surface>. Le paquet est conservé et un redémarrage est rapide. Voir Faire tourner le nœud.
  • Pour arrêter d’accepter de nouveaux comptes : règle auth.registration_mode: closed et recharge.
  • Pour arrêter que d’autres serveurs placent des invitations sur ton nœud : l’interrupteur entrant dans l’application d’administration, sous les réglages du nœud. Il peut être réglé sur refus depuis n’importe quel état.
  • Pour quitter le maillage sans quitter le nœud : désactive les drapeaux de fédération dans operator.yaml et recharge.

Chacun de ces gestes est réversible. Uninstall ne l’est pas.