.. _ug_task_netplan_ex1:

Example 1: Configure ethernet interface by Netplan
""""""""""""""""""""""""""""""""""""""""""""""""""

Create a playbook

.. code-block:: YAML
   :emphasize-lines: 1

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

Create *host_vars/test_01/lp-netplan.yml*

.. code-block:: YAML
   :emphasize-lines: 1,3

   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 NetworkManager.
   * See :ref:`ug_task_networkmanager_ex1`

Configure `network`

.. code-block:: Bash
   :emphasize-lines: 1

   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`

.. code-block:: Bash
   :emphasize-lines: 1

   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

.. code-block:: Bash
   :emphasize-lines: 1,6,12

   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

.. code-block:: Bash
   :emphasize-lines: 1,17,25

   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.