github.com/rvaralda/deis@v1.4.1/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  The ``Vagrantfile`` requires the plugin `vagrant-triggers`_. To install the plugin run:
    22  
    23  .. code-block:: console
    24  
    25      $ vagrant plugin install vagrant-triggers
    26  
    27  .. note::
    28  
    29      For Ubuntu users: the VirtualBox package in Ubuntu has some issues when running in
    30      RAM-constrained environments. Please install the latest version of VirtualBox from Oracle's
    31      website.
    32  
    33  
    34  Generate SSH Key
    35  ----------------
    36  
    37  .. include:: ../_includes/_generate-ssh-key.rst
    38  
    39  
    40  Generate a New Discovery URL
    41  ----------------------------
    42  
    43  .. include:: ../_includes/_generate-discovery-url.rst
    44  
    45  
    46  Boot CoreOS
    47  -----------
    48  
    49  Start the CoreOS cluster on VirtualBox. From a command prompt, switch directories to the root of
    50  the Deis project and type:
    51  
    52  .. code-block:: console
    53  
    54      $ vagrant up
    55  
    56  This instructs Vagrant to spin up 3 VMs. To be able to connect to the VMs, you must add your
    57  Vagrant-generated SSH key to the ssh-agent (``deisctl`` requires the agent to have this key):
    58  
    59  .. code-block:: console
    60  
    61      $ ssh-add ~/.vagrant.d/insecure_private_key
    62  
    63  
    64  Configure DNS
    65  -------------
    66  
    67  For convenience, we have set up a few DNS records for users running on Vagrant.
    68  ``local3.deisapp.com`` is set up for 3-node clusters and ``local5.deisapp.com`` is set up for
    69  5-node clusters.
    70  
    71  Since ``local3.deisapp.com`` is your cluster domain, use ``local3.deisapp.com`` anywhere you see
    72  ``example.com`` in the documentation.
    73  
    74  It is not necessary to configure DNS for Vagrant clusters, but it is possible - if you want to set up
    75  your own DNS records, see :ref:`configure-dns` for more information.
    76  
    77  
    78  Install Deis Platform
    79  ---------------------
    80  
    81  Now that you've finished provisioning a cluster, please refer to :ref:`install_deis_platform` to
    82  start installing the platform.
    83  
    84  
    85  .. _Vagrant: http://www.vagrantup.com/
    86  .. _VirtualBox: https://www.virtualbox.org/wiki/Downloads
    87  .. _vagrant-triggers: https://github.com/emyl/vagrant-triggers