rsync: install rsync package and create rsync::put/get instancesrsync::server: The rsync server. Supports both standard rsync as well as rsync over ssh
rsync::get: get files via rsync ussing execrsync::put: put files via rsync ussing execrsync::server::module: Definition: rsync::server::module sets up a rsync server
install rsync package and create rsync::put/get instances
class { 'rsync':
package_ensure => 'latest'
}The following parameters are available in the rsync class:
Data type: String
ensure parameter for package-resource
Default value: 'installed'
Data type: Boolean
whether to manage the package-resource
Default value: true
Data type: Hash
rsync::put instances to create
Default value: {}
Data type: Hash
rsync::get instances to create
Default value: {}
The rsync server. Supports both standard rsync as well as rsync over ssh
The following parameters are available in the rsync::server class:
Data type: Boolean
wether to run in xinetd or standaloie
Default value: true
Data type: String
adress to listen to
Default value: '0.0.0.0'
Data type: Boolean
witch for rsync config option "use chrot"
Default value: true
Data type: String
uid to run the deamon as
Default value: 'nobody'
Data type: String
gid to run the deamon as
Default value: 'nobody'
Data type: String
tcp port to listen to
Default value: '873'
Data type: Hash
hash of rsync::server::module resources to create
Default value: {}
Data type: String
syslog facitlity to set for logging
Default value: 'local3'
get files via rsync ussing exec
rsync::get { '/foo':
source => "rsync://${rsync_server}/repo/foo/",
require => File['/foo'],
}The following parameters are available in the rsync::get defined type:
Data type: String
source to copy from
Data type: String
path to copy to
Default value: $name
Data type: Optional[String]
username on remote system
Default value: undef
Data type: String
path to ssh key used to connect to remote host
Default value: "/home/${user}/.ssh/id_rsa"
Data type: String
timeout in seconds
Default value: '900'
Data type: String
user to run the command (passed to exec)
Default value: 'root'
Data type: String
commandline options to pass to rsync (-a)
Default value: '-a'
Data type: Optional[String]
Condition to run the rsync command
Default value: undef
put files via rsync ussing exec
rsync::put { '${rsyncDestHost}:/repo/foo':
user => 'user',
source => "/repo/foo/",
}The following parameters are available in the rsync::put defined type:
Data type: String
source to copy from
Data type: Optional[String]
path to copy to
Default value: undef
Data type: Optional[String]
username on remote system
Default value: undef
Data type: String
path to ssh key used to connect to remote host
Default value: "/home/${user}/.ssh/id_rsa"
Data type: String
timeout in seconds
Default value: '900'
Data type: String
commandline options to pass to rsync (-a)
Default value: '-a'
Definition: rsync::server::module
sets up a rsync server
rsync::server::module { 'repo':
path => $base,
require => File[$base],
}The following parameters are available in the rsync::server::module defined type:
pathcommentread_onlywrite_onlyuse_chrootlistuidgidincoming_chmodoutgoing_chmodmax_connectionslock_filesecrets_fileauth_usershosts_allowhosts_denytransfer_logginglog_formatrefuse_optionslog_filedont_compressorderexcludepre_xfer_execpost_xfer_execignore_nonreadablereverse_lookup
Data type: String
path to data
Data type: Optional[String]
rsync comment
Default value: undef
Data type: Boolean
yes||no, defaults to yes
Default value: true
Data type: Boolean
yes||no, defaults to no
Default value: false
Data type: Boolean
yes|no, defaults to undef
Default value: true
Data type: Boolean
yes||no, defaults to yes
Default value: true
Data type: String
uid of rsync server, defaults to 0
Default value: '0'
Data type: String
gid of rsync server, defaults to 0
Default value: '0'
Data type: Variant[Boolean,String]
incoming file mode, defaults to 0644
Default value: '0644'
Data type: Variant[Boolean,String]
outgoing file mode, defaults to 0644
Default value: '0644'
Data type: Variant[Integer,String]
maximum number of simultaneous connections allowed, defaults to 0
Default value: '0'
Data type: String
file used to support the max connections parameter, defaults to /var/run/rsyncd.lock only needed if max_connections > 0
Default value: '/var/run/rsyncd.lock'
Data type: Optional[String]
path to the file that contains the username:password pairs used for authenticating this module
Default value: undef
Data type: Optional[Array]
list of usernames that will be allowed to connect to this module
Default value: undef
Data type: Optional[Array]
list of patterns allowed to connect to this module (man 5 rsyncd.conf for details)
Default value: undef
Data type: Optional[Array]
list of patterns allowed to connect to this module (man 5 rsyncd.conf for details)
Default value: undef
Data type: Boolean
parameter enables per-file logging of downloads and uploads in a format somewhat similar to that used by ftp daemons.
Default value: false
Data type: Optional[String]
This parameter allows you to specify the format used for logging file transfers when transfer logging is enabled. See the rsyncd.conf documentation for more details.
Default value: undef
Data type: Optional[Array]
list of rsync command line options that will be refused by your rsync daemon.
Default value: undef
Data type: Optional[String]
log messages to the indicated file rather than using syslog
Default value: undef
Data type: Optional[Array[String]]
wildcard patterns that should not be compressed when pulling files from the daemon
Default value: undef
Data type: String
concat::fragment order
Default value: '10'
Data type: Optional[Array]
space-separated list of daemon exclude patterns.
Default value: undef
Data type: Optional[String]
command to be run before and/or after the transfer.
Default value: undef
Data type: Optional[String]
command to be run before and/or after the transfer.
Default value: undef
Data type: Boolean
Default value: false
Data type: Boolean
Controls whether the daemon performs a reverse lookup on the client’s IP address to determine its hostname, which is used for "hosts allow"/"hosts deny" checks and the "%h" log escape.
Default value: true