cdist-type__rsync(7)

Nico Schottelius

<nico-cdist--@--schottelius.org>

Table of Contents

1. NAME
2. DESCRIPTION
3. REQUIRED PARAMETERS
4. OPTIONAL PARAMETERS
5. MESSAGES
6. EXAMPLES
7. SEE ALSO
8. COPYING

1. NAME

cdist-type__rsync - Mirror directories using rsync

2. DESCRIPTION

Warning

This type is of BETA quality:

it has not been tested widely
interfaces may change
if there is a better approach to solve the problem → the type may even vanish

If you are fine with these constraints, please read on.

This cdist type allows you to mirror local directories to the target host using rsync. Rsync will be installed in the manifest of the type. If group or owner are giveng, a recursive chown will be executed on the target host.

A slash will be appended to the source directory so that only the contents of the directory are taken and not the directory name itself.

3. REQUIRED PARAMETERS

source: Where to take files from

4. OPTIONAL PARAMETERS

group: Group to chgrp to.
owner: User to chown to.
destination: Use this as the base destination instead of the object id
remote-user: Use this user instead of the default "root" for rsync operations.

5. MESSAGES

NONE

6. EXAMPLES

# You can use any source directory
__rsync /tmp/testdir \
    --source /etc

# Use source from type
__rsync /etc \
    --source "$__type/files/package"

# Allow multiple __rsync objects to write to the same dir
__rsync mystuff \
    --destination /usr/local/bin \
    --source "$__type/files/package"

__rsync otherstuff \
    --destination /usr/local/bin \
    --source "$__type/files/package2"

7. SEE ALSO

cdist-type(7)