From c7b0ffd266c4d567ecee8c5b596f252e3e3c531e Mon Sep 17 00:00:00 2001
From: Piotr Parczewski <piotr@stackhpc.com>
Date: Mon, 10 Jul 2023 22:35:35 +0200
Subject: [PATCH] docs: Add a warning on creating network loops
Change-Id: Ie29137fe1ab4d50366b8a000d891db3d256d09f2
---
doc/source/configuration/reference/network.rst | 9 +++++++++
1 file changed, 9 insertions(+)
diff --git a/doc/source/configuration/reference/network.rst b/doc/source/configuration/reference/network.rst
index 1cab3b104..7a73deafb 100644
--- a/doc/source/configuration/reference/network.rst
+++ b/doc/source/configuration/reference/network.rst
@@ -614,6 +614,15 @@ Workload inspection network (``inspection_net_name``)
These roles are configured in ``${KAYOBE_CONFIG_PATH}/networks.yml``.
+.. warning::
+
+ Changing ``external_net_names`` after initial deployment has a potential
+ for creating network loops. Kayobe / Ansible will not clean up
+ any items removed from this variable in the OVS. Any additional interfaces
+ that map to network names from the list will be added to the bridge. Any
+ previous entries that should be removed, must be deleted in OVS manually
+ prior to applying changes via Kayobe in order to avoid creating a loop.
+
Configuring Network Roles
-------------------------