Chapter 27. Uninstalling Streams for Apache Kafka
You can uninstall Streams for Apache Kafka on OpenShift 4.12 to 4.16 from the OperatorHub using the OpenShift Container Platform web console or CLI.
Use the same approach you used to install Streams for Apache Kafka.
When you uninstall Streams for Apache Kafka, you will need to identify resources created specifically for a deployment and referenced from the Streams for Apache Kafka resource.
Such resources include:
- Secrets (Custom CAs and certificates, Kafka Connect secrets, and other Kafka secrets)
-
Logging
ConfigMaps
(of typeexternal
)
These are resources referenced by Kafka
, KafkaConnect
, KafkaMirrorMaker
, or KafkaBridge
configuration.
Deleting CRDs and related custom resources
When a CustomResourceDefinition
is deleted, custom resources of that type are also deleted. This includes the Kafka
, KafkaConnect
, KafkaMirrorMaker
, and KafkaBridge
resources managed by Streams for Apache Kafka, as well as the StrimziPodSet
resource Streams for Apache Kafka uses to manage the pods of the Kafka components. In addition, any OpenShift resources created by these custom resources, such as Deployment
, Pod
, Service
, and ConfigMap
resources, are also removed. Always exercise caution when deleting these resources to avoid unintended data loss.
27.1. Uninstalling Streams for Apache Kafka from the OperatorHub using the web console
This procedure describes how to uninstall Streams for Apache Kafka from the OperatorHub and remove resources related to the deployment.
You can perform the steps from the console or use alternative CLI commands.
Prerequisites
-
Access to an OpenShift Container Platform web console using an account with
cluster-admin
orstrimzi-admin
permissions. You have identified the resources to be deleted.
You can use the following
oc
CLI command to find resources and also verify that they have been removed when you have uninstalled Streams for Apache Kafka.Command to find resources related to a Streams for Apache Kafka deployment
oc get <resource_type> --all-namespaces | grep <kafka_cluster_name>
Replace <resource_type> with the type of the resource you are checking, such as
secret
orconfigmap
.
Procedure
- Navigate in the OpenShift web console to Operators > Installed Operators.
For the installed Streams for Apache Kafka operator, select the options icon (three vertical dots) and click Uninstall Operator.
The operator is removed from Installed Operators.
- Navigate to Home > Projects and select the project where you installed Streams for Apache Kafka and the Kafka components.
Click the options under Inventory to delete related resources.
Resources include the following:
- Deployments
- StatefulSets
- Pods
- Services
- ConfigMaps
- Secrets
TipUse the search to find related resources that begin with the name of the Kafka cluster. You can also find the resources under Workloads.
Alternative CLI commands
You can use CLI commands to uninstall Streams for Apache Kafka from the OperatorHub.
Delete the Streams for Apache Kafka subscription.
oc delete subscription amq-streams -n openshift-operators
Delete the cluster service version (CSV).
oc delete csv amqstreams.<version> -n openshift-operators
Remove related CRDs.
oc get crd -l app=strimzi -o name | xargs oc delete
27.2. Uninstalling Streams for Apache Kafka using the CLI
This procedure describes how to use the oc
command-line tool to uninstall Streams for Apache Kafka and remove resources related to the deployment.
Prerequisites
-
Access to an OpenShift cluster using an account with
cluster-admin
orstrimzi-admin
permissions. You have identified the resources to be deleted.
You can use the following
oc
CLI command to find resources and also verify that they have been removed when you have uninstalled Streams for Apache Kafka.Command to find resources related to a Streams for Apache Kafka deployment
oc get <resource_type> --all-namespaces | grep <kafka_cluster_name>
Replace <resource_type> with the type of the resource you are checking, such as
secret
orconfigmap
.
Procedure
Delete the Cluster Operator
Deployment
, relatedCustomResourceDefinitions
, andRBAC
resources.Specify the installation files used to deploy the Cluster Operator.
oc delete -f install/cluster-operator
Delete the resources you identified in the prerequisites.
oc delete <resource_type> <resource_name> -n <namespace>
Replace <resource_type> with the type of resource you are deleting and <resource_name> with the name of the resource.
Example to delete a secret
oc delete secret my-cluster-clients-ca-cert -n my-project