Rancher Drone CI/CD Development Environment

Automated local Rancher environments using Vagrant

Install

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

If you used the defaults, browse to http://10.0.0.11:8080 to access the installed Rancher server.

Configuration

You can configure the vagrant environment by customizing config.rb. The available configuration options are:

Item	Type	Required	Default	Description
$os	string	false	coreos-alpha	Vagrant box to use for the environment
$os_url	string	false	Link	URL to download the box
$os_version	string	false	>= 1548.0.0	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	10.0.0	Prefix for all IPs assigned to the guests
$rancher_version	string	false	latest	Version of Rancher to deploy
$proxies	array	false	[]	Proxies to set in boxes (see Proxies table below)
$boxes	array	true	[]	List of boxes (see Boxes table below)

Proxies

Item	Type	Required	Default	Description
http	string	false	nil	URL or IP of the proxy to use
https	string	false	nil	URL or IP of the proxy to use
no_proxy	string	false	nil	URLs or IPs of the proxy exclusions, comma separated

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.rb or use:

# Official CoreOS channel. Either alpha, beta or stable
$update_channel = "alpha"

# Vagrant box configuration details image of the os to use
$os = "coreos-%s" % $update_channel

# Version of the box image
$os_version = '>= 1548.0.0'

# URL to pull CoreOS image from
$os_url = "http://%s.release.core-os.net/amd64-usr/current/coreos_production_vagrant.json" % $update_channel

# Tag of the rancher/server image to run
$rancher_version = 'latest'

# IP prefix to use when assigning box ip addresses
$ip_prefix = '10.0.0'

# Enable syncing of the current directory to the /vagrant path on the guest
$disable_folder_sync = false

# Proxy configure on boxes, defaults to none if not defined
#$proxies = {
#  "http" => "http://<ip or url>:<port>/",
#  "https" => "https://<ip or url>:<port>/",
#  "no_proxy" => "localhost,127.0.0.1,<ip or url>"
#}

# Boxes to create in the vagrant environment
$boxes = [
    {
      "name"   => "rancher-server",
      "role"   => "server",
      "memory" => "1536",
      "labels" => [],
    },
    {
      "name"   => "rancher-nodes",
      "count"  => 4,
      "memory" => "512",
      "labels" => []
    },
    {
      "name"   => "k8s-nodes",
      "count"  => 4,
      "memory" => "512",
      "labels" => [],
      "project" => "k8s",
      "project_type" => "kubernetes"
    },
]