Ansible role to manage systemd networkd
Go to file
Mohammed Naser 3bb3d5aa69 docs: drop sphinxmark
sphinxmark is no longer compatible with the latest release of Sphinx
which is causing all of our documentation jobs to fail.  This patch
removes it as our current usage of openstacktheme for documentation
already provides watermarks for current branch and notices for which
branch the documentation covers.

Change-Id: Ia615053452e5f6693348e8dc2036112298d5c0db
2019-04-04 05:12:56 +00:00
defaults Add ipforward option to configure IPForward 2019-02-11 09:55:26 -05:00
doc docs: drop sphinxmark 2019-04-04 05:12:56 +00:00
examples update example playbook to mirror a prod network 2018-03-16 02:11:38 -05:00
handlers Add async to the networkd start task 2018-08-18 17:36:50 -05:00
html-docs first commit 2018-03-13 23:09:48 -05:00
meta Add Bionic testing 2018-05-14 20:44:38 +02:00
releasenotes Update reno for stable/rocky 2018-08-10 16:44:17 +00:00
tasks Add ipforward option to configure IPForward 2019-02-11 09:55:26 -05:00
templates Add ipforward option to configure IPForward 2019-02-11 09:55:26 -05:00
tests Add ipforward option to configure IPForward 2019-02-11 09:55:26 -05:00
vars Make the networkd role distro agnostic 2018-05-14 15:28:08 -05:00
zuul.d switch documentation job to new PTI 2018-08-21 13:21:43 +00:00
.gitignore Updated from OpenStack Ansible Tests 2018-10-02 14:57:07 +00:00
.gitreview Fix gitreview repo name 2018-03-19 14:43:54 -05:00
CONTRIBUTING.rst Replace Chinese punctuation with English punctuation 2018-10-29 20:07:39 +08:00
LICENSE first commit 2018-03-13 23:09:48 -05:00
README.md Add release note link in README 2018-06-29 14:51:46 +08:00
Vagrantfile Updated from OpenStack Ansible Tests 2018-09-28 06:24:05 +00:00
ansible-role-requirements.yaml first commit 2018-03-13 23:09:48 -05:00
bindep.txt Updated from OpenStack Ansible Tests 2019-03-22 22:10:00 +00:00
manual-test.rc first commit 2018-03-13 23:09:48 -05:00
run_tests.sh Updated from OpenStack Ansible Tests 2019-02-27 06:08:45 +00:00
setup.cfg Update home-page 2019-01-12 09:43:17 +00:00
setup.py first commit 2018-03-13 23:09:48 -05:00
tox.ini fix tox python3 overrides 2018-11-05 06:45:11 +00:00

README.md

Ansible systemd_networkd

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

This role requires the openstack-ansible-plugins repository to be available on your local system. The Ansible galaxy resolver will not retrieve this role for you. To get the plugins role in place clone the plugins repository before running this role.

# git clone https://github.com/openstack/openstack-ansible-plugins /etc/ansible/roles/plugins

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

You can also use the ansible-galaxy command on the ansible-role-requirements.yml file.

# ansible-galaxy install -r ansible-role-requirements.yml

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