Improve documentation of networks

This commit is contained in:
Joshua Boniface 2021-01-03 16:50:18 -05:00
parent b8aba3a498
commit 74a28f2edd
1 changed files with 15 additions and 5 deletions

View File

@ -128,13 +128,19 @@ admin_users:
- "ssh-ed25519 MyKey 2019-06" - "ssh-ed25519 MyKey 2019-06"
networks: networks:
"upstream": "bondU":
device: "bondU" device: "bondU"
type: "bond" type: "bond"
bond_mode: "802.3ad" bond_mode: "802.3ad"
bond_devices: bond_devices:
- "enp1s0f0" - "enp1s0f0"
- "enp1s0f1" - "enp1s0f1"
mtu: 9000
"upstream":
device: "vlan1000"
type: "vlan"
raw_device: "bondU"
mtu: 1500 mtu: 1500
domain: "{{ local_domain }}" domain: "{{ local_domain }}"
subnet: "192.168.100.0/24" subnet: "192.168.100.0/24"
@ -154,7 +160,7 @@ networks:
device: "vlan1002" device: "vlan1002"
type: "vlan" type: "vlan"
raw_device: "bondU" raw_device: "bondU"
mtu: 1500 mtu: 9000
domain: "pvc-storage.local" domain: "pvc-storage.local"
subnet: "10.0.1.0/24" subnet: "10.0.1.0/24"
floating_ip: "10.0.1.254/24" floating_ip: "10.0.1.254/24"
@ -268,9 +274,13 @@ A list of SSH public key strings, in `authorized_keys` line format, for the user
* *required* * *required*
A dictionary of networks to configure on the nodes. Three networks are required by all PVC clusters, though additional networks may be configured here as well. A dictionary of networks to configure on the nodes.
The three required networks are: `upstream`, `cluster`, `storage`. The key will be used to "name" the interface file under `/etc/network/interfaces.d`, but otherwise the `device` is the real name of the device (e.g. `iface [device] inet ...`.
The three required networks are: `upstream`, `cluster`, `storage`. If `storage` is configured identically to `cluster`, the two networks will be collapsed into one; for details on this, please see the [documentation about the storage network](/cluster-architecture#storage--connecting-ceph-osd-with-each-other).
Additional networks can also be specified here to automate their configuration. In the above example, a "bondU" interface is configured, which the remaining required networks use as their `raw_device`.
Within each `network` element, the following options may be specified: Within each `network` element, the following options may be specified:
@ -278,7 +288,7 @@ Within each `network` element, the following options may be specified:
* *required* * *required*
The network device name. The real network device name.
##### `type` ##### `type`