Skip to main content

Uninstall ExternalDNS

This topic describes the process for properly uninstalling the ExternalDNS microservice without leaving behind any resources.

warning

After ExternalDNS is uninstalled, your DNS records will no longer be updated with IP address or metadata changes associated with your cluster's services. We recommend you to have a backup plan in place for managing your DNS records before proceeding.

Uninstall the ExternalDNS Microservice

If you still have the ExternalDNS YAML file, you can use the kubectl tool to remove it from the cluster with the following command:

kubectl delete -f gcp-cluster-external-dns.yaml

If you do not have the YAML file, you can use the following commands to remove all ExternalDNS artifacts:

kubectl delete deployment external-dns -n external-dns;
kubectl delete serviceaccount external-dns -n external-dns;
kubectl delete clusterrole external-dns -n external-dns;
kubectl delete clusterrolebinding external-dns-viewer -n external-dns;

Remove ExternalDNS Annotations

You may want to remove any annotations you added to your services while using ExternalDNS. You can achieve this by reviewing the domains you were using with ExternalDNS, and editing their service definitions on your cluster(s).

For example:

kubectl edit service frontend