Skip to content

Commit f18b5cd

Browse files
committed
add section on upgrading CoreDNS
1 parent a2c4457 commit f18b5cd

1 file changed

Lines changed: 13 additions & 2 deletions

File tree

  • content/en/docs/tasks/administer-cluster

content/en/docs/tasks/administer-cluster/coredns.md

Lines changed: 13 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -29,7 +29,9 @@ deployment, or by using tools like kubeadm that will deploy and upgrade the clus
2929
For manual deployment or replacement of kube-dns, see the documentation at the
3030
[CoreDNS GitHub project.](https://github.com/coredns/deployment/tree/master/kubernetes)
3131

32-
## Upgrading an existing cluster with kubeadm
32+
## Migrating to CoreDNS
33+
34+
### Upgrading an existing cluster with kubeadm
3335

3436
In Kubernetes version 1.10 and later, you can also move to CoreDNS when you use `kubeadm` to upgrade
3537
a cluster that is using `kube-dns`. In this case, `kubeadm` will generate the CoreDNS configuration
@@ -53,7 +55,8 @@ customizations after the new ConfigMap is up and running.
5355
If you are running CoreDNS in Kubernetes version 1.11 and later, during upgrade,
5456
your existing Corefile will be retained.
5557

56-
## Installing kube-dns instead of CoreDNS with kubeadm
58+
59+
### Installing kube-dns instead of CoreDNS with kubeadm
5760

5861
{{< note >}}
5962
In Kubernetes 1.11, CoreDNS has graduated to General Availability (GA)
@@ -69,6 +72,14 @@ kubeadm init --feature-gates=CoreDNS=false
6972

7073
For versions 1.13 and later, follow the guide outlined [here](/docs/reference/setup-tools/kubeadm/kubeadm-init-phase#cmd-phase-addon).
7174

75+
## Upgrading CoreDNS
76+
77+
CoreDNS is available in Kubernetes since v1.9.
78+
You can check the version of CoreDNS shipped with Kubernetes and the changes made to CoreDNS [here](https://github.com/coredns/deployment/blob/master/kubernetes/CoreDNS-k8s_version.md).
79+
80+
CoreDNS can be upgraded manually in case you want to only upgrade CoreDNS or use your own custom image.
81+
There is a helpful [guideline and walkthrough](https://github.com/coredns/deployment/blob/master/kubernetes/Upgrading_CoreDNS.md) available to ensure a smooth upgrade.
82+
7283
## Tuning CoreDNS
7384

7485
When resource utilisation is a concern, it may be useful to tune the configuration of CoreDNS. For more details, check out the

0 commit comments

Comments
 (0)