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:

1
2
3
4

# 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 systemd-networkd, dies ist auch der Standard, wenn kein renderer 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
14
15
16

network:
  version: 2
  renderer: networkd
  ethernets:
    enp1s0:
      addresses:
        - 10.10.10.2/24
        - 2001:DB8::5/64
      dhcp4: no
      routes:
        - to: 0.0.0.0/0 #Standardroute für IPv4
          via: 10.10.10.1
        - to: ::/0 #Standardroute für IPv6
          via: 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, legt die so erzeugten Konfigurationen im Verzeichnis /run an und überlässt Kontrolle und Verarbeitung anschließend dem jeweils spezifischen Netzwerk-Konfigurator.

Darüber hinaus kann man Netplan noch mittels der folgenden Befehle an sein Dienstprogramm netplanim 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 angegebenen Netzwerk-Dienste, legt diese unterhalb 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 interaktiv annehmen oder ablehnen. Wird -timeout nicht angegeben so beträgt das Zeitintervall standardmäßig 120 Sekunden.

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

Verhältnis von Netplan-Konfigurationen in /run zu Konfigurationen der Backends in /etc¶

Die von Netplan beim Systemstart im Verzeichnis /run angelegten Konfigurationen für die jeweils spezifischen Netzwerk-Dienste, werden durch etwaig konkurrierende Konfigurationen in den jeweiligen Verzeichnissen unterhalb von /etc verdrängt.

intern¶

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

• systemd-networkd - Standard-Netzwerkkonfigurator 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