Renommer un hôte

Changer le nom d’un poste, d’un serveur ou d’une passerelle, sans toucher au matériel. Le nom d’hôte sert de clé partout : il désigne le nœud de déploiement, le dossier de la machine et l’étiquette de supervision.

Pour un remplacement de machine, voir Migrer le matériel d’une passerelle.

Ce qui suit tout seul

Régénéré, puis propagé au déploiement, sans intervention.

Repris automatiquement	Pourquoi
DNS et DHCP de la zone	Dérivés du nom déclaré
Registre des services, portail, reverse proxy	Dérivés du nom déclaré
Cibles de supervision, tags de déploiement	Dérivés du nom déclaré
Secrets sops	Liés à la clé SSH de l’hôte, pas à son nom
Clés SSH de déploiement	Jamais épinglées pour le compte de déploiement

Procédure

1. Renommer dans la configuration

   etc/config.yaml

   - hostname: "srv-maison"   # ancien nom : "srv"
     zone: "maison:1.2"
     profile: "server"

2. Déplacer le dossier de la machine

   git mv usr/machines/srv usr/machines/srv-maison

   Étape obligatoire

   Ce dossier est importé par son chemin, usr/machines/<nom-d-hôte>. Oublié, il est ignoré en silence : le fichier hardware-configuration.nix et les réglages propres à la machine quittent la configuration construite.

3. Régénérer

   just clean

4. Créer le compte de sauvegarde

   just passwd-restic

   Sinon le serveur de sauvegarde ne démarre plus

   Un serveur restic déclare un secret par nom d’hôte du parc, que l’hôte soit sauvegardé ou non. Sans le secret du nouveau nom, l’activation de sops échoue sur ce serveur. La commande est idempotente et lit les fichiers générés, donc la lancer après just clean.

5. Valider

   just commit "refactor(maison): rename srv to srv-maison"

6. Déployer

   Le nœud est adressé par son nom, qui doit résoudre depuis la machine d’administration. Le plus sûr est de rediriger le ssh vers son adresse, le temps du premier déploiement.

   just roaming srv-maison 10.0.1.2
   just apply srv-maison
   just roaming-clear srv-maison

   Sans redirection, déployer d’abord la passerelle de la zone depuis laquelle vous administrez : elle publie alors le nouveau nom dans son DNS.

7. Rendre le nouveau nom effectif

   Le déploiement écrit le nom statique, mais celui du noyau ne change qu’au démarrage : hostname rend encore l’ancien nom tant que la machine n’a pas redémarré.

   just reboot srv-maison

   Pour éviter la coupure, poser le nom à chaud, puis redémarrer les services qui l’ont lu à leur lancement (le client VPN d’abord).

   sudo hostname srv-maison
   sudo systemctl restart tailscaled

   Ne pas passer par hostnamectl

   Cette commande réécrit /etc/hostname, qui est un lien vers le store en lecture seule. Le lien serait remplacé par un fichier ordinaire et le nom cesserait de suivre la configuration aux déploiements suivants.

   Avant un redémarrage à distance

   Vérifier qu’aucun disque chiffré n’attend une passphrase au démarrage, sinon la machine s’arrête en initrd, hors de portée du réseau.

Garder l’ancien nom

Le champ aliases ajoute des noms DNS supplémentaires, utile pour les appareils qui gardent l’ancien nom en signet.

etc/config.yaml

- hostname: "srv-maison"
  aliases: ["srv"]

Portée limitée à la zone

Un alias n’est publié que dans la zone de son hôte, alors que le nom d’hôte est publié dans toutes les zones. L’ancien nom ne résout donc plus que depuis le réseau local de sa zone.

Alias posé à l’avance

Réserver le futur nom en alias est commode, mais cet alias doit disparaître dans la même édition que le renommage : un alias ne peut pas porter le nom d’un hôte de sa zone, le générateur refuse la configuration.

Cas d’une passerelle

Une passerelle porte le DNS et le cache binaire de sa zone, d’où deux règles d’ordre :

• Déployer la passerelle avant ses clients (leur cache binaire vise son nom).
• Déployer ensuite les passerelles des autres zones, qui publient le nouveau nom.

Le nœud VPN garde sa clé, son adresse et ses routes approuvées. Seul le nom affiché reste figé, à corriger sur le serveur de coordination.

sudo headscale nodes list
sudo headscale nodes rename <nouveau-nom> -i <identifiant>

Ne jamais supprimer le nœud

Supprimer puis ré-enrôler libère l’adresse fixe du tailnet et efface les routes approuvées. Voir VPN.

Après le renommage

• Supervision : l’étiquette d’hôte change, l’historique des graphiques est coupé.
• Mises en silence : celles qui portent l’ancien nom sont à recréer.
• Sauvegardes : si l’hôte sauvegarde, renommer son dépôt sur le serveur, sinon un dépôt vide est créé.
• Outillage : l’ancien nœud quitte la ruche, tout script qui le cite échoue bruyamment.

Contrôle final

just apply srv-maison build confirme que le nœud existe et que sa configuration évalue. Après déploiement, just enter srv-maison puis hostname doit rendre le nouveau nom. Voir Sauvegardes réseau pour le renommage d’un dépôt restic.