Introduction

collective.recipe.rsync is a zc.buildout recipe that copies files between two locations via the rsync program.

Note

collective.recipe.rsync currently assumes you have a UNIX-based operating system and that the rsync binary is in your path when you execute buildout or the rsync script. Ideas for Windows support are welcome.

Installation

Add a section to your buildout.cfg file, e.g.:

[buildout]
http://build.pythonpackages.com/buildout/plone/latest
parts += rsync

[rsync]
recipe = collective.recipe.rsync
source = remotehost:/path/to/Data.fs
target = ${buildout:directory}/var/filestorage/Data.fs

This copies a Data.fs file from remotehost to var/filestorage/Data.fs relative to the buildout root.

Specify alternate SSH port

Optionally you may specify an alternate SSH port for rsync to use:

[rsync]
recipe = collective.recipe.rsync
source = remotehost:/path/to/Data.fs
target = ${buildout:directory}/var/filestorage/Data.fs
port = 22000

This copies a Data.fs file from remotehost to var/filestorage/Data.fs using port 22000.

Create a script

Normally collective.recipe.rsync will run rsync during the recipe installation. Optionally you can create a script to execute rsync later by configuring the script = true option:

[filestorage]
recipe = collective.recipe.rsync
source = remotehost:/path/to/Data.fs
target = ${buildout:directory}/var/filestorage/Data.fs
script = true

This is useful in cases where you want to automate an rsync script with cron e.g. via z3c.recipe.usercrontab.

Changelog

2.1.0 (2012-04-09)

  • Clean up package [aclark]

2.0.0 (2011-05-24)

  • Don't prefix scripts with "rsync-"

1.9 (2011-04-12)

  • Call install on update
  • UI tweaks

1.8 (2011-03-29)

  • Switched to using subprocess to call rsync (to show progress to stdout) [mattss]
  • Replace print statements with logger [aclark]
  • Update docs

1.7 (2011-01-21)

  • Doc fixes
  • Make script name based on section name
    • Support more than one script in the same buildout

1.6 (2011-01-20)

  • Add script option
    • Generates bin/rsync script
    • Disables rsync during buildout execution
    • Facilitates creation of scheduled rsyncs via cron

1.5 (2011-01-10)

  • Doc fixes
    • Add a note about UNIX compat only

1.4 (2011-01-10)

  • Support alternate ssh port parameter in recipe section. This allows collective.recipe.rsync to execute rsync with: -e 'ssh <port>', which facilitates copying over non-standard ssh ports.

1.3 (2010-12-19)

  • Fix docs

1.2 (2010-12-19)

  • Fix docs
  • Add new test harness
  • Clean up package

1.1 (2010-11-05)

  • Modified output to include rsync command line being executed

1.0 (2010-02-28)

  • Rename package from collective.recipe.rsync_datafs to collective.recipe.rsync

0.1 (2009-08-26)

  • Created recipe with ZopeSkel