Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

A Vagrant-based Salt development environment for creating new modules

branch: master

Switch salt-master metaparameter from 'notify' to 'before'

This is a weird behavior I've seen with Puppet where 'notify' doesn't
alway handle the current state of services as expected. Ideally the
salt-master daemon should be notified to restart whenever there are
config file changes, however that doesn't work with the initial setup in
this case, so we're stuck using 'before' instead.
latest commit 86445fe7c3
Aaron Bull Schaefer authored
Octocat-spinner-32 base Only apply helloworld to master server March 29, 2012
Octocat-spinner-32 provision Switch salt-master metaparameter from 'notify' to 'before' March 29, 2012
Octocat-spinner-32 .gitignore Ignore future changes under the base directory March 28, 2012
Octocat-spinner-32 LICENSE Initial clone of puppet-sandbox repository March 26, 2012
Octocat-spinner-32 README.md Add initial content to the README March 28, 2012
Octocat-spinner-32 TODO Copy basic TODO items from Puppet Sandbox March 28, 2012
Octocat-spinner-32 Vagrantfile Move subnet to not conflict with Puppet Sandbox March 28, 2012
README.md

Description

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.

Requirements

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.

Usage

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/

Initial Startup

To bring up the Salt Sandbox environment, issue the following command:

$ vagrant up

The following tasks will be handled automatically:

  1. The Salt master daemon will be installed and enabled on the master machine.
  2. The Salt minion daemon will be installed and enabled on all three machines.
  3. A host-only network will be set up with all machines knowing how to communicate with each other.
  4. All minion public keys will be automatically accepted by the master server.
  5. The master server will utilize the top.sls file and 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 Vagrantfile and reload the machines:

$ vim Vagrantfile
$ vagrant reload

Developing New Modules

To start developing a new SLS module, just create the standard module structure under 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 the top.sls file and specify how it should be used during state execution...that's it!

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 (master, minion1, or minion2):

$ vagrant ssh master

Then instruct all minions to execute a highstate call and apply any applicable modules:

[vagrant@master ~]$ sudo salt '*' state.highstate

License

Salt Sandbox is provided under the terms of The MIT License.

Copyright © 2012, Aaron Bull Schaefer.

Something went wrong with that request. Please try again.