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.

To install Shaker use pip.

$ pip install saltshaker

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.

When configuration is done you can start Shaker.

$ shaker

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

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

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.

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

Git repository url to download and use as a source.

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.