Skip to content

Latest commit

 

History

History
85 lines (56 loc) · 3.02 KB

vagrant.md

File metadata and controls

85 lines (56 loc) · 3.02 KB
Raw

Getting started on Vagrant

Running Apollo with Vagrant (and Virtualbox) is an easy way to run/test/develop on your local machine (Linux, Mac, OS X)

Prerequisites

  1. The latest version of vagrant installed (>= 1.7.2) http://www.vagrantup.com/downloads.html to get started
  2. The latest version of Virtualbox from https://www.virtualbox.org/wiki/Downloads
  3. You need to have Python >= 2.7.5 installed along with pip. _Note: python 3 will not work with ansible
  4. Install vagrant hostmanager plugin
vagrant plugin install vagrant-hostmanager

### Cluster Turnup

#### Download Apollo

Install from source at head
  1. git clone https://github.com/Capgemini/Apollo.git
  2. cd Apollo
  3. pip install -r requirements.txt

Note: you may need to run the pip command with Admin privileges (e.g. sudo ... if you're on a *nix machine).

Turn up the cluster

export APOLLO_PROVIDER=vagrant
/bin/bash bootstrap/apollo-launch.sh

Running the cluster in standalone mode

export APOLLO_PROVIDER=vagrant
export VAGRANT_VAGRANTFILE=Vagrantfile-standalone
/bin/bash bootstrap/apollo-launch.sh

Note: remember to remove VAGRANT_VAGRANTFILE variable if you want run the cluster in default mode.

unset VAGRANT_VAGRANTFILE

Note: When using vagrant-hosts plugin, you will either have to run the above command as sudo or have your hosts file writeable for the user running the command.

Vagrant will set up a 3 node mesos-master cluster and 1 mesos-agent. By default the master nodes will each take up 256MB and 1 CPU. The agent will take 1024MB and 2 CPUs.

By default the web interfaces should be available on -

Mesos / Marathon should handle redirection the the leader node automatically via Zookeeper.

To tweak these settings you may modify vagrant.yml

#### Tearing down the cluster

/bin/bash bootstrap/apollo-down.sh

Interacting with your Apollo cluster with Vagrant

You can interact with your Apollo cluster via the normal vagrant commands - vagrant up vagrant halt vagrant destroy etc...

Adding more agent machines

Edit vagrant.yml

Add a new ip under agents.ips: following the ip´s convention (i.e. 172.31.1.15).

Configuration for standalone mode

To change resources for standalone mode edit vagrant-standalone.yml file.

Using Apollo Behind a Firewall

Edit groups_vars/all

Change all the proxy_env variables to the proxy hostname e.g. http://10.99.11.11:9090

N.b. your host system also needs to have settings for HTTP and HTTPS proxies set at the commandline. E.g. on MacOS, export http_proxy=10.99.11.11:9090; export https_proxy=10.99.11.11:9090; export HTTP_PROXY=10.99.11.11:9090; export HTTPS_PROXY=10.99.11.11:9090