6.3. Uninstalling the web terminal
Uninstalling the web terminal is a two-step process:
- Delete the components and custom resources (CRs) that were added when you installed the Operator.
- Uninstall the Web Terminal Operator.
Uninstalling the Web Terminal Operator does not remove any of its custom resource definitions (CRDs) or managed resources that are created when the Operator is installed. These components must be manually uninstalled for security purposes. Removing these components also allows you to save cluster resources by ensuring that terminals do not idle when the Operator is uninstalled.
Prerequisites
-
Access to an OpenShift Container Platform cluster using an account with
cluster-adminpermissions.
6.3.1. Deleting the web terminal components and custom resources
Use the CLI to delete the CRs that are created during installation of the Web Terminal Operator.
Procedure
Run the following commands to ensure that all
DevWorkspaceCRs are removed along with their related Kubernetes objects, such as deployments.$ oc delete devworkspaces.workspace.devfile.io --all-namespaces --all --wait
$ oc delete workspaceroutings.controller.devfile.io --all-namespaces --all --wait
$ oc delete components.controller.devfile.io --all-namespaces --all --wait
警告If this step is not complete, finalizers make it difficult to fully uninstall the Operator easily.
Run the following commands to remove the CRDs:
$ oc delete customresourcedefinitions.apiextensions.k8s.io workspaceroutings.controller.devfile.io
$ oc delete customresourcedefinitions.apiextensions.k8s.io components.controller.devfile.io
$ oc delete customresourcedefinitions.apiextensions.k8s.io devworkspaces.workspace.devfile.io
Remove the
DevWorkspace-Webhook-Serverdeployment:$ oc delete deployment/devworkspace-webhook-server -n openshift-operators
注意When you run this and the following steps, you cannot use the
oc execcommands to run commands in a container. After you remove the webhooks you will be able to use theoc execcommands again.Run the following commands to remove any lingering services, secrets, and config maps:
$ oc delete all --selector app.kubernetes.io/part-of=devworkspace-operator,app.kubernetes.io/name=devworkspace-webhook-server
$ oc delete serviceaccounts devworkspace-webhook-server -n openshift-operators
$ oc delete configmap devworkspace-controller -n openshift-operators
$ oc delete clusterrole devworkspace-webhook-server
$ oc delete clusterrolebinding devworkspace-webhook-server
Run the following commands to remove mutating or validating webhook configurations:
$ oc delete mutatingwebhookconfigurations controller.devfile.io
$ oc delete validatingwebhookconfigurations controller.devfile.io
6.3.2. Uninstalling the Operator using the web console
Procedure
-
In the Administrator perspective of the web console, navigate to Operators
Installed Operators. - Scroll the filter list or type a keyword into the Filter by name box to find the Web Terminal Operator.
-
Click the Options menu
for the Web Terminal Operator, and then select Uninstall Operator.
- In the Uninstall Operator confirmation dialog box, click Uninstall to remove the Operator, Operator deployments, and pods from the cluster. The Operator stops running and no longer receives updates.
