Skip to content

Latest commit

 

History

History
92 lines (69 loc) · 3.38 KB

upgrade.md

File metadata and controls

92 lines (69 loc) · 3.38 KB
Raw

Upgrade

Upgrade can be performed to the:

  • latest one DS build (by default)
  • next one Y version, for example current 4.2 -> latest 4.3. (version passed by --upgrade-ocs-version param)
  • specific image:tag specified by configuration file (see the example below) or cli param --upgrade-ocs-registry-image.
  • next one DS build from current one - upgrade_to_latest: false has to be set, see here: upgrade_to_next_build.yaml for more details.

Deployment

To be able to upgrade your cluster you cannot deploy the latest downstream build, because then you won't have any next build available for upgrade.

For this purpose we have this config file: upgrade.yaml which you can pass via --ocsci-conf when you are running the deployment. This will automatically take not latest build but one before.

Upgrade execution

For upgrade we have few pytest marks defined here:

  • pre_upgrade - mark tests which are suppose to run before upgrade
  • upgrade - this is mark for upgrade itself
  • post_upgrade - mark tests which are suppose to run after upgrade

Those marks has to be imported from mentioned module and your test have to be decorated by those marks as we combine those mark decorators with order decorator used by pytest-ordering plugin to properly order the tests.

To execute the upgrade you can use this command:

run-ci tests/
    --cluster-name kerberos_ID-ocs-deployment \
    --cluster-path /home/my_user/my-ocs-dir \
    -m upgrade

If you would like to trigger also pre/post upgrade tests run with following markers:

run-ci tests/
    --cluster-name kerberos_ID-ocs-deployment \
    --cluster-path /home/my_user/my-ocs-dir \
    -m 'pre_upgrade or upgrade or post_upgrade'

In the case you would like to upgrade just to the one following DS build and not to the latest one, please pass conf/ocsci/upgrade_to_next_build.yaml configuration file to the upgrade execution.

For upgrade between versions like 4.2 to 4.3 you need to:

  • specify version of OCS you have installed with --ocs-version param. This will load proper config for this version (default is loaded latest one version specified in OCS-CI default config). Example
  • specify version of OCS you would like to upgrade to with --upgrade-ocs-version. This will automatically load new config for specific version.

Example:

run-ci tests/
    --cluster-name kerberos_ID-ocs-deployment \
    --cluster-path /home/my_user/my-ocs-dir \
    -m 'pre_upgrade or upgrade or post_upgrade' --ocs-version 4.2 --upgrade-ocs-version 4.3

Upgrade to specific build via config file:

UPGRADE:
  upgrade_ocs_registry_image: "quay.io/rhceph-dev/ocs-olm-operator:latest-4.3"

Upgrade to specific build via cli option:

run-ci tests/
    --cluster-name kerberos_ID-ocs-deployment \
    --cluster-path /home/my_user/my-ocs-dir \
    -m 'pre_upgrade or upgrade or post_upgrade' --ocs-version 4.2 --upgrade-ocs-version 4.3 \
    --upgrade-ocs-registry-image 'quay.io/rhceph-dev/ocs-olm-operator:latest-4.3'