Skip to content

Commit

Permalink
coredns: update notes in administer-cluster/coredns.md
Browse files Browse the repository at this point in the history
CoreDNS is installed by default in 1.11.
Add notes on how to install kube-dns instead.

Update notes about CoreDNS->CoreDNS upgrades as in 1.11
the Corefile is retained.
  • Loading branch information
neolit123 committed May 24, 2018
1 parent 462adb8 commit 0e069f0
Showing 1 changed file with 12 additions and 19 deletions.
31 changes: 12 additions & 19 deletions content/en/docs/tasks/administer-cluster/coredns.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,11 +6,8 @@ min-kubernetes-server-version: v1.9
content_template: templates/task
---

{{< feature-state state="beta" >}}

{{% capture overview %}}
This page describes how to enable CoreDNS instead of kube-dns for service
discovery.
This page describes the CoreDNS upgrade process and how to install kube-dns instead of CoreDNS.
{{% /capture %}}

{{% capture prerequisites %}}
Expand All @@ -19,32 +16,28 @@ discovery.

{{% capture steps %}}

## Installing CoreDNS with kubeadm

In Kubernetes 1.9, [CoreDNS](https://coredns.io) is available as an alpha feature, and
in Kubernetes 1.10 it is available as a beta feature. In either case, you may install
it during cluster creation by setting the `CoreDNS` feature gate to `true` during `kubeadm init`:
## Installing kube-dns with kubeadm

In Kubernetes 1.11, [CoreDNS](https://coredns.io) has graduated to General Availability (GA)
and is installed by default. To install kube-dns instead, set the `CoreDNS` feature gate
value to `false`:
```
kubeadm init --feature-gates=CoreDNS=true
kubeadm init --feature-gates=CoreDNS=false
```

This installs CoreDNS instead of kube-dns.

## Upgrading an Existing Cluster with kubeadm

In Kubernetes 1.10, you can also move to CoreDNS when you use `kubeadm` to upgrade
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.

Note that if you are running CoreDNS in your cluster already, prior to upgrade, your existing 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.

This process will be modified for the GA release of this feature, such that an existing
Corefile will not be overwritten.
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.

{{% /capture %}}

Expand Down

0 comments on commit 0e069f0

Please sign in to comment.