github.com/mgood/deis@v1.0.2-0.20141120022609-9a185b756e7d/docs/installing_deis/vagrant.rst (about)

     1  :title: Installing Deis on Vagrant
     2  :description: How to provision a multi-node Deis cluster on Vagrant
     3  
     4  .. _deis_on_vagrant:
     5  
     6  Vagrant
     7  =======
     8  
     9  `Vagrant`_ is a tool for building complete development environments with a focus on automation.
    10  This guide demonstrates how you can stand up a Deis cluster for development purposes using Vagrant.
    11  
    12  Please :ref:`get the source <get_the_source>` and refer to the ``Vagrantfile``
    13  while following this documentation.
    14  
    15  
    16  Install Prerequisites
    17  ---------------------
    18  
    19  Please install `Vagrant`_ v1.6.5+ and `VirtualBox`_.
    20  
    21  .. note::
    22  
    23      For Ubuntu users: the VirtualBox package in Ubuntu has some issues when running in
    24      RAM-constrained environments. Please install the latest version of VirtualBox from Oracle's
    25      website.
    26  
    27  
    28  Generate SSH Key
    29  ----------------
    30  
    31  .. include:: ../_includes/_generate-ssh-key.rst
    32  
    33  
    34  Generate a New Discovery URL
    35  ----------------------------
    36  
    37  .. include:: ../_includes/_generate-discovery-url.rst
    38  
    39  
    40  Boot CoreOS
    41  -----------
    42  
    43  Start the CoreOS cluster on VirtualBox. From a command prompt, switch directories to the root of
    44  the Deis project and type:
    45  
    46  .. code-block:: console
    47  
    48      $ vagrant up
    49  
    50  This instructs Vagrant to spin up 3 VMs. To be able to connect to the VMs, you must add your
    51  Vagrant-generated SSH key to the ssh-agent (``deisctl`` requires the agent to have this key):
    52  
    53  .. code-block:: console
    54  
    55      $ ssh-add ~/.vagrant.d/insecure_private_key
    56  
    57  
    58  Configure DNS
    59  -------------
    60  
    61  For convenience, we have set up a few DNS records for users running on Vagrant.
    62  ``local3.deisapp.com`` is set up for 3-node clusters and ``local5.deisapp.com`` is set up for
    63  5-node clusters. If you want to set up your own DNS records, see :ref:`configure-dns` for more
    64  information.
    65  
    66  
    67  Install Deis Platform
    68  ---------------------
    69  
    70  Now that you've finished provisioning a cluster, please refer to :ref:`install_deis_platform` to
    71  start installing the platform.
    72  
    73  
    74  .. _Vagrant: http://www.vagrantup.com/
    75  .. _VirtualBox: https://www.virtualbox.org/wiki/Downloads