openstack
/
charm-deployment-guide
Code Issues Proposed changes

Refactor upgrade pages - part III 

Rename some pages and change links accordingly.

Fix some already broken links.

Change-Id: Icbeadc7910a8050a80b33e68f318fb76c5b27f78
This commit is contained in:
Peter Matulis 2020-12-15 21:30:17 -05:00
parent c57a525583
commit c473a8f673
8 changed files with 21 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
deploy-guide/source/app-ceph-migration.rst
View File

@ -29,7 +29,7 @@ Upgrade charms
The entire suite of charms used to manage the cloud should be upgraded to the
latest stable charm revision before any major change is made to the cloud such
as the current migration to these new charms. See `Charm upgrades`_ for
as the current migration to these new charms. See `Charms upgrade`_ for
guidance.
Deploy ceph-mon
@ -135,5 +135,5 @@ processes running on the machine; any Ceph OSD processes remain untouched and
are now owned by the ceph-osd units deployed alongside ceph.
.. LINKS
.. _Charm upgrades: app-upgrade-openstack#charm-upgrades
.. _Charms upgrade: upgrade-charms.html
.. _LP #1452641: https://bugs.launchpad.net/nova/+bug/1452641

4
deploy-guide/source/index.rst
View File

@ -34,8 +34,8 @@ contribution`_.
Overview <upgrade-overview>
upgrade-charms
app-upgrade-openstack
app-series-upgrade
upgrade-openstack
upgrade-series
upgrade-special
upgrade-issues

10
deploy-guide/source/install-openstack.rst
View File

@ -26,7 +26,7 @@ bundle <install-openstack-bundle>` for method #2.
#. The entire suite of charms used to manage the cloud should be upgraded to
the latest stable charm revision before any major change is made to the
cloud (e.g. migrating to new charms, upgrading cloud services, upgrading
machine series). See `Charm upgrades`_ for details.
machine series). See `Charms upgrade`_ for details.
#. The Juju machines that comprise the cloud should all be running the same
series (e.g. 'bionic' or 'focal', but not a mix of the two). See `Series
@ -69,8 +69,8 @@ recent OpenStack release in this way will result in an Ussuri deployment (i.e.
Ussuri is in the Ubuntu package archive for Focal).
See :ref:`Perform the upgrade <perform_the_upgrade>` in the :doc:`OpenStack
Upgrades <app-upgrade-openstack>` appendix for more details on cloud
archive releases and how they are used when upgrading OpenStack.
Upgrade <upgrade-openstack>` appendix for more details on cloud archive
releases and how they are used when upgrading OpenStack.
.. important::
@ -753,8 +753,8 @@ networks, images, and a user environment. Go to :doc:`Configure OpenStack
.. LINKS
.. _OpenStack Charms: https://docs.openstack.org/charm-guide/latest/openstack-charms.html
.. _Charm upgrades: app-upgrade-openstack.html#charm-upgrades.html
.. _Series upgrade: app-series-upgrade.html
.. _Charms upgrade: upgrade-charms.html
.. _Series upgrade: upgrade-series.html
.. _Charm store: https://jaas.ai/store
.. _Post-commission configuration: https://maas.io/docs/commission-nodes#heading--post-commission-configuration
.. _Deploying applications: https://juju.is/docs/deploying-applications

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

@ -107,4 +107,4 @@ Based on the above, the ceph-mon charm does not require an upgrade.
.. LINKS
.. _Upgrading applications: https://jaas.ai/docs/upgrading-applications
.. _Release Notes: https://docs.openstack.org/charm-guide/latest/release-notes.html
.. _Series upgrade: app-series-upgrade
.. _Series upgrade: upgrade-series.html

0
deploy-guide/source/app-upgrade-openstack.rst → deploy-guide/source/upgrade-openstack.rst
View File

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

@ -171,8 +171,8 @@ Next steps
Each upgrade type is broken down into more detail on the following pages:
* :doc:`Charms upgrade <upgrade-charms>`
* :doc:`OpenStack upgrade <app-upgrade-openstack>`
* :doc:`Series upgrade <app-series-upgrade>`
* :doc:`OpenStack upgrade <upgrade-openstack>`
* :doc:`Series upgrade <upgrade-series>`
.. LINKS
.. _Ubuntu Cloud Archive: https://wiki.ubuntu.com/OpenStack/CloudArchive

3
deploy-guide/source/app-series-upgrade-openstack.rst → deploy-guide/source/upgrade-series-openstack.rst
View File

@ -794,7 +794,6 @@ and test the series upgrade primitives:
production cloud.
.. LINKS
.. _Charm upgrades: app-upgrade-openstack#charm-upgrades
.. _Series upgrade: app-series-upgrade.html
.. _Series upgrade: upgrade-series.html
.. _Parallel tests: https://github.com/openstack-charmers/zaza-openstack-tests/blob/c492ecdcac3b2724833c347e978de97ea2e626d7/zaza/openstack/charm_tests/series_upgrade/parallel_tests.py#L64
.. _Upgrade helpers: https://github.com/openstack-charmers/zaza-openstack-tests/blob/9cec2efabe30fb0709bc098c48ec10bcb85cc9d4/zaza/openstack/utilities/parallel_series_upgrade.py

16
deploy-guide/source/app-series-upgrade.rst → deploy-guide/source/upgrade-series.rst
View File

@ -15,8 +15,8 @@ Please read the following before continuing:
* the :doc:`Upgrade issues <upgrade-issues>` page
Once this document has been studied the administrator will be ready to graduate
to the :doc:`Series upgrade OpenStack <app-series-upgrade-openstack>` guide
that describes the process in more detail.
to the :doc:`Series upgrade OpenStack <upgrade-series-openstack>` guide that
describes the process in more detail.
Concerning the cloud being operated upon, the following is assumed:
@ -107,12 +107,12 @@ making any changes.
* The cloud should be running the latest OpenStack release supported by the
current series. See `Ubuntu OpenStack release cycle`_ and `OpenStack
upgrades`_.
upgrade`_.
* The cloud should be fully operational and error-free.
* All currently deployed charms should be upgraded to the latest stable charm
revision. See `Charm upgrades`_.
revision. See `Charms upgrade`_.
* The Juju model comprising the cloud should be error-free (e.g. there should
be no charm hook errors).
@ -312,13 +312,13 @@ Next steps
----------
When you are ready to perform a series upgrade across your cloud proceed to
appendix :doc:`Series upgrade OpenStack <app-series-upgrade-openstack>`.
appendix :doc:`Series upgrade OpenStack <upgrade-series-openstack>`.
.. LINKS
.. _Release Notes: https://docs.openstack.org/charm-guide/latest/release-notes.html
.. _Charm upgrades: app-upgrade-openstack.html#charm-upgrades
.. _OpenStack upgrades: app-series-upgrade-openstack.html
.. _Known OpenStack upgrade issues: app-series-upgrade-openstack.html#known-openstack-upgrade-issues
.. _Charms upgrade: upgrade-charms.html
.. _OpenStack upgrade: upgrade-openstack.html
.. _Known OpenStack upgrade issues: upgrade-issues.html
.. _series upgrade: https://juju.is/docs/upgrading-series
.. _automatic package updates: https://help.ubuntu.com/lts/serverguide/automatic-updates.html.en
.. _Ubuntu OpenStack release cycle: https://ubuntu.com/about/release-cycle#ubuntu-openstack-release-cycle