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 cloud-init version 0.7.7 or later is required for bonding configuration
to work. 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 If the port group's address is not explicitly set in standalone mode, it
will be set automatically by the process described in will be set automatically by the process described in
`kernel documentation on bonding`_. `kernel documentation on bonding`_.