ansible-role-systemd_networkd/README.md
XiaojueGuan 85ddeb0862 Add release note link in README
Change-Id: Ia3c5ab2e333caf5edf46560a4020f8415c558172
2018-06-29 14:51:46 +08:00

75 lines
2.0 KiB
Markdown

#### 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.
``` bash
# 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.
``` bash
# ansible-galaxy install -r ansible-role-requirements.yml
```
----
###### Example playbook
> See the "defaults.yml" file for a full list of all available options.
``` yaml
- 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
```