Skip to content

CashStar/salt-contrib

 
 

Repository files navigation

Salt Contrib

CashStar Notes

ln -s /srv/salt-contrib/grains /srv/salt/_grains

These Ubuntu packages are required: apt install python-boto facter

These IAM permissions are required (and probably more): ec2:DescribeInstances ec2:DescribeTags

Fixes have been made to work with modern versions of Salt, and to work with IAM Roles.

Introduction

The Salt Contrib is a destination for modules developed by the community. Since Salt modules are nearly infinite in application not all of the modules developed will be shipped with the main salt application. Salt Contrib will hold modules that can be cleanly added to any of the modular components of Salt. This will also act as a gateway for new module development, generally it will be asked that pull requests for new modules be made against the salt-contrib git repo.

Development

https://travis-ci.org/tf198/salt-contrib.png?branch=develop

You can symlink your salt-contrib against a development environment and run the tests against it.

All relevant files will be symlinked to the appropriate location in the target environment, so you can modify linked files and test without having to copy files back and forward. Running salt-contrib/link_contrib.py salt -u will remove all links leaving the salt repo clean.

The contrib.tests target runs only the tests from salt-contrib. A travis config is also included which will run the contrib tests if you enable it.

$ git clone git://github.com/saltstack/salt.git
$ git clone [email protected]:<me>/salt-contrib.git

$ salt-contrib/link_contrib.py salt

$ salt/tests/runtests.py -n contrib.tests -v

You can also link against a state folder so the modules are pushed out to clients via _modules, _states etc

$ salt-contrib/link_contrib.py /srv/salt

For grains, simply make a _grains folder in /srv/salt. Then run sync_grains.

$ saltutil.sync_grains

Releases

No releases published

Packages

No packages published

Languages

  • Python 99.6%
  • Other 0.4%