starlingx/docs
Code Issues Proposed changes

Merge "Multi-version application support for extended k8s version upgrades"

Browse Source
This commit is contained in:
Zuul 2024-05-09 15:16:56 +00:00 committed by Gerrit Code Review
commit ec32b75eb8
2 changed files with 33 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

19
doc/source/updates/kubernetes/manual-kubernetes-components-upgrade.rst
View File

@ -160,9 +160,9 @@ and upgrade various systems.
+--------------+--------------------------------------+
| from_version | v1.21.8 |
| to_version | v1.22.5 |
| state | upgrade-started |
| state | upgrade-started |
+--------------+--------------------------------------+
The upgrade process checks the *applied*/*available* updates, the upgrade
path, the health of the system, the installed applications compatibility and
@ -173,6 +173,12 @@ and upgrade various systems.
upgrade process to ignore non-management-affecting alarms.
Kubernetes cannot be upgraded if there are management-affecting alarms.
#. Update all applications that have the ``timing: pre`` metadata setting.
.. code-block:: none
~(keystone_admin)]$ system pre-application-update
#. Download the Kubernetes images.
For example:
@ -242,7 +248,7 @@ and upgrade various systems.
| status | upgrading-control-plane |
| target_version | v1.22.5 |
+-----------------------+-------------------------+
You can upgrade either controller first.
The state *upgraded-first-master* will be entered when the first control
@ -410,6 +416,13 @@ and upgrade various systems.
| updated_at | 2023-06-26T19:06:47.515747+00:00 |
+--------------+--------------------------------------+
#. |Optional| Update all applications that have the ``timing: post`` metadata
setting.
.. code-block:: none
~(keystone_admin)]$ system post-application-update
#. Remove the alarm 900.007 (Kubernetes upgrade in progress) if it is still
running after the upgrade.

21
doc/source/updates/kubernetes/manual-kubernetes-multi-version-upgrade-in-aio-sx-13e05ba19840.rst
View File

@ -131,7 +131,7 @@ system. This feature is not supported in the system which is not |AIO-SX|.
+--------------+--------------------------------------+
| from_version | v1.21.8 |
| to_version | v1.24.4 |
| state | upgrade-started |
| state | upgrade-started |
+--------------+--------------------------------------+
The upgrade process checks the applied/available updates, the upgrade
@ -161,6 +161,12 @@ system. This feature is not supported in the system which is not |AIO-SX|.
| updated_at | None |
+--------------+--------------------------------------+
#. Update all applications that have the ``timing: pre`` metadata setting.
.. code-block:: none
~(keystone_admin)]$ system pre-application-update
#. Confirm that the download has completed.
.. code-block:: none
@ -276,7 +282,7 @@ system. This feature is not supported in the system which is not |AIO-SX|.
~(keystone_admin)]$ system kube-host-upgrade-list
+----+---------------+------------+----------------+-----------------------+-----------------+--------------+
| id | hostname | personality| target_version | control_plane_version | kubelet_version | status |
| id | hostname | personality| target_version | control_plane_version | kubelet_version | status |
+----+---------------+------------+----------------+-----------------------+-----------------+--------------+
| 1 | controller-0 | controller | v1.22.5 | v1.22.5 | v1.21.8 | None |
+----+---------------+---+--------+----------------+-----------------------+-----------------+--------------+
@ -304,7 +310,7 @@ system. This feature is not supported in the system which is not |AIO-SX|.
~(keystone_admin)]$ system kube-host-upgrade-list
+----+---------------+------------+----------------+-----------------------+-----------------+------------------+
| id | hostname | personality| target_version | control_plane_version | kubelet_version | status |
| id | hostname | personality| target_version | control_plane_version | kubelet_version | status |
+----+---------------+------------+----------------+-----------------------+-----------------+------------------+
| 1 | controller-0 | controller | v1.22.5 | v1.22.5 | v1.22.5 | upgraded-kubelet |
+----+---------------+---+--------+----------------+-----------------------+-----------------+------------------+
@ -370,6 +376,13 @@ system. This feature is not supported in the system which is not |AIO-SX|.
| updated_at | 2023-08-24T02:55:18.122620+00:00 |
+--------------+--------------------------------------+
#. |Optional| Update all applications that have the ``timing: post`` metadata
setting.
.. code-block:: none
~(keystone_admin)]$ system post-application-update
#. Remove the alarm 900.007 (Kubernetes upgrade in progress) if it is still
running after the upgrade.
@ -418,5 +431,5 @@ To check the status of the abort operation, run the following command:
- The upgrade abort operation reverts all the Kubernetes version upgrades and
shows the same state the Kubernetes was in before the upgrade started.
- Once the Kubernetes upgrade is completed, it cannot be aborted.