Skip to content
This repository has been archived by the owner on Nov 30, 2021. It is now read-only.

Commit

Permalink
docs(configure-dns): move xip.io to new section
Browse files Browse the repository at this point in the history
  • Loading branch information
carmstrong committed Jun 20, 2014
1 parent 8a87776 commit d791866
Showing 1 changed file with 10 additions and 6 deletions.
16 changes: 10 additions & 6 deletions docs/installing_deis/configure-dns.rst
Expand Up @@ -11,12 +11,6 @@ You can use ``local.deisapp.com`` to both log into the controller and to access

For Deis clusters hosted elsewhere (EC2, Rackspace, bare metal, etc.), DNS records will need to be created to point to the cluster. For a one-node cluster, we schedule and launch one router, and deis-router and deis-controller will run on the same host. So, the DNS record specified below can be configured to point to this one machine.

If you do not modify your DNS settings on EC2 but still want to register a user, try using xip.io:

.. code-block:: console
$ deis register deis.ec2-12-345-678-90.us-west-1.compute.amazonaws.com.xip.io
On a multi-node cluster, however, there are probably multiple routers, and the controller will likely be scheduled on a separate machine. As mentioned in :ref:`configure-load-balancers`, a load balancer is recommended in this scenario.

Note that the controller will eventually live behind the routers so that all external traffic will flow through the load balancer - configuring a DNS record which points to a service whose IP could change is less than ideal.
Expand All @@ -31,3 +25,13 @@ Deis requires one wildcard DNS record. Assuming ``myapps.com`` is the top-level
Apps can then be accessed via ``appname.myapps.com``, and the Deis controller can be accessed at ``deis.myapps.com``.

This record is necessary for all deployments of Deis (EC2, Rackspace, bare metal, etc.). Local clusters can use the domain ``local.deisapp.com``, ``local3.deisapp.com``, or ``local5.deiaspp.com``.

Using xip.io
------------
An alternative to configuring your own DNS records is to use `xip`_. For example, for EC2:

.. code-block:: console
$ deis register http://deis.deis-DeisWebELB-8N30OETT0HOK-2005743466.us-west-2.elb.amazonaws.com.xip.io
.. _`xip`: http://xip.io/

0 comments on commit d791866

Please sign in to comment.