Salt/rsyncd-formula

Go to file

jpic afe38803fb Removed a leftover from previous test procedure		2015-05-17 12:06:57 +02:00
rsyncd	Create rsyncd.conf if not present	2015-05-15 23:16:45 +02:00
test/pillar	Removed unused file	2015-05-15 02:17:21 +02:00
.travis.yml	Removed a leftover from previous test procedure	2015-05-17 12:06:57 +02:00
CHANGELOG.rst	Initial commit	2015-05-03 00:34:43 +02:00
LICENSE	Initial commit	2015-05-03 00:34:43 +02:00
README.rst	Old command was in README [ci skip]	2015-05-17 11:54:14 +02:00
pillar.example	Initial commit	2015-05-03 00:34:43 +02:00

README.rst

.. image:: https://travis-ci.org/martinhoefling/rsyncd-formula.svg?branch=master
    :target: https://travis-ci.org/martinhoefling/rsyncd-formula

================
rsyncd-formula
================

A formula to install and configure rsync as daemon process.

.. note::

    See the full `Salt Formulas installation and usage instructions
    <http://docs.saltstack.com/en/latest/topics/development/conventions/formulas.html>`_.

Available states
================

.. contents::
    :local:

``rsyncd``
------------

Installs the rsync package, and starts the rsyncd service. Note: The rsyncd.conf has to be created manually / via another state. If the state of the config should also be managed via salt, the rsyncd.config state (which pulls rsyncd) should be used instead.

``rsyncd.config``
------------

Configure the rsync daemon by writing an rsync.conf and rsync secrets (optional).

Testing
=======

As you can read in .travis.yml, testing is a matter of symlinking this
directory to /srv/formula (because we can't use relative paths in file_roots /
pillar_roots) and running::

  salt-call state.sls rsyncd --local --retcode-passthrough --file-root=/srv/formula --pillar-root=test/pillar