diff options
| author | Brett Holman <brett.holman@canonical.com> | 2023-04-25 12:09:45 -0600 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2023-04-25 12:09:45 -0600 |
| commit | c1b4722036a1ad3f683b7942db4d07639f88dcd2 (patch) | |
| tree | 19ddbd7952b3d501c7fd203ec6125f84f3ff00b6 /doc/rtd/reference/datasources/openstack.rst | |
| parent | 1132b2ce31fb0f5f3196fb14776e8a64fe2d5695 (diff) | |
| download | cloud-init-git-c1b4722036a1ad3f683b7942db4d07639f88dcd2.tar.gz | |
Update kernel command line docs (SC-1457) (#2133)
- describe kernel command line override
- add OpenStack Ironic selection instructions
- describe datasource selection
- move datasource creation doc to dev section
- remove generator stage from boot stages
- document how to disable cloud-init in howtos
- fix missing kernel-cmdline.rst link
- update outdated security advice
Document the following commits:
34e8c914df666c937e48f5d1c3add0bd47e4e7eb
f146fe71733e72b94fad525b8cc9988b1405e760
250280ada67995a8449b64027b879d01939d2729
612b4de892d19333c33276d541fed99fd16d3998
a60c0845806baff72c74603286d048efbafab664
d1ffbea556a06105d1ade88b4143ad43f53692c4
02202954c65a7a1cdb9b28703bd0af01edd0e091
Diffstat (limited to 'doc/rtd/reference/datasources/openstack.rst')
| -rw-r--r-- | doc/rtd/reference/datasources/openstack.rst | 34 |
1 files changed, 34 insertions, 0 deletions
diff --git a/doc/rtd/reference/datasources/openstack.rst b/doc/rtd/reference/datasources/openstack.rst index f8fd2eb4..7bb52e4a 100644 --- a/doc/rtd/reference/datasources/openstack.rst +++ b/doc/rtd/reference/datasources/openstack.rst @@ -125,4 +125,38 @@ path; if found, settings are applied after (and, hence, overriding) the settings from static vendor data. Both sets of vendor data can be overridden by user data. +.. _datasource_ironic: + +OpenStack Ironic Bare Metal +=========================== + +During boot, cloud-init typically has to identify which platform it is running +on. Since OpenStack Ironic Bare Metal doesn't provide a method for cloud-init +to discover that it is running on Ironic, extra user configuration is required. + +Cloud-init provides two methods to do this: + +Method 1: Configuration file +---------------------------- + +Explicitly set ``datasource_list`` to only ``openstack``, such as: + +.. code-block:: yaml + + datasource_list: ["openstack"] + +Method 2: Kernel command line +----------------------------- + +Set the kernel commandline to configure +:ref:`datasource override <kernel_datasource_override>`. + +Example using Ubuntu + GRUB2: + +.. code-block:: + + $ echo 'ds=openstack' >> /etc/default/grub + $ grub-mkconfig -o /boot/efi/EFI/ubuntu/grub.cfg + + .. _OpenStack Metadata Service: https://docs.openstack.org/nova/latest/admin/metadata-service.html |