From fd7cde9b9ed7e331a4a4932b903534591e42d562 Mon Sep 17 00:00:00 2001 From: Dmitry Tantsur Date: Tue, 15 Jun 2021 15:51:13 +0200 Subject: [PATCH] dhcp-less: mention how to provide network_data to instance Change-Id: I72eb4d7f0d26dd5deee9167c5e29cf6af1b683ae --- doc/source/admin/dhcp-less.rst | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/doc/source/admin/dhcp-less.rst b/doc/source/admin/dhcp-less.rst index 64093dfa7d..089829e254 100644 --- a/doc/source/admin/dhcp-less.rst +++ b/doc/source/admin/dhcp-less.rst @@ -81,10 +81,29 @@ An example network data: Some fields are redundant with the port information. We're looking into simplifying the format, but currently all these fields are mandatory. +You'll need the deployed image to support network data, e.g. by pre-installing +cloud-init_ or Glean_ on it (most cloud images have the former). Then you can +provide the network data when deploying, for example: + +.. code-block:: bash + + baremetal node deploy \ + --config-drive "{\"network_data\": $(cat ~/network_data.json)}" + +Some first-boot services, such as Ignition_, don't support network data. You +can provide their configuration as part of user data instead: + +.. code-block:: bash + + baremetal node deploy \ + --config-drive "{\"user_data\": \"... ignition config ...\"}" + .. _configdrive: https://docs.openstack.org/nova/queens/user/config-drive.html .. _Glean: https://docs.openstack.org/infra/glean/ .. _simple-init: https://docs.openstack.org/diskimage-builder/latest/elements/simple-init/README.html .. _network_data: https://specs.openstack.org/openstack/nova-specs/specs/liberty/implemented/metadata-service-network-info.html +.. _cloud-init: https://cloudinit.readthedocs.io/en/latest/ +.. _Ignition: https://coreos.github.io/ignition/ .. _l3-external-ip: