Skip to content

Latest commit

 

History

History
45 lines (34 loc) · 3.77 KB

README.md

File metadata and controls

45 lines (34 loc) · 3.77 KB
Raw

rancher-vagrant

Extensible and automated local Rancher environments using Vagrant

Usage

git clone https://github.com/nextrevision/rancher-vagrant
cd rancher-vagrant
vagrant up

Assuming the defaults, browse to http://192.168.33.11:8080 to access your Rancher server.

Configuration

You can configure the environment by setting up a custom config.rb file in the root of the repository. The available configuration options to you are displayed below:

Item Type Required Default Description
$box string false rancherio/rancheros Vagrant box to use for the environment
$box_url string false nil URL to download the box
$box_version string false nil Version of the box to download
$disable_folder_sync bool false true Disable syncing the current working directory to "/vagrant" on the guest
$ip_prefix string false 192.168.33 Prefix for all IPs assigned to the guests
$rancher_version string false latest Version of Rancher to deploy
$boxes array true [] List of boxes (see Boxes table below)

Boxes

Item Type Required Default Description
name string true Base name of the box
count string false 1 Number of guests to create with this config
role string false agent Role of the box (either "server" or "agent", at least one "server" must be specified)
memory string false 512 Amount of memory to dedicate to the box (for RancherOS, at least 512 is recommended)
ip string false IP address to assign to the box (typically best to leave this alone)
install_agent bool false true if role==agent, false if role==server Whether or not to run the Rancher agent on the guest
project string false nil Name of the Rancher project or environment to place the box in
project_type string false cattle Type of project to for the Rancher environment (cattle, swarm, kubernetes)
server string false Hostname or IP address of the Rancher server to join

Example

See config_sample.rb