====== netplan ======
Netplan permet de configurer à la fois [[:network-manager|NetworkManager]] (Ubuntu Desktop) et systemd-networkd (Ubuntu Server).

**Netplan** est un nouvel outil de configuration réseau qui utilise des fichiers de description YAML. Il vient en complément de [[:network-manager|NetworkManager]] (par défaut sur Ubuntu Desktop) et systemd-networkd (sur Ubuntu Server).

===== Configuration =====
Les fichiers de configuration se trouvent dans ''/etc/netplan/''


<note>S'il n'y a pas de précisions, les explications portent sur **NetworkManager** C'est le gestionnaire de réseau par défaut sur les versions de bureau (desktop) avec interface graphique.\\ 
On peut vérifier que c'est bien ce gestionnaire en vérifiant qu'il est actif :
<code bash>systemctl status NetworkManager</code>
</note>

Pour connaître la  configuration actuelle :
<code bash>
sudo netplan get
</code>

==== NetworkManager ====

Le nom de l'interface (ici ''eth0'') doit être remplacé par le vôtre s'il est différent. Utilisez 
<code bash>
# commande simple :
ip a
# ou plus  claire :
networkctl list
</code> pour lister les interfaces réseaux de votre PC, généralement les noms des réseaux filaires (ethernet) commencent par ''en'' tandis que ceux sans-fils (Wi-Fi) commenceront par ''wl''.

<note important>Il ne faut pas utiliser de tabulation dans les fichiers YAMl (.yml ou .yaml). L'indentation doit utiliser des espaces</note>

=== Exemple de configuration statique ===
<file - /etc/netplan/*.yaml>
network:
    version: 2
    renderer: NetworkManager
    ethernets:
        eth0:
            addresses: [192.168.1.200/24]
            routes:
               - to: default
                 via: 192.168.1.1 
            nameservers:
                addresses: [8.8.8.8, 8.8.4.4]
            dhcp4: false
            dhcp6: false
</file>

=== Exemple de configuration DHCP ===
<file - /etc/netplan/*.yaml>
network:
  version: 2
  ethernets:
    eth0:
      dhcp4: true
</file>

=== Appliquer la configuration netplan ====
<code bash>
sudo netplan apply
# ou si on a un doute :
sudo netplan try
# qui va l'appliquer pendant 2 minutes et demander confirmation
</code>
  
S'il y a des erreurs dans la configuration, netplan va les signaler. Faites les modifications nécessaires puis réessayez d'appliquer la configuration.
Une fois la commande réalisée, NetworkManager va automatiquement se mettre à jour avec la nouvelle configuration, vous pouvez le vérifier en faisant ''ip a'' pour voir la configuration actuelle.

==== systemd-networkd ====
C'est le gestionnaire par défaut sur les serveurs (pas d'interface graphique)

Remplacez ''NetworkManager'' par ''networkd'' dans le paramètre ''renderer'' du fichier de configuration.

=== Appliquer la configuration netplan ===
<code bash>
  sudo networkctl reload
  sudo networkctl reconfigure eth0
  sudo networkctl renew eth0
</code>
  
En remplaçant ''eth0'' par votre interface, que vous pouvez obtenir via ''networkctl list''
  
===== Pour ne pas utiliser Netplan=====
Si vous ne souhaitez plus utiliser Netplan et souhaitez revenir à l'ancienne méthode de configuration, il suffit d'installer le paquet [[apt>ifupdown]]

===== Liens =====
  * **EN** [[https://netplan.readthedocs.io/en/stable/|doc officielle]]
  * **EN** [[https://netplan.readthedocs.io/en/stable/examples/|how to sur readthedocs]]
  * **FR** [[https://blog.stephane-robert.info/docs/admin-serveurs/linux/netplan/|Explications très claires de Stéphane Robert]]
  * **EN** [[https://wiki.ubuntu.com/Netplan/Design|Netplan sur le wiki Ubuntu]]

{{tag>reseau serveur}}

-----

//Contributeurs : [[:utilisateurs:bcag2]]//