Konfiguration¶

Die Konfiguration von Netplan erfolgt über Dateien mit der Endung .yaml in den Verzeichnissen:

• /lib/netplan/ (Dateien der Distribution)

• /etc/netplan (für eigene Konfigurationsdateien)

• /run/netplan (wird zur Laufzeit des Systems anlegt),

Dateien in später genannten Verzeichnissen maskieren gleichnamige Dateien in früher genannten Verzeichnissen und die Dateien werden in lexikographischer Reihenfolge bearbeitet.

Bei einer Desktop-Installation besteht die Konfiguration für Netplan standardmäßig nur aus der Konfigurationsdatei /etc/netplan/01-network-manager-all.yaml mit folgendem Inhalt:

# Let NetworkManager manage all devices on this system
network:
  version: 2
  renderer: NetworkManager

network ist der oberste Knoten, also alle physischen Netzwerkschnittstellen. version: 2 gibt die YAML-Version an, wobei version: 2 bedeutet, dass YAML 1.1 benutzt wird, was der Standard für Netplan ist. renderer: NetworkManager besagt, dass die Kontrolle über die Netzwerkschnittstellen an den NetworkManager abgegeben wird. Die andere Alternative ist networkd für sysemd-networkd. Dies wäre auch der Standardrenderer, wenn keiner angegeben wird.

Möchte man eigene Konfigurationsdateien schreiben, so legt man sie im Verzeichnis /etc/netplan/ ab. Der Name der Datei darf beliebig sein, muss aber die Endung .yaml haben. Die Dateien werden in lexikographischer Reihenfolge gelesen. Hat man z.B. zwei Dateien 01-foo.yaml und 02-bar.yaml, würde zuerst 01-foo.yaml gelesen, dann 02-bar.yaml. Sind in den Dateien widersprüchliche / überlappenden Konfigurationen enthalten, wird immer die Konfiguration der später gelesenen Datei genutzt.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13

network:
  version: 2
  renderer: networkd
  ethernets:
    enp1s0:
      addresses:
        - 10.10.10.2/24
        - 2001:DB8::5/64
      dhcp4: no
      gateway4: 10.10.10.1
      gateway6: 2001:DB8::1
      nameservers:
          addresses: [10.10.10.1,1.1.1.1,2001:470:20::2]

Ausführung¶

Die Übersetzung der Konfigurationen erledigt Netplan früh während des System-Starts, mittels systemd.generator-Programs und legt die so erzeugten Konfigurationen im Verzeichnis /run an und überlässt Kontrolle und Verarbeitung anschließend dem jeweils spezifischen Netzwerk-Dienst.

Darüber hinaus kann man Netplan noch mittels der drei folgenden Befehle im laufenden System ausführen:

sudo netplan generate 

Generiert aus den vorhandenen YAML-Dateien die Konfigurations-Dateien für die angegebenen Netzwerk-Dienste, legt diese unterhalb des Verzeichnisses /run/... ab, veranlasst aber noch nicht die Anwendung der Konfigurationen durch die Netzwerk-Dienste. Damit lässt sich also zunächst testen, ob aus der YAML-Datei eine valide Backend-Konfiguration hervorgeht.

sudo netplan apply 

Generiert aus den vorhandenen YAML-Dateien die Konfigurations-Dateien für die angegenben Netzwerk-Dienste, legt diese unterhalbe des Verzeichnisses /run/... ab und veranlasst die Netzwerkdienste diese Konfigurationen sofort anzuwenden.

sudo netplan try -timeout 180 

Veranlasst ebenso wie netplan apply die unmittelbare Anwendung der Konfiguration, setzt sie aber nach Ablauf der hinter -timeout angegebenen Sekunden wieder automatisch auf die vorherige Konfiguration zurück. Der Nutzer kann die Konfiguration innerhalb dieser Zeitspanne interaktive annehmen oder ablehnen. Wird -timeout nicht angegeben so beträgt das Zeitintervall standardmäßig 120 Sekunden.

Die Nutzung von netplan try ist damit insbesondere sinnvoll, wenn man neue Netzwerkkonfigurationen auf einem System per Fernwartung einrichten will.

Fügt man allen drei Befehlen noch die Option -debug hinzu, so erhält man ausführlichere Informationen über den Ablauf des Prozesses.

intern¶

• NetworkManager - Standard-Netzwerkdienst auf Ubuntu-Desktop-Systemen

• systemd-networkd - Standard-Netzwerkdienst auf Ubuntu-Server-Systemen, ist aber auch auf Desktop-Systemen vorinstalliert

• /etc/network/interfaces - Wurde bis einschließlich Ubuntu 17.04 standardmäßig auf Desktop- und auf Server-Systemen zur textbasierten Nextwerk-Konfiguration genutzt

extern¶

• Projektseite 🇬🇧 inklusive Dokumentation

• Manpage 🇬🇧 für Ubuntu für Netplan

• Launchpad-Seite zu Netplan