Update the upgrades appx to reflect stepped upgrades

Also remove deprecated charms from the reference.

Change-Id: I8fec096bf35588f8a0c8ec655f498d8b0e5dea28
This commit is contained in:
Ryan Beisner 2018-11-27 11:11:20 -06:00
parent fa0dca6dc6
commit e405ba4ce9
No known key found for this signature in database
GPG Key ID: 952BACDC1C1A05FB
1 changed files with 19 additions and 15 deletions

View File

@ -19,7 +19,7 @@ part of the OpenStack project such as Rabbitmq and MySQL.
OpenStack Upgrade OpenStack Upgrade
~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~
This is an upgrade of the Openstack software (packages) that are installed This is an upgrade of the OpenStack software (packages) that are installed
and managed by the charms. and managed by the charms.
Ubuntu Server Package Upgrade Ubuntu Server Package Upgrade
@ -40,21 +40,29 @@ Testing
All procedures outlined below should be tested in a non-production environment All procedures outlined below should be tested in a non-production environment
first. first.
Skipping Releases Skipping Releases or Fast Forward Upgrade
----------------- -----------------------------------------
The charms support triggering a multi-release upgrade and will handle stepping The charms support stepped OpenStack version upgrades (N+1). For example:
through the upgrade. However, given that some OpenStack projects (including Ocata to Pike, then Pike to Queens, Queens to Rocky and so on.
Nova) only support there being a single release difference between components
this is not recommended. This stepped N+1 approach in charms is mature, well-tested, and can be used
back-to-back to achieve N+N upgrade results.
Skipping releases is not supported by many upstream OpenStack projects, and
it is not supported by the charms.
"Fast-forward-upgrade" is also not supported by the charms. FFU/FFWD is an
upgrade approach where the control plane services are stepped through N+1+1+1
upgrades, typically to achieve an N+3 upgrade result.
1. Charm Upgrades 1. Charm Upgrades
----------------- -----------------
All charms should be upgraded to the latest stable release before performing All charms should be upgraded to the latest stable charm revision before
an OpenStack upgrade. It is recommended to upgrade the Keystone charm first. performing an OpenStack upgrade. It is recommended to upgrade the Keystone
The order of upgrading subsequent charms is usually not important but charm first. The order of upgrading subsequent charms is usually not important
check the release notes for each release to ensure there are no but check the release notes for each release to ensure there are no
special requirements. special requirements.
To upgrade a charm that was deployed from the charm store: To upgrade a charm that was deployed from the charm store:
@ -129,8 +137,6 @@ listed here.
+=======+=======================+===============+ +=======+=======================+===============+
| 1 | keystone | Core Identity | | 1 | keystone | Core Identity |
+-------+-----------------------+---------------+ +-------+-----------------------+---------------+
| 2 | ceph | Storage |
+-------+-----------------------+---------------+
| 2 | ceph-mon | Storage | | 2 | ceph-mon | Storage |
+-------+-----------------------+---------------+ +-------+-----------------------+---------------+
| 2 | ceph-osd | Storage | | 2 | ceph-osd | Storage |
@ -171,8 +177,6 @@ listed here.
+-------+-----------------------+---------------+ +-------+-----------------------+---------------+
| 3 | nova-cloud-controller | Control Plane | | 3 | nova-cloud-controller | Control Plane |
+-------+-----------------------+---------------+ +-------+-----------------------+---------------+
| 3 | odl-controller | Control Plane |
+-------+-----------------------+---------------+
| 3 | openstack-dashboard | Control Plane | | 3 | openstack-dashboard | Control Plane |
+-------+-----------------------+---------------+ +-------+-----------------------+---------------+
| 4 | nova-compute | Compute | | 4 | nova-compute | Compute |