https://github.com/vmware-archive/salt-contrib

Salt Module Contributions
https://github.com/vmware-archive/salt-contrib

Last synced: about 2 months ago
JSON representation

Salt Module Contributions

• Host: GitHub
• URL: https://github.com/vmware-archive/salt-contrib
• Owner: vmware-archive
• License: other
• Archived: true
• Created: 2011-11-21T05:24:03.000Z (about 13 years ago)
• Default Branch: master
• Last Pushed: 2020-12-01T21:30:17.000Z (about 4 years ago)
• Last Synced: 2024-05-21T13:02:50.820Z (7 months ago)
• Language: Python
• Homepage: http://saltstack.org
• Size: 652 KB
• Stars: 169
• Watchers: 61
• Forks: 172
• Open Issues: 30
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
============

Salt Contrib

============

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

===========

.. image:: 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]:/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