docs(dns): move content from README.md into "Configure DNS" doc

Author: mboersma

README.md

@@ -71,16 +71,7 @@ Use `make run` to start all Deis containers and attach to their log output. This
 $ make run
 ```
 
-## Configuring DNS for multi-node clusters
-For a one-node cluster, both deis-router and deis-controller will run on the same host. For convenience, we've created the DNS record `local.deisapp.com` which resolves to the IP of the first VM, 172.17.8.100.
-You can use `local.deisapp.com` to both log into the controller and to access applications that you've deployed (they will be subdomains of `local.deisapp.com`, like `happy-unicorn.local.deisapp.com`).
-
-On a multi-node cluster, however, the router and controller will likely be scheduled on separate machines. Since we cannot know the IP addresses ahead of time, you'll need to setup resolution yourself using your own domain (unfortunately, wildcard hostnames are not permitted in `/etc/hosts`). The records should be as follows:
-
-* `deis.example.org` should resolve to the IP of the machine that runs `deis-controller`
-* `*.deis.example.org` (a wildcard DNS entry) should resolve to the IP of the machine that runs `deis-router`
-
-These records are necessary for multi-node Vagrant as well as any other multi-node deployments of Deis (EC2, Rackspace, etc.).
+Your Vagrant VM is accessible at `local.deisapp.com`. For clusters with more than one node, see our guide to [Configuring DNS](http://docs.deis.io/en/latest/operations/configure-dns/).
 
 ## Testing the cluster
 Integration tests and corresponding documentation can be found under the `test/` folder.

contrib/ec2/README.md

@@ -63,7 +63,7 @@ The script will deploy Deis and make sure the services start properly.
 
 ## Configure DNS
 While you can reference the controller and hosted applications with public hostnames provided by EC2, it is recommended for ease-of-use that
-you configure your own DNS records using a domain you own. See [Configuring DNS for multi-node clusters](../../README.md#configuring-dns-for-multi-node-clusters) for details.
+you configure your own DNS records using a domain you own. See [Configuring DNS](http://docs.deis.io/en/latest/operations/configure-dns/) for details.
 
 ## Use Deis!
 After that, register with Deis!

contrib/rackspace/README.md

@@ -58,7 +58,7 @@ $ cd ../.. && make run
 The script will deploy Deis and make sure the services start properly.
 
 ### Configure DNS
-You'll need to configure DNS records so you can access applications hosted on Deis. See [Configuring DNS for multi-node clusters](../../README.md#configuring-dns-for-multi-node-clusters) for details.
+You'll need to configure DNS records so you can access applications hosted on Deis. See [Configuring DNS](http://docs.deis.io/en/latest/operations/configure-dns/) for details.
 
 ### Use Deis!
 After that, register with Deis!

docs/operations/configure-dns.rst

@@ -0,0 +1,17 @@
+:title: Configure DNS
+:description: Configure name resolution for your Deis Cluster
+
+.. _configure-dns:
+
+Configure DNS
+-------------
+
+For a one-node cluster, both deis-router and deis-controller will run on the same host. For convenience, we've created the DNS record ``local.deisapp.com`` which resolves to the IP of the first VM, 172.17.8.100.
+You can use ``local.deisapp.com`` to both log into the controller and to access applications that you've deployed (they will be subdomains of ``local.deisapp.com``, like ``happy-unicorn.local.deisapp.com``).
+
+On a multi-node cluster, however, the router and controller will likely be scheduled on separate machines. Since we cannot know the IP addresses ahead of time, you'll need to setup resolution yourself using your own domain (unfortunately, wildcard hostnames are not permitted in ``/etc/hosts``). The records should be as follows:
+
+* ``deis.example.org`` should resolve to the IP of the machine that runs ``deis-controller``
+* ``*.deis.example.org`` (a wildcard DNS entry) should resolve to the IP of the machine that runs ``deis-router``
+
+These records are necessary for multi-node Vagrant as well as any other multi-node deployments of Deis (EC2, Rackspace, etc.).

docs/operations/index.rst

@@ -15,3 +15,4 @@ Operations Guide
     provision-controller
     register-admin-user
     manage-controller
+    configure-dns