Salt/rsyncd-formula

Go to file

Martin Hoefling a4cd959337 Improve docs for rsyncd state		2015-05-15 23:04:16 +02:00
rsyncd	Added Arch linux support	2015-05-15 00:22:16 +02:00
test/pillar	Removed unused file	2015-05-15 02:17:21 +02:00
.travis.yml	Enable salt debug log in travis	2015-05-15 17:46:58 +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	Improve docs for rsyncd state	2015-05-15 23:04:16 +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.show_highstate --local --retcode-passthrough --config-dir=test/etc