rancher/vagrant

Name: vagrant

Owner: Rancher

Description: Vagrant file to stand up a Local Rancher install with 3 nodes

Created: 2017-03-09 09:37:39.0

Updated: 2018-05-18 05:13:19.0

Pushed: 2018-04-25 10:17:13.0

Homepage:

Size: 227

Language: Shell

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

localranchervagrant

Pretty Picture

Vagrant files to stand up a Local Rancher install with 3 nodes

This runs RancherOS as the base OS for the nodes which doesn't have the guest tools for Virtualbox installed

Start the cluster and the Rancher UI will become accessible on http://172.22.101.100

To see the contents of the registry cache proxy, navigate to http://172.22.101.100:5000/v2/_catalog

The default file will bring up a cattle environment. You can change this by editing orchestrator in the config file.

Usage

To use this you must have vagrant installed, which can be obtained from www.vagrantup.com

clone the directory and then run vagrant up

This has been tested with vagrant 1.9.1 and VirtualBox 5.0.32. If you experience issues with the networking it is likely related to running an older version.

Config

The config.yml contains any variables that you should need to change, below is a description of the variables and their values:

orchestrator - Possible values are cattle, kubernetes, mesos and swarm

This sets the orchestrator that will be used for the environment, as part of the process the Default environment is deleted and we create a new one with the name of the orchestrator.

network_mode - Possible values are isolated, airgap and normal

isolated set the Rancher Server and Rancher nodes to have no external internet access other than via a proxy server that runs on the master node. This is used to emulate environments where a proxy server is required to access the internet

airgap sets the Rancher Server and nodes to have no external access at all. All images required to stand up Rancher are downloaded to a private repo on master and pulled from there

sslenabled - Possible values are true and false

This uses a pre-generated certificate to terminate the connection to the Rancher server with SSL. This certificate is located in the /certs folder. If this is changed then the public key will need to be replaced in the configure_rancher_node.sh script otherwise the agent will error.

ssldns - Default value is server.rancher.vagrant

The setting for this needs to match the string that is stored in the SSL certificate that is used for termination.

version - Possible values latest, stable, v1.x.x where x.x is any release of Rancher Server

This is the version of Rancher Server that you want to be deployed into your environment

rancher_env_vars - Pass through additional environment variables to the Rancher server

agent_version - The version of the Rancher agent for the nodes to pull

ROS_version - The version of RancherOS for the nodes to run, possible values are 1.0.3 and 1.0.4

master - Settings for the master node that runs the proxy, registry mirror etc., this value should not be changed

server - Settings for the server node(s) that runs the Rancher Server, this value should not be changed

node - Settings for the rancher node(s) that run in the Rancher environment, this value should not be changed

ip - This section defines the IP address ranges for the virtual machines

linked_clones - Default value true Leave as this as it reduces disk footprint

net - Network Settings section, this should not be changed

If you want to expose the Virtual Machines directly to the network this can be set to public_network

keys - Subsection for defining keys to be used when enabling external_ssh. The public key will be placed onto all servers, the private key will be placed onto just the master node. You can then use the master node as a jump host to each of the remaining VM's, or access them directly with the ssh key

external_access - To expose the setup to an external network

Troubleshooting

VM's starting but not running any scripts - Try changing the private_nic_type


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.