Ansible role to manage systemd networkd
Go to file
Dmitriy Rabotyagov aafc7ba708 Use OriginalName instead of Name in systemd.link
Name option is not a valid one for systemd.link [1] while it is for systemd.network [2]
though having same meaning.

This basically resulted in link files being just ignored by udevadm
and were not loaded properly after reboot

[1] https://www.freedesktop.org/software/systemd/man/latest/systemd.link.html#OriginalName=
[2] https://www.freedesktop.org/software/systemd/man/latest/systemd.network.html#Name=

Closes-Bug: #1896589
Change-Id: If82946b7f5ad3c618606110576c586632f9bbd08
(cherry picked from commit b9c7d79089)
2024-02-13 14:57:18 +00:00
defaults Ensure filename is always defined for network/netdev 2023-12-15 14:06:10 +00:00
doc Switch sphinx language to en 2022-05-30 16:01:11 +02:00
examples Add integrated linters test 2022-01-25 11:29:12 +00:00
files/gpg Add centos-9 support 2022-01-11 14:14:55 +00:00
handlers Fix linters and metadata 2023-07-12 12:33:19 +02:00
html-docs first commit 2018-03-13 23:09:48 -05:00
meta Fix linters and metadata 2023-07-12 12:33:19 +02:00
releasenotes Fix defenition of multiple static routes for network 2023-12-15 15:07:16 +01:00
tasks Fix defenition of multiple static routes for network 2023-12-15 15:07:16 +01:00
templates Use OriginalName instead of Name in systemd.link 2024-02-13 14:57:18 +00:00
tests Use ansible_facts[] instead of fact variables 2021-02-24 14:26:31 +00:00
vars Ensure filename is always defined for network/netdev 2023-12-15 14:06:10 +00:00
zuul.d Add integrated linters test 2022-01-25 11:29:12 +00:00
.gitignore Updated from OpenStack Ansible Tests 2019-08-20 03:07:47 +00:00
.gitreview Update .gitreview for stable/2023.2 2023-12-07 11:05:01 +00:00
CONTRIBUTING.rst [ussuri][goal] Update contributor documentation 2020-05-13 00:08:50 +03:00
LICENSE first commit 2018-03-13 23:09:48 -05:00
README.md Update documentation on role requirements 2022-05-13 10:42:11 +02:00
Vagrantfile Updated from OpenStack Ansible Tests 2021-12-17 16:50:36 +00:00
bindep.txt Updated from OpenStack Ansible Tests 2021-03-12 22:23:47 +00:00
manual-test.rc Update documentation on role requirements 2022-05-13 10:42:11 +02:00
requirements.yml Update documentation on role requirements 2022-05-13 10:42:11 +02:00
run_tests.sh Updated from OpenStack Ansible Tests 2022-04-04 09:22:59 +00:00
tox.ini Update TOX_CONSTRAINTS_FILE for stable/2023.2 2023-12-07 11:05:05 +00:00

README.md

Ansible systemd_networkd

This Ansible role configures systemd-networkd link, network, and netdev files.

This role requires the ansible-config_template collection to be available on your local system.

To get collection you can use use the ansible-galaxy command on the requirements.yml file.. You need to install collection before running this role.

# ansible-galaxy install -r requirements.yml

Release notes for the project can be found at: https://docs.openstack.org/releasenotes/ansible-role-systemd_networkd


Example playbook

See the "defaults.yml" file for a full list of all available options.

- name: Create a systemd-networkd interfaces
  hosts: localhost
  become: true
  roles:
    - role: "systemd_networkd"
      systemd_netdevs:
        - NetDev:
            Name: dummy0
            Kind: dummy
        - NetDev:
            Name: dummy1
            Kind: dummy
        - NetDev:
            Name: bond0
            Kind: bond
          Bond:
            Mode: 802.3ad
            TransmitHashPolicy: layer3+4
            MIIMonitorSec: 1s
            LACPTransmitRate: fast
        - NetDev:
            Name: br-dummy
            Kind: bridge
      systemd_networks:
        - interface: "dummy0"
          bond: "bond0"
          mtu: 9000
        - interface: "dummy1"
          bond: "bond0"
          mtu: 9000
        - interface: "bond0"
          bridge: "br-dummy"
          mtu: 9000
        - interface: "br-dummy"
          address: "10.0.0.100"
          netmask: "255.255.255.0"
          gateway: "10.0.0.1"
          mtu: 9000
          usedns: true
          static_routes:
            - gateway: "10.1.0.1"
              cidr: "10.1.0.0/24"
          config_overrides:
            Network:
              ConfigureWithoutCarrier: true