Scroll to navigation

CDIST-TYPE__RSYNC(7) cdist CDIST-TYPE__RSYNC(7)

NAME

cdist-type__rsync - Mirror directories using rsync

DESCRIPTION

The purpose of this type is to bring power of rsync into cdist.

REQUIRED PARAMETERS

Source directory in local machine. If source is directory, slash (/) will be added to source and destination paths.

OPTIONAL PARAMETERS

Destination directory. Defaults to $__object_id.
Will be passed to rsync as --chown=OWNER. Read rsync(1) for more details.
Will be passed to rsync as --chown=:GROUP. Read rsync(1) for more details.
Will be passed to rsync as --chmod=MODE. Read rsync(1) for more details.
Defaults to --recursive --links --perms --times. Due to 
`bug in Python's argparse<https://bugs.python.org/issue9334>`_
, value must be prefixed with \.
Defaults to root.

OPTIONAL MULTIPLE PARAMETERS

Pass additional options to rsync. See rsync(1) for all possible options. Due to 
`bug in Python's argparse<https://bugs.python.org/issue9334>`_
, value must be prefixed with \.

EXAMPLES

__rsync /var/www/example.com \


    --owner root \


    --group www-data \


    --mode 'D750,F640' \


    --source "$__files/example.com/www"


AUTHORS

Ander Punnar <ander-at-kvlt-dot-ee>

COPYING

Copyright (C) 2021 Ander Punnar. You can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

COPYRIGHT

ungleich GmbH 2021

September 11, 2024 7.0.0