Skip to content

vagrant.rst

Latest commit

 

History

History
72 lines (42 loc) · 1.89 KB

vagrant.rst

File metadata and controls

72 lines (42 loc) · 1.89 KB
title:Installing Deis on Vagrant
description:How to provision a multi-node Deis cluster on Vagrant

Vagrant

Vagrant is a tool for building complete development environments with a focus on automation. This guide demonstrates how you can stand up a Deis cluster for development purposes using Vagrant.

Install Prerequisites

Please install Vagrant v1.6.5+ and VirtualBox.

Note

For Ubuntu users: the VirtualBox package in Ubuntu has some issues when running in RAM-constrained environments. Please install the latest version of VirtualBox from Oracle's website.

Generate SSH Key

Please refer to :ref:`generate_ssh_key` for generating a new SSH key.

Generate a New Discovery URL

Please refer to :ref:`generate_discovery_url` for generating a new Discovery URL.

Boot CoreOS

Start the CoreOS cluster on VirtualBox. From a command prompt, switch directories to the root of the Deis project and type:

$ vagrant up

This instructs Vagrant to spin up 3 VMs. To be able to connect to the VMs, you must add your Vagrant-generated SSH key to the ssh-agent (deisctl requires the agent to have this key):

$ ssh-add ~/.vagrant.d/insecure_private_key

Configure DNS

For convenience, we have set up a few DNS records for users running on Vagrant. local3.deisapp.com is set up for 3-node clusters and local5.deisapp.com is set up for 5-node clusters. If you want to set up your own DNS records, see :ref:`configure-dns` for more information.

Install Deis Platform

Now that you've finished provisioning a cluster, please refer to :ref:`install_deis_platform` to start installing the platform.