Salt Sandbox is a multi-VM Vagrant-based Salt development environment used for creating and testing new Salt state modules outside of your production environment. It's also a great way to learn firsthand about Salt and its remote execution capabilities.
Salt Sandbox will set up three separate virtual machines:
- salt.example.com - the Salt master server
- minion1.example.com - the first Salt minion machine
- minion2.example.com - the second Salt minion machine
These VMs can be used in conjunction to segregate and test your modules based on node groups, top file environments, grain values, etc. You can even test modules on different Linux distributions or release versions to better match your production infrastructure.
To use Salt Sandbox, you must have the following items installed and working:
Salt Sandbox has been designed for and tested with Vagrant base boxes running:
- CentOS 5.7
- Ubuntu 10.04 - Lucid Lynx
...although it may work just fine with other distributions/versions.
Make sure you have a compatible Vagrant base box (if you don't have one already, it will download a 64-bit CentOS 5.7 box for you), and then you should be good to clone this repo and go:
$ vagrant box list centos57 $ git clone git://github.com/elasticdog/salt-sandbox.git $ cd salt-sandbox/
To bring up the Salt Sandbox environment, issue the following command:
$ vagrant up
The following tasks will be handled automatically:
- The Salt master daemon will be installed and enabled on the master machine.
- The Salt minion daemon will be installed and enabled on all three machines.
- A host-only network will be set up with all machines knowing how to communicate with each other.
- All minion public keys will be automatically accepted by the master server.
- The master server will utilize the
base/directory that exist outside of the VMs (in your salt-sandbox Git working directory) by utilizing VirtualBox's shared folder feature.
All of this is handled using Vagrant's provisioning capabilities and is
controlled by the manifests under the
provision/ directory. In theory, you
should never have to touch any of that code directly unless you're working to
improve Salt Sandbox.
If you wish to change the domain name of the VMs (it defaults to
example.com), edit the "domain" variable at the top of
reload the machines:
$ vim Vagrantfile $ vagrant reload
Developing New Modules
To start developing a new SLS module, just create the standard module structure
base/ in your salt-sandbox Git working directory (an example
"helloworld" module should exist there already). This directory is
automatically in the Salt master server's file_roots path, and any changes
will be picked up immediately.
$ mkdir -p base/mymodule $ vim base/mymodule/init.sls
To have your module actually applied to one or more of the minions, edit
top.sls file and specify how it should be used during state
Check Your Handiwork
To log on to the virtual machines and see the result of your Salt modules, just
use standard Vagrant Multi-VM Environment
commands, and provide the proper VM name (
$ vagrant ssh master
Then instruct all minions to execute a highstate call and apply any applicable modules:
[vagrant@master ~]$ sudo salt '*' state.highstate
Salt Sandbox is provided under the terms of The MIT License.
Copyright © 2012, Aaron Bull Schaefer.