github.com/misfo/deis@v1.0.1-0.20141111224634-e0eee0392b8a/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  
    13  Install Prerequisites
    14  ---------------------
    15  
    16  Please install `Vagrant`_ v1.6.5+ and `VirtualBox`_.
    17  
    18  .. note::
    19  
    20      For Ubuntu users: the VirtualBox package in Ubuntu has some issues when running in
    21      RAM-constrained environments. Please install the latest version of VirtualBox from Oracle's
    22      website.
    23  
    24  
    25  Generate SSH Key
    26  ----------------
    27  
    28  Please refer to :ref:`generate_ssh_key` for generating a new SSH key.
    29  
    30  
    31  Generate a New Discovery URL
    32  ----------------------------
    33  
    34  Please refer to :ref:`generate_discovery_url` for generating a new Discovery URL.
    35  
    36  
    37  Boot CoreOS
    38  -----------
    39  
    40  Start the CoreOS cluster on VirtualBox. From a command prompt, switch directories to the root of
    41  the Deis project and type:
    42  
    43  .. code-block:: console
    44  
    45      $ vagrant up
    46  
    47  This instructs Vagrant to spin up 3 VMs. To be able to connect to the VMs, you must add your
    48  Vagrant-generated SSH key to the ssh-agent (``deisctl`` requires the agent to have this key):
    49  
    50  .. code-block:: console
    51  
    52      $ ssh-add ~/.vagrant.d/insecure_private_key
    53  
    54  
    55  Configure DNS
    56  -------------
    57  
    58  For convenience, we have set up a few DNS records for users running on Vagrant.
    59  ``local3.deisapp.com`` is set up for 3-node clusters and ``local5.deisapp.com`` is set up for
    60  5-node clusters. If you want to set up your own DNS records, see :ref:`configure-dns` for more
    61  information.
    62  
    63  
    64  Install Deis Platform
    65  ---------------------
    66  
    67  Now that you've finished provisioning a cluster, please refer to :ref:`install_deis_platform` to
    68  start installing the platform.
    69  
    70  
    71  .. _Vagrant: http://www.vagrantup.com/
    72  .. _VirtualBox: https://www.virtualbox.org/wiki/Downloads