summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJames Falcon <therealfalcon@gmail.com>2021-07-19 15:35:44 -0500
committerGitHub <noreply@github.com>2021-07-19 15:35:44 -0500
commit4fbe192ab21252b5cb664ee0e7ae3ee22af98a10 (patch)
tree148161f50d6ac0f076304e7ed6c8540193466295
parent184c836a16e9954a2cba11ae21f07923077ec904 (diff)
downloadvyos-cloud-init-4fbe192ab21252b5cb664ee0e7ae3ee22af98a10.tar.gz
vyos-cloud-init-4fbe192ab21252b5cb664ee0e7ae3ee22af98a10.zip
Document known hotplug limitations (#950)
-rw-r--r--doc/rtd/topics/events.rst8
1 files changed, 7 insertions, 1 deletions
diff --git a/doc/rtd/topics/events.rst b/doc/rtd/topics/events.rst
index 984e7577..57797bd9 100644
--- a/doc/rtd/topics/events.rst
+++ b/doc/rtd/topics/events.rst
@@ -71,6 +71,11 @@ user data, cloud-init will respond to the addition or removal of network
interfaces to the system. In addition to fetching and updating the system
metadata, cloud-init will also bring up/down the newly added interface.
+.. warning:: Due to its use of systemd sockets, hotplug functionality
+ is currently incompatible with SELinux. This issue is being tracked
+ `on Launchpad`_. Additionally, hotplug support is considered experimental for
+ non-Debian based systems.
+
Examples
========
@@ -83,7 +88,8 @@ On every boot, apply network configuration found in the datasource.
# apply network config on every boot
updates:
network:
- when: ['boot', 'hotplug']
+ when: ['boot']
.. _Cloud-init: https://launchpad.net/cloud-init
+.. _on Launchpad: https://bugs.launchpad.net/cloud-init/+bug/1936229
.. vi: textwidth=78