From b7000b96232265754d37418dac90bc88b9d95c72 Mon Sep 17 00:00:00 2001 From: Kaifeng Wang Date: Sat, 18 Apr 2020 16:57:54 +0800 Subject: [PATCH] [Trivial] Doc update on the stable-interface-names Consistent interface naming is helpful in collecting introspection data and final instance system. Change-Id: I8d434f7f8412734a540b797255abb6391325f434 --- doc/source/admin/dib.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/doc/source/admin/dib.rst b/doc/source/admin/dib.rst index b77e881..b405f4b 100644 --- a/doc/source/admin/dib.rst +++ b/doc/source/admin/dib.rst @@ -139,6 +139,19 @@ The *devuser* element allows creating a user at build time, for example: export DIB_DEV_USER_AUTHORIZED_KEYS=$HOME/.ssh/id_rsa.pub disk-image-create debian ironic-python-agent-ramdisk devuser +Consistent Network Interface Naming +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Base cloud images normally disable consistent network interface naming +by inserting an empty udev rule. Include ``stable-interface-names`` element +if you want to have consistent network interface naming whenever it is +required for instance image or deploy image. + +.. code-block:: bash + + ironic-python-agent-builder -e stable-interface-names --release 8 centos-minimal + + .. _diskimage-builder: https://docs.openstack.org/diskimage-builder .. _dynamic-login: https://docs.openstack.org/diskimage-builder/latest/elements/dynamic-login/README.html .. _devuser: https://docs.openstack.org/diskimage-builder/latest/elements/devuser/README.html