Using CoreDNS for Service Discovery
This page describes the CoreDNS upgrade process and how to install CoreDNS instead of kube-dns.
- Before you begin
- About CoreDNS
- Installing CoreDNS
- Migrating to CoreDNS
- Upgrading CoreDNS
- Tuning CoreDNS
- What's next
Before you begin
You need to have a Kubernetes cluster, and the kubectl command-line tool must be configured to communicate with your cluster. If you do not already have a cluster, you can create one by using Minikube, or you can use one of these Kubernetes playgrounds:
Your Kubernetes server must be at or later than version v1.9.
To check the version, enter kubectl version
.
About CoreDNS
CoreDNS is a flexible, extensible DNS server that can serve as the Kubernetes cluster DNS. Like Kubernetes, the CoreDNS project is hosted by the CNCFCloud Native Computing Foundation .
You can use CoreDNS instead of kube-dns in your cluster by replacing kube-dns in an existing deployment, or by using tools like kubeadm that will deploy and upgrade the cluster for you.
Installing CoreDNS
For manual deployment or replacement of kube-dns, see the documentation at the CoreDNS GitHub project.
Migrating to CoreDNS
Upgrading an existing cluster with kubeadm
In Kubernetes version 1.10 and later, you can also move to CoreDNS when you use kubeadm
to upgrade
a cluster that is using kube-dns
. In this case, kubeadm
will generate the CoreDNS configuration
(“Corefile”) based upon the kube-dns
ConfigMap, preserving configurations for federation,
stub domains, and upstream name server.
If you are moving from kube-dns to CoreDNS, make sure to set the CoreDNS
feature gate to true
during an upgrade. For example, here is what a v1.11.0
upgrade would look like:
kubeadm upgrade apply v1.11.0 --feature-gates=CoreDNS=true
In Kubernetes version 1.13 and later the CoreDNS
feature gate is removed and CoreDNS
is used by default. Follow the guide outlined here if you want
your upgraded cluster to use kube-dns.
In versions prior to 1.11 the Corefile will be overwritten by the one created during upgrade. You should save your existing ConfigMap if you have customized it. You may re-apply your customizations after the new ConfigMap is up and running.
If you are running CoreDNS in Kubernetes version 1.11 and later, during upgrade, your existing Corefile will be retained.
Installing kube-dns instead of CoreDNS with kubeadm
Note: In Kubernetes 1.11, CoreDNS has graduated to General Availability (GA) and is installed by default.
Warning: In Kubernetes 1.18, kube-dns usage with kubeadm has been deprecated and will be removed in a future version.
To install kube-dns on versions prior to 1.13, set the CoreDNS
feature gate
value to false
:
kubeadm init --feature-gates=CoreDNS=false
For versions 1.13 and later, follow the guide outlined here.
Upgrading CoreDNS
CoreDNS is available in Kubernetes since v1.9. You can check the version of CoreDNS shipped with Kubernetes and the changes made to CoreDNS here.
CoreDNS can be upgraded manually in case you want to only upgrade CoreDNS or use your own custom image. There is a helpful guideline and walkthrough available to ensure a smooth upgrade.
Tuning CoreDNS
When resource utilisation is a concern, it may be useful to tune the configuration of CoreDNS. For more details, check out the documentation on scaling CoreDNS.
What's next
You can configure CoreDNS to support many more use cases than
kube-dns by modifying the Corefile
. For more information, see the
CoreDNS site.
Feedback
Was this page helpful?
Thanks for the feedback. If you have a specific, answerable question about how to use Kubernetes, ask it on Stack Overflow. Open an issue in the GitHub repo if you want to report a problem or suggest an improvement.