openstack/charm-deployment-guide
Code Issues Proposed changes

Clarify octavia upgrades

Browse Source 
Add Octavia to the payload upgrade order table, with
considerations given to the update of the amphorae.

Driveby changes related to upgrades:

a) terms (Data Plane, Control Plane): to maintain consistency
   with the rest of the guide

b) charm upgrades: be explicit that subordinate charms are
   treated like any other

Closes-Bug: #1902756

Change-Id: I47cdf53b2e0a965732994225631c9c5624430582
This commit is contained in:
Peter Matulis
2021-01-14 10:53:53 -05:00
parent 6703e64be2
commit a9e47eee39
2 changed files with 30 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
deploy-guide/source/upgrade-charms.rst
View File

@@ -20,6 +20,10 @@ Although it may be possible to upgrade some charms in parallel it is
recommended that the upgrades be performed sequentially (i.e. one at a time). recommended that the upgrades be performed sequentially (i.e. one at a time).
Verify a charm upgrade before moving on to the next. Verify a charm upgrade before moving on to the next.
Subordinate charms are upgraded as normal, and, in theory, their upgrade order
in relation to their principal charm is not important. Internal testing however
does upgrade the principal charm first.
In terms of the upgrade order, begin with 'keystone'. After that, the rest of In terms of the upgrade order, begin with 'keystone'. After that, the rest of
the charms can be upgraded in any order. the charms can be upgraded in any order.

38
deploy-guide/source/upgrade-openstack.rst
View File

@@ -129,10 +129,11 @@ Upgrade order
The charms are put into groups to indicate the order in which their The charms are put into groups to indicate the order in which their
corresponding OpenStack services should be upgraded. The order within a group corresponding OpenStack services should be upgraded. The order within a group
is unimportant. What matters is that all the charms within the same group are is unimportant. What matters is that all the charms within the same group are
acted on before those in the next group (i.e. upgrade all charms in group 2 acted upon before those in the next group (e.g. upgrade all charm payloads in
before moving on to group 3). Any `Release Notes`_ guidance overrides the group 2 before moving on to group 3).
information listed here. You may also consult the upstream documentation on the
subject: `Update services`_. Any `Release Notes`_ guidance overrides the information listed here. You may
also consult the upstream documentation on the subject: `Update services`_.
Each service represented by a charm in the below table will need to be upgraded Each service represented by a charm in the below table will need to be upgraded
individually. individually.
@@ -140,19 +141,19 @@ individually.
+-------+-----------------------+---------------+ +-------+-----------------------+---------------+
| Group | Charm Name | Charm Type | | Group | Charm Name | Charm Type |
+=======+=======================+===============+ +=======+=======================+===============+
| 1 | keystone | Core Identity | | 1 | keystone | Control Plane |
+-------+-----------------------+---------------+ +-------+-----------------------+---------------+
| 1 | ceph-mon | Storage | | 1 | ceph-mon | Data Plane |
+-------+-----------------------+---------------+ +-------+-----------------------+---------------+
| 2 | ceph-osd | Storage | | 2 | ceph-osd | Data Plane |
+-------+-----------------------+---------------+ +-------+-----------------------+---------------+
| 2 | ceph-fs | Storage | | 2 | ceph-fs | Data Plane |
+-------+-----------------------+---------------+ +-------+-----------------------+---------------+
| 2 | ceph-radosgw | Storage | | 2 | ceph-radosgw | Data Plane |
+-------+-----------------------+---------------+ +-------+-----------------------+---------------+
| 2 | swift-proxy | Storage | | 2 | swift-proxy | Data Plane |
+-------+-----------------------+---------------+ +-------+-----------------------+---------------+
| 2 | swift-storage | Storage | | 2 | swift-storage | Data Plane |
+-------+-----------------------+---------------+ +-------+-----------------------+---------------+
| 3 | aodh | Control Plane | | 3 | aodh | Control Plane |
+-------+-----------------------+---------------+ +-------+-----------------------+---------------+
@@ -186,7 +187,9 @@ individually.
+-------+-----------------------+---------------+ +-------+-----------------------+---------------+
| 3 | openstack-dashboard | Control Plane | | 3 | openstack-dashboard | Control Plane |
+-------+-----------------------+---------------+ +-------+-----------------------+---------------+
| 4 | nova-compute | Compute | | 4 | nova-compute | Data Plane |
+-------+-----------------------+---------------+
| 5 | octavia | Control Plane |
+-------+-----------------------+---------------+ +-------+-----------------------+---------------+
.. important:: .. important::
@@ -197,6 +200,16 @@ individually.
associated unit. Common charms where this applies are ``ntp``, associated unit. Common charms where this applies are ``ntp``,
``memcached``, ``percona-cluster``, and ``rabbitmq-server``. ``memcached``, ``percona-cluster``, and ``rabbitmq-server``.
.. note::
An Octavia upgrade may entail an update of its load balancers (amphorae) as
a post-upgrade task. Reasons for doing this include:
* API incompatibility between the amphora agent and the new Octavia service
* the desire to use features available in the new amphora agent or haproxy
See the upstream documentation on `Rotating amphora images`_.
.. _perform_the_upgrade: .. _perform_the_upgrade:
Perform the upgrade Perform the upgrade
@@ -393,6 +406,7 @@ Check for errors in :command:`juju status` output and any monitoring service.
.. _Update services: https://docs.openstack.org/operations-guide/ops-upgrades.html#update-services .. _Update services: https://docs.openstack.org/operations-guide/ops-upgrades.html#update-services
.. _Keystone Fernet Token Implementation: https://specs.openstack.org/openstack/charm-specs/specs/rocky/implemented/keystone-fernet-tokens.html .. _Keystone Fernet Token Implementation: https://specs.openstack.org/openstack/charm-specs/specs/rocky/implemented/keystone-fernet-tokens.html
.. _Octavia LBaaS: app-octavia.html .. _Octavia LBaaS: app-octavia.html
.. _Rotating amphora images: https://docs.openstack.org/octavia/latest/admin/guides/operator-maintenance.html#rotating-the-amphora-images
.. BUGS .. BUGS
.. _LP #1825999: https://bugs.launchpad.net/charm-nova-compute/+bug/1825999 .. _LP #1825999: https://bugs.launchpad.net/charm-nova-compute/+bug/1825999