Skip to content

Commit 430c91b

Browse files
authored
Networks 'route' and 'nat' mode documentation
1 parent 8925d94 commit 430c91b

File tree

1 file changed

+14
-2
lines changed

1 file changed

+14
-2
lines changed

README.md

Lines changed: 14 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,9 +26,13 @@ should be a dict containing the following items:
2626
`libvirt_host_networks` is a list of networks to define and start. Each item
2727
should be a dict containing the following items:
2828
- `name` The name of the network.
29-
- `mode` The forwarding mode of the network, currently only `bridge` is
30-
supported.
29+
- `mode` The forwarding mode of the network, 'bridge', 'route' and 'nat' are supported.
3130
- `bridge` The name of the bridge interface for this network.
31+
- `ip` IP address of the virtual bridge, mandatory for 'route' and 'nat' mode.
32+
- `netmask` Netmask of the virtual bridge, mandatory for 'route' and 'nat' mode.
33+
- `domain` DNS domaine name for 'route' and 'nat' mode, default to the network name (optional).
34+
- `dhcp_start`First IP of the DHCP range in 'route' or 'nat' mode (optional).
35+
- `dhcp_end` Last IP of the DHCP range in 'route' or 'nat' mode (optional).
3236

3337
`libvirt_host_require_vt`is whether to require that Intel Virtualisation
3438
Technology (VT) is enabled in order to run this role. While this provides
@@ -91,6 +95,14 @@ Example Playbook
9195
- name: br-example
9296
mode: bridge
9397
bridge: br-example
98+
- name: brnat-example
99+
mode: nat
100+
bridge: brnat-example
101+
domain: example.local
102+
ip: 192.168.133.254
103+
netmask: 255.255.255.0
104+
dhcp_start: 192.168.133.100
105+
dhcp_end: 192.168.133.200
94106

95107
Author Information
96108
------------------

0 commit comments

Comments
 (0)