openstack/ironic
Code Issues Proposed changes

Modify port group document for ironic

Browse Source 
Add a simple sample about configuring bonding via configdrive,
and it can make user to use port group more easily.

Story: 2008474
Task: 41514

Signed-off-by: huth <428437106@qq.com>
Change-Id: Ic425ecb35bfa173adf72b0ee104d28c6b79cb4b1
This commit is contained in:
huth 2020-12-30 15:26:14 +08:00
parent 6c9e28dd50
commit 182a6fcff5
1 changed files with 30 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
doc/source/admin/portgroups.rst
View File

@ -72,6 +72,36 @@ CLI commands below specify it for completeness.
cloud-init version 0.7.7 or later is required for bonding configuration
to work.
The following is a simple sample for configuring bonding via configdrive:
When booting an instance, it needs to add user-data file for configuring
bonding via ``--user-data`` option. For example:
.. code-block:: json
{
"networks": [
{
"type": "physical",
"name": "eth0",
"mac_address": "fa:ab:25:48:fd:ba"
},
{
"type": "physical",
"name": "eth1",
"mac_address": "fa:ab:25:48:fd:ab"
},
{
"type": "bond",
"name": "bond0",
"bond_interfaces": [
"eth0", "eth1"
],
"mode": "active-backup"
}
]
}
If the port group's address is not explicitly set in standalone mode, it
will be set automatically by the process described in
`kernel documentation on bonding`_.