[doc] document --limit limitations

there are currently known bugs in our interaction with the ansible
--limit option. document those and recommend not to use this like it
was agreed in the kolla meeting:
https://meetings.opendev.org/meetings/kolla/2024/kolla.2024-02-21-14.00.log.txt

Signed-off-by: Sven Kieske <kieske@osism.tech>
Change-Id: Iaeaa8c667ce7cd677b2b3dc2096ef4e52c1f651f
This commit is contained in:
Sven Kieske 2024-03-05 11:26:31 +01:00
parent add8351834
commit eb27c2b3ba
No known key found for this signature in database
1 changed files with 10 additions and 0 deletions

View File

@ -56,6 +56,16 @@ deployment.
Limitations and Recommendations
-------------------------------
.. warning::
Please notice that using the ansible ``--limit`` option is not recommended.
The reason is, that there are known bugs with it, e.g. when `upgrading parts of nova.
<https://bugs.launchpad.net/kolla-ansible/+bug/2054348>`__
We accept bug reports for this and try to fix issues when they are known.
The core problem is how the ``register:`` keyword works and how it
interacts with the ``--limit`` option. You can find more information in the above
bug report.
.. note::
Please note that when the ``use_preconfigured_databases`` flag is set to