From 16f6b183df66eba3ba932d6e2933481133ffab29 Mon Sep 17 00:00:00 2001
From: John Belamaric <jbelamaric@infoblox.com>
Date: Thu, 7 Dec 2017 00:28:51 -0500
Subject: [PATCH] CoreDNS feature documentation (#6463)

* Initial placeholder PR for CoreDNS feature documentation

* Remove from admin, add content

* Fix missing endcapture

* Add to tasks.yml

* Review feedback
---
 _data/tasks.yml                          |  1 +
 docs/tasks/administer-cluster/coredns.md | 42 ++++++++++++++++++++++++
 2 files changed, 43 insertions(+)
 create mode 100644 docs/tasks/administer-cluster/coredns.md

diff --git a/_data/tasks.yml b/_data/tasks.yml
index 15eb64620b..b7defe6768 100644
--- a/_data/tasks.yml
+++ b/_data/tasks.yml
@@ -143,6 +143,7 @@ toc:
   - docs/tasks/administer-cluster/namespaces.md
   - docs/tasks/administer-cluster/namespaces-walkthrough.md
   - docs/tasks/administer-cluster/dns-horizontal-autoscaling.md
+  - docs/tasks/administer-cluster/coredns.md
   - docs/tasks/administer-cluster/safely-drain-node.md
   - docs/tasks/administer-cluster/cpu-memory-limit.md
   - docs/tasks/administer-cluster/out-of-resource.md
diff --git a/docs/tasks/administer-cluster/coredns.md b/docs/tasks/administer-cluster/coredns.md
new file mode 100644
index 0000000000..ead2e53247
--- /dev/null
+++ b/docs/tasks/administer-cluster/coredns.md
@@ -0,0 +1,42 @@
+---
+approvers:
+- johnbelamaric
+title: Using CoreDNS for Service Discovery
+min-kubernetes-server-version: v1.9
+---
+
+{% include feature-state-alpha.md %}
+
+{% capture overview %}
+This page describes how to enable CoreDNS instead of kube-dns for service
+discovery.
+{% endcapture %}
+
+{% capture prerequisites %}
+{% include task-tutorial-prereqs.md %}
+{% endcapture %}
+
+{% capture steps %}
+
+## Installing CoreDNS with kubeadm
+
+In Kubernetes 1.9, [CoreDNS](https://coredns.io) is available as an alpha feature and
+may be installed by setting the `CoreDNS` feature gate to `true` during `kubeadm init`:
+
+```
+kubeadm init --feature-gates=CoreDNS=true
+```
+
+This installs CoreDNS instead of kube-dns.
+
+{% endcapture %}
+
+{% capture whatsnext %}
+
+You can configure [CoreDNS](https://coredns.io) to support many more use cases than
+kube-dns by modifying the `Corefile`. For more information, see the
+[CoreDNS site]https://coredns.io/2017/05/08/custom-dns-entries-for-kubernetes/).
+
+{% endcapture %}
+
+{% include templates/task.md %}