Skip to content

Uninstalling Knative

To uninstall an Operator-based Knative installation, see the following Uninstall an Operator-based Knative Installation procedure. To uninstall a YAML-based Knative installation, see the following Uninstall a YAML-based Knative Installation procedure.

Uninstalling a YAML-based Knative installation

To uninstall a YAML-based Knative installation:

Uninstalling optional Serving extensions

Uninstall any Serving extensions you have installed by performing the steps in the following relevant tab:

Knative also supports the use of the Kubernetes Horizontal Pod Autoscaler (HPA) for driving autoscaling decisions. The following command will uninstall the components needed to support HPA-class autoscaling:

kubectl delete -f https://github.com/knative/serving/releases/download/knative-v1.0.0/serving-hpa.yaml
  1. Uninstall the component that integrates Knative with cert-manager:
kubectl delete -f https://github.com/knative/net-certmanager/releases/download/knative-v1.0.0/release.yaml
  1. Optional: if you no longer need cert-manager, uninstall it by following the steps in the cert-manager documentation.

Uninstall the net-http01 controller by running:

kubectl delete -f https://github.com/knative/net-http01/releases/download/knative-v1.0.0/release.yaml

Uninstalling a networking layer

Follow the relevant procedure to uninstall the networking layer you installed:

The following commands uninstall Ambassador and enable its Knative integration.

  1. Uninstall Ambassador by running:
kubectl delete --namespace ambassador \
 -f https://getambassador.io/yaml/ambassador/ambassador-crds.yaml \
 -f https://getambassador.io/yaml/ambassador/ambassador-rbac.yaml \
 -f https://getambassador.io/yaml/ambassador/ambassador-service.yaml
  1. Delete the Ambassador namespace:
kubectl delete namespace ambassador

The following commands uninstall Contour and enable its Knative integration.

  1. Uninstall the Knative Contour controller by running:

    kubectl delete -f https://github.com/knative/net-contour/releases/download/knative-v1.0.0/net-contour.yaml
    
  2. Uninstall Contour:

    kubectl delete -f https://github.com/knative/net-contour/releases/download/knative-v1.0.0/contour.yaml
    

The following commands uninstall Istio and enable its Knative integration.

  1. Uninstall the Knative Istio controller by running:

    kubectl delete -f https://github.com/knative/net-istio/releases/download/knative-v1.0.0/net-istio.yaml
    
  2. Optional: if you no longer need Istio, uninstall it by running:

    kubectl delete -f https://github.com/knative/net-istio/releases/download/knative-v1.0.0/istio.yaml
    

Uninstall the Knative Kourier controller by running:

kubectl delete -f https://github.com/knative/net-kourier/releases/download/knative-v1.0.0/kourier.yaml

Uninstalling the Serving component

  1. Uninstall the Serving core components by running:

    kubectl delete -f https://storage.googleapis.com/knative-nightly/serving/latest/serving-core.yaml
    
  2. Uninstall the required custom resources by running:

    kubectl delete -f https://storage.googleapis.com/knative-nightly/serving/latest/serving-crds.yaml
    

Uninstalling optional Eventing extensions

Uninstall any Eventing extensions you have installed by following the relevant procedure:

  1. Uninstall the Kafka Sink data plane:
kubectl delete -f https://github.com/knative-sandbox/eventing-kafka-broker/releases/download/knative-v1.0.0/eventing-kafka-sink.yaml
  1. Uninstall the Kafka controller:
kubectl delete -f https://github.com/knative-sandbox/eventing-kafka-broker/releases/download/knative-v1.0.0/eventing-kafka-controller.yaml

Uninstall the Eventing Sugar Controller by running:

kubectl delete -f https://github.com/knative/eventing/releases/download/knative-v1.0.0/eventing-sugar-controller.yaml

Uninstall a single-tenant GitHub source by running:

kubectl delete -f https://github.com/knative-sandbox/eventing-github/releases/download/knative-v1.0.0/github.yaml

Uninstall a multi-tenant GitHub source by running:

kubectl delete -f https://github.com/knative-sandbox/eventing-github/releases/download/knative-v1.0.0/mt-github.yaml

Uninstall the Apache Kafka source by running:

kubectl delete -f https://github.com/knative-sandbox/eventing-kafka/releases/download/knative-v1.0.0/source.yaml

Uninstall the GCP sources by running:

kubectl delete -f https://github.com/google/knative-gcp/releases/download/knative-v1.0.0/cloud-run-events.yaml

Uninstall the Apache CouchDB source by running:

kubectl delete -f https://github.com/knative-sandbox/eventing-couchdb/releases/download/knative-v1.0.0/couchdb.yaml

Uninstall the VMware sources and bindings by running:

kubectl delete -f https://github.com/vmware-tanzu/sources-for-knative/releases/download/knative-v1.0.0/release.yaml

Uninstalling an optional Broker (Eventing) layer

Uninstall a Broker (Eventing) layer, if you installed one:

  1. Uninstall the Kafka Broker data plane by running the following command:

    kubectl delete -f https://github.com/knative-sandbox/eventing-kafka-broker/releases/download/knative-v1.0.0/eventing-kafka-broker.yaml
    
  2. Uninstall the Kafka controller by running the following command:

    kubectl delete -f https://github.com/knative-sandbox/eventing-kafka-broker/releases/download/knative-v1.0.0/eventing-kafka-controller.yaml
    

Uninstall the broker by running:

kubectl delete -f https://github.com/knative/eventing/releases/download/knative-v1.0.0/mt-channel-broker.yaml

Uninstalling optional channel (messaging) layers

Uninstall each channel layer you have installed:

Uninstall the Apache Kafka Channel by running:

curl -L "https://github.com/knative-sandbox/eventing-kafka/releases/download/knative-v1.0.0/channel-consolidated.yaml" \
 | sed 's/REPLACE_WITH_CLUSTER_URL/my-cluster-kafka-bootstrap.kafka:9092/' \
 | kubectl delete -f -

Uninstall the Google Cloud Pub/Sub Channel by running:

kubectl delete -f https://github.com/google/knative-gcp/releases/download/knative-v1.0.0/cloud-run-events.yaml

Uninstall the in-memory channel implementation by running:

kubectl delete -f https://github.com/knative/eventing/releases/download/knative-v1.0.0/in-memory-channel.yaml
  1. Uninstall the NATS Streaming channel by running:

    kubectl delete -f https://github.com/knative-sandbox/eventing-natss/releases/download/knative-v1.0.0/eventing-natss.yaml
    
  2. Uninstall NATS Streaming for Kubernetes. For more information, see the eventing-natss repository in GitHub.

Uninstalling the Eventing component

  1. Uninstall the Eventing core components by running:

    kubectl delete -f https://storage.googleapis.com/knative-nightly/eventing/latest/eventing-core.yaml
    
  2. Uninstall the required custom resources by running:

    kubectl delete -f https://storage.googleapis.com/knative-nightly/eventing/latest/eventing-crds.yaml
    

Uninstall an Operator-based Knative installation

To uninstall an Operator-based Knative installation, follow these procedures:

Removing the Knative Serving component

Remove the Knative Serving CR:

kubectl delete KnativeServing knative-serving -n knative-serving

Removing Knative Eventing component

Remove the Knative Eventing CR:

kubectl delete KnativeEventing knative-eventing -n knative-eventing

Knative operator prevents unsafe removal of Knative resources. Even if the Knative Serving and Knative Eventing CRs are successfully removed, all the CRDs in Knative are still kept in the cluster. All your resources relying on Knative CRDs can still work.

Removing the Knative Operator:

If you have installed Knative using the Release page, remove the operator using the following command:

kubectl delete -f https://github.com/knative/operator/releases/download/knative-v1.0.0/operator.yaml

If you have installed Knative from source, uninstall it using the following command while in the root directory for the source:

ko delete -f config/
Back to top

We use analytics and cookies to understand site traffic. Information about your use of our site is shared with Google for that purpose. Learn more.

× OK