Chapter 2. 3scale operator-based upgrade guide: from 2.7 to 2.8

Procedure

1. Log in to the OCP console using the account with administrator privileges.
2. Select the project where the 3scale-operator has been deployed.
3. Click Operators > Installed Operators.
4. Select 3scale operator Subscription > Channel.

5. Edit the channel of the subscription by selecting the threescale-2.8 and save the changes.

   • This will start the upgrade process.
   • Wait until the upgrade process finishes for the APIManager.

6. Query the pods status on the project:

   oc get pods

   Copy to Clipboard Toggle word wrap
   • Wait until all the new versions are running and ready without errors.

   • They might have temporary errors during the upgrade process.

     Note

     Times can vary from 5-10 minutes approximately. Be sure to keep checking the state of the pods until all of them are running, ready, and without errors.

7. Confirm the upgrade process has been successful, by logging in to the 3scale Admin Portal and check that it works as expected.

8. Check the status of the APIManager objects and get the YAML content by running the following command:

   oc get apimanager <myapimanager> -o yaml

   Copy to Clipboard Toggle word wrap

   1. The new annotations with the values should be shown as follows:

      apps.3scale.net/apimanager-threescale-version: "2.8"
      apps.3scale.net/threescale-operator-version: "0.5.0"

      Copy to Clipboard Toggle word wrap

      After you have performed all the listed steps, 3scale upgrade from 2.7 to 2.8 in an operator-based deployment is now complete.