salt.modules.rsync

Wrapper for rsync

New in version 2014.1.0.

This data can also be passed into pillar. Options passed into opts will overwrite options passed into pillar.

salt.modules.rsync.config(conf_path='/etc/rsyncd.conf')

Changed in version 2016.3.0: Return data now contains just the contents of the rsyncd.conf as a string, instead of a dictionary as returned from cmd.run_all.

Returns the contents of the rsync config file

conf_path/etc/rsyncd.conf

Path to the config file

CLI Example:

salt '*' rsync.config
salt.modules.rsync.rsync(src, dst, delete=False, force=False, update=False, passwordfile=None, exclude=None, excludefrom=None, dryrun=False, rsh=None, additional_opts=None, saltenv='base')

Changed in version 2016.3.0: Return data now contains just the output of the rsync command, instead of a dictionary as returned from cmd.run_all.

Rsync files from src to dst

src

The source location where files will be rsynced from.

dst

The destination location where files will be rsynced to.

deleteFalse

Whether to enable the rsync --delete flag, which will delete extraneous files from dest dirs

forceFalse

Whether to enable the rsync --force flag, which will force deletion of dirs even if not empty.

updateFalse

Whether to enable the rsync --update flag, which forces rsync to skip any files which exist on the destination and have a modified time that is newer than the source file.

passwordfile

A file that contains a password for accessing an rsync daemon. The file should contain just the password.

exclude

Whether to enable the rsync --exclude flag, which will exclude files matching a PATTERN.

excludefrom

Whether to enable the rsync --excludefrom flag, which will read exclude patterns from a file.

dryrunFalse

Whether to enable the rsync --dry-run flag, which will perform a trial run with no changes made.

rsh

Whether to enable the rsync --rsh flag, to specify the remote shell to use.

additional_opts

Any additional rsync options, should be specified as a list.

saltenv

Specify a salt fileserver environment to be used.

CLI Example:

salt '*' rsync.rsync /path/to/src /path/to/dest delete=True update=True passwordfile=/etc/pass.crt exclude=exclude/dir
salt '*' rsync.rsync /path/to/src delete=True excludefrom=/xx.ini
salt '*' rsync.rsync /path/to/src delete=True exclude='[exclude1/dir,exclude2/dir]' additional_opts='["--partial", "--bwlimit=5000"]'
salt.modules.rsync.version()

Changed in version 2016.3.0: Return data now contains just the version number as a string, instead of a dictionary as returned from cmd.run_all.

Returns rsync version

CLI Example:

salt '*' rsync.version