Example 1: Configure ethernet interface by Netplan

Create a playbook

shell> cat lp.yml
- hosts: test_01
  become: true
  roles:
    - vbotka.linux_postinstall

Create host_vars/test_01/lp-netplan.yml

shell> cat host_vars/test_01/lp-netplan.yml
lp_netplan: true
lp_netplan_renderer: networkd
lp_netplan_conf:
  - file: 10-ethernet.yaml
    category: ethernets
    conf:
      eth0:
        optional: true
        set-name: eth0
        dhcp4: true
        dhcp6: false
        match:
        macaddress: "<sanitized>"

Note

• When networkd renderer is used disable Neworkmanager.

• See Example 1: Disable NetworkManager

Configure network

shell> ansible-playbook lp.yml -t lp_netplan

TASK [vbotka.linux_postinstall : netplan: Configure files in /etc/netplan] **
ok: [test_01] => (item=10-ethernet.yaml)

The command is idempotent

shell> ansible-playbook lp.yml -t lp_netplan
...
PLAY RECAP ******************************************************************
test_01: ok=6 changed=0 unreachable=0 failed=0 skipped=4 rescued=0 ignored=0

Show the configuration of netplan at the remote host

test_01> tree /etc/netplan/
/etc/netplan/
├── 01-network-manager-all.yaml
└── 10-ethernet.yaml

test_01> cat /etc/netplan/01-network-manager-all.yaml
# Ansible managed
network:
  version: 2
  renderer: networkd

test_01> cat /etc/netplan/10-ethernet.yaml
# Ansible managed
network:
  version: 2
  renderer: networkd
  ethernets:
    eth0:
      dhcp4: true
      dhcp6: false
      match: {macaddress: '<sanitized>'}
      optional: true
      set-name: eth0

Show the configuration of networkd at the remote host

test_01> cat /run/systemd/network/10-netplan-eth0.network
[Match]
MACAddress=<sanitized>
Name=eth0

[Link]
RequiredForOnline=no

[Network]
DHCP=ipv4
LinkLocalAddressing=ipv6

[DHCP]
RouteMetric=100
UseMTU=true

test_01> cat /run/systemd/network/10-netplan-eth0.link
[Match]
MACAddress=<sanitized>

[Link]
Name=eth0
WakeOnLan=off

test_01> networkctl
IDX LINK             TYPE               OPERATIONAL SETUP
  1 lo               loopback           carrier     unmanaged
  2 eth0             ether              routable    configured
  3 wlan0            wlan               off         unmanaged

3 links listed.