Chapter 5. Upgrading OpenShift Dev Spaces

Procedure

1. In the OpenShift web console, navigate to Operators Installed Operators.
2. Click Red Hat OpenShift Dev Spaces in the list of installed Operators.
3. Navigate to the Subscription tab.
4. Configure the Update approval strategy to Automatic or Manual.

Verification steps

1. Navigate to the OpenShift Dev Spaces instance.
2. The 3.1 version number is visible at the bottom of the page.

Procedure

1. Delete the devworkspace-controller namespace that contains the failing pod.

2. Update DevWorkspace and DevWorkspaceTemplate Custom Resource Definitions (CRD) by setting the conversion strategy to None and removing the entire webhook section:

   spec:
     ...
     conversion:
       strategy: None
   status:
   ...

   Tip

   You can find and edit the DevWorkspace and DevWorkspaceTemplate CRDs in the Administrator perspective of the OpenShift web console by searching for DevWorkspace in Administration CustomResourceDefinitions.

   Note

   The DevWorkspaceOperatorConfig and DevWorkspaceRouting CRDs have the conversion strategy set to None by default.

3. Remove the DevWorkspace Operator subscription:

   $ oc delete sub devworkspace-operator \
   -n openshift-operators 1

   1

   openshift-operators or an OpenShift project where the DevWorkspace Operator is installed.

4. Get the DevWorkspace Operator CSVs in the <devworkspace-operator.vX.Y.Z> format:

   $ oc get csv | grep devworkspace

5. Remove each DevWorkspace Operator CSV:

   $ oc delete csv <devworkspace-operator.vX.Y.Z> \
   -n openshift-operators 1

   1

   openshift-operators or an OpenShift project where the DevWorkspace Operator is installed.

6. Re-create the DevWorkspace Operator subscription:

   $ cat <<EOF | oc apply -f -
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: devworkspace-operator
     namespace: openshift-operators
   spec:
     channel: fast
     name: devworkspace-operator
     source: redhat-operators
     sourceNamespace: openshift-marketplace
     installPlanApproval: Automatic 1
     startingCSV: devworkspace-operator.v0.15.2
   EOF

   1

   Automatic or Manual.

   Important

   For installPlanApproval: Manual, in the Administrator perspective of the OpenShift web console, go to Operators Installed Operators and select the following for the DevWorkspace Operator: Upgrade available Preview InstallPlan Approve.

7. In the Administrator perspective of the OpenShift web console, go to Operators Installed Operators and verify the Succeeded status of the DevWorkspace Operator.