collective.recipe.rsync 1.4

A zc.buildout recipe to copy data from source to target

Contents

• Introduction

  • Usage

    • Alternate ssh port

  • Contact

  • Changelog

    • 1.4 (2011-01-10)

    • 1.3 (2010-12-19)

    • 1.2 (2010-12-19)

    • 1.1 (2010-11-05)

    • 1.0 (2010-02-28)

    • 0.1 (2009-08-26)

Introduction

collective.recipe.rsync is a zc.buildout recipe that makes it easy to synchronize data between two locations, via the rsync program.

It was originally created to make it easier to synchronize Data.fs files between Plone production and development environments. But you can use it to synchronize any tree of data e.g. ZODB blob files, and so on.

Currently, it assumes you have a UNIX-based operating system and that the rsync binary is in your path when you run buildout.

Usage

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

[buildout]
parts += database

[database]
recipe = collective.recipe.rsync
source = [e-mail]:/srv/aclark/var/filestorage/Data.fs
target = var/filestorage/Data.fs

Run buildout. You should see:

--------------------------------------------------------------------------------
Running rsync...
  rsync -av --partial --progress
[e-mail]:/srv/aclark/var/filestorage/Data.fs
var/filestorage/Data.fs
  this may take a while!

Alternate ssh port

Optionally, you can specify an alternate ssh port for rsync to use:

[database]
recipe = collective.recipe.rsync
source = [e-mail]:/srv/aclark/var/filestorage/Data.fs
target = var/filestorage/Data.fs
port = 22001

Contact

Comments, questions, concerns? Email: [e-mail]

Changelog

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