openstack
/
charm-guide
Code Issues Proposed changes

Add deprecation notice for OOL 

Add deprecation notice for OpenStack on LXD.

Cleanup: remove unneeded entries and links.

Change-Id: I560b9e7253389b93a0a7ed3f5f034273c5f0f0c3
This commit is contained in:
Peter Matulis 2020-12-04 13:06:10 -05:00
parent 2956013ff0
commit 8c731308b8
1 changed files with 9 additions and 29 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

38
doc/source/2101.rst
View File

@ -45,6 +45,13 @@ n/a
Deprecation notices
-------------------
OpenStack on LXD documentation
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
The OpenStack on LXD documentation was moved from the OpenStack Charm Guide to
the `openstack-on-lxd`_ repository. Users wishing to use an all-in-one
OpenStack solution should explore the `MicroStack`_ project.
Removed features
----------------
@ -114,30 +121,6 @@ Mounting snapshots using the File Recovery Manager appliance fails due to
permissions errors encountered during the libvirt/qemu snapshot mount process
on compute nodes. See bug `LP #1888389`_ for details.
Octavia and neutron-openvswitch in LXD
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.. note::
This issue is due to a Juju bug, which was fixed in Juju 2.8.1.
The octavia charm requires a neutron-openvswitch subordinate which means that
if it runs in a container, the openvswitch kernel module must be loaded before
the container starts. Module loading is done by LXD based on the profile
applied by Juju and taken from the neutron-openvswitch charm. However, due to
bug `LP #1876849`_ in Juju, there is no guarantee that the profile will be
applied before neutron-openvswitch execution starts in a container.
The issue is more likely to happen on disaggregated deployments where octavia
units run in LXD containers on machines that do not have any units of
neutron-openvswitch running on bare metal.
In order to work around the error an operator needs to make sure the
``openswitch`` module is loaded on the host and then restart the
``openvswitch-switch.service`` service inside the LXD container where the
respective neutron-openvswitch unit is present. After that the unit error can
be resolved.
OpenStack os-brick, Ceph Octopus, and Focal
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@ -219,17 +202,14 @@ Deployment Guide`_ for more details.
.. _Release schedule: release-schedule.html
.. _OpenStack upgrades: https://docs.openstack.org/project-deploy-guide/charm-deployment-guide/latest/app-upgrade-openstack.html
.. _Vault section: https://docs.openstack.org/project-deploy-guide/charm-deployment-guide/latest/app-vault.html
.. _Open vSwitch Integration Guide for Centralized Control: https://docs.openvswitch.org/en/latest/topics/integration/
.. _Certificate Lifecycle Management: https://docs.openstack.org/project-deploy-guide/charm-deployment-guide/latest/app-certificate-management.html
.. _Migration from Neutron ML2+OVS to ML2+OVN section of the OVN: https://docs.openstack.org/project-deploy-guide/charm-deployment-guide/latest/app-ovn.html#migration-from-neutron-ml2-ovs-to-ml2-ovn
.. _Octavia deprecation notes for Victoria: https://docs.openstack.org/releasenotes/octavia/victoria.html#deprecation-notes
.. _MicroStack: https://microstack.run
.. _openstack-on-lxd: https://github.com/openstack-charmers/openstack-on-lxd
.. COMMITS
.. BUGS
.. _LP #1809190: https://bugs.launchpad.net/charm-neutron-gateway/+bug/1809190
.. _LP #1839019: https://bugs.launchpad.net/charm-designate/+bug/1839019
.. _LP #1876849: https://bugs.launchpad.net/charm-neutron-openvswitch/+bug/1876849
.. _LP #1877594: https://bugs.launchpad.net/charm-neutron-gateway/+bug/1877594
.. _LP #1876730: https://bugs.launchpad.net/netplan/+bug/1876730
.. _LP #1890628: https://bugs.launchpad.net/charm-neutron-api-plugin-arista/+bug/1890628