Configurer les interfaces réseau avec netplan sur Ubuntu et tester les modifications sans perdre la connexion

Objectif

Modifier une adresse IP statique, une route ou une configuration de bonding sur Ubuntu 22.04/24.04 avec netplan, sans risquer de perdre l'accès à une machine distante.

Prérequis

Accès root ; savoir quel moteur de rendu (renderer) est actif (networkd est le choix par défaut sur Server, NetworkManager sur Desktop) ; un type de session qui résiste à une brève coupure réseau (pour l'apply final, un accès console est plus sûr que SSH).

Étapes

1. Repérer la configuration existante, normalement un fichier sous /etc/netplan/*.yaml. La référence YAML de netplan indique que la clé renderer désigne « the tool that will be used to set up your configuration. Valid values are networkd and NetworkManager » (l'outil utilisé pour mettre en place la configuration ; valeurs valides : networkd et NetworkManager), avec networkd par défaut si elle n'est pas définie.
2. Modifier ou ajouter un fichier avec les paramètres souhaités, par exemple une adresse statique :

   network:
     version: 2
     ethernets:
       eth0:
         addresses: [192.0.2.10/24]
         routes:
           - to: default
             via: 192.0.2.1
         nameservers:
           addresses: [192.0.2.1]
   

3. Réserver la lecture des fichiers YAML à root (chmod 600 /etc/netplan/*.yaml) ; les versions récentes de netplan émettent un avertissement pour les fichiers lisibles par tous, car ils peuvent contenir des clés Wi-Fi et d'autres secrets. Valider la syntaxe sans appliquer : netplan generate produit la configuration du backend dans un emplacement temporaire et échoue avec un message explicite en cas d'erreur YAML ou de schéma.
4. Dans toute session où une erreur pourrait couper la connectivité, utiliser netplan try plutôt que netplan apply directement. netplan try « takes a netplan configuration, applies it, and automatically rolls it back if the user does not confirm the configuration within a time limit » (prend une configuration netplan, l'applique et l'annule automatiquement si l'utilisateur ne la confirme pas dans un délai donné) ; ce délai est de 120 secondes par défaut et peut être modifié avec --timeout.
5. Confirmer en appuyant sur Entrée avant la fin du délai ; si la session est déjà perdue, ne rien faire : le retour arrière automatique rétablit la configuration précédente.
6. Une fois la configuration confirmée, lancer netplan apply si des modifications supplémentaires ont été faites, puis vérifier avec ip addr show eth0 et ip route.

Résultat attendu

ip addr affiche la nouvelle adresse immédiatement après un netplan try/apply confirmé ; une configuration erronée est annulée d'elle-même dans le délai imparti et la connectivité revient sans intervention manuelle.

Limites et base de vérification

Certaines configurations (par exemple les bridges avec STP activé) peuvent mettre plus d'une minute à se stabiliser ; la note sur les problèmes connus de l'outil signale que le délai par défaut peut alors être trop court. Aucun redémarrage n'est nécessaire ; une nouvelle connexion peut l'être uniquement si la modification touche l'interface utilisée par la session en cours. L'alternative classique de Debian, ifupdown, conserve les définitions d'interfaces dans /etc/network/interfaces au lieu de YAML, et les applique avec ifup/ifdown plutôt qu'avec un moteur de rendu ; elle n'a pas de commande équivalente d'essai avec retour arrière, donc les modifications doivent y être testées directement depuis un accès console.