SaltShaker

Development environment provisioning with Salt made easy. Just Shaker it!

Shaker is developed with Python and aims to be simple and fast to start using. Shaker uses Salt to provision your workstation. It reads salt formules from an Git repository (or from local directories).

Currently, this project is in active development mode, so if you would like to have a new feature, feel free to open an issue. You are welcome to contribute to the project.

Installation

To install Shaker use pip.

$ pip install saltshaker

Usage

Creating a config file

Shaker init command can be used to start a new configuration file.

$ shaker init

A configuration file will be created at $HOME/.shaker/config.yml.

Running Shaker

When configuration is done you can start Shaker.

$ shaker

Shaker will read the configuration from $HOME/.shaker/config.yml and start provisioning the machine.

Configuration

Shaker configuration files are simple YAML files. The configuration tells Shaker where to find salt formules to use.

sources:
  local:
    - /home/diegotoral/salt/formules
    - /tmp/formules
  git: https://github.com/diegotoral/saltshaker-formules

top:
  base:
    - rvm
    - vim

Configuration Options

sources

By default Shaker looks for salt formules at $HOME/.shaker/formules. The sources option allows you to specify other places where Shaker may find formules.

local

Directories where to look for salt formules on the local filesystem.

git

Git repository url to download and use as a source.

top

Allows you to override the top.sls file from the sources. The top parameter and top.sls are merged and the resulting configuration is executed.