chef-lsyncd

COMMUNITY OWNERSHIP MOVED

I've transfered the lysncd community cookbook maintainership to @dgivens (danielgivens on the community site). Please see: https://github.com/dgivens/chef-lsyncd for a much better cookbook!

Description

Installs/configures lsyncd.

Requirements

Platforms

• CentOS 6
• RHEL 6

Attributes

• node["lsyncd"]["logfile"] - log file for lsyncd, defaults to "/var/log/lsyncd.log"
• node["lsyncd"]["statusFile"] - status file for lsyncd, defaults to "/var/log/lsyncd-status.log"
• node["lsyncd"]["statusInterval"] - minimum seconds before updating status file, defaults to 20
• node["lsyncd"]["sync"] - Array of sync configurations, defaults to [], examples in Usage section

Recipes

• recipe[lsyncd] will install/configure lsyncd.
• recipe[lsyncd::source] will install lsyncd from source.

Usage

Package installation and configuration

• Add sync configurations via node["lsyncd"]["sync"] attribute
• Add recipe[lsyncd] to your node's run list

Source installation

• Add recipe[lsyncd::source] to your node's run list

Sync configuration

Select a mode for the sync for further attributes.

Attributes for all modes:

• mode - "rsync" or "rsyncssh" - defaults to "rsync"
• source - required - path to source directory - no default
• exclude - array of file exclusion strings - no default
• excludeFrom - path to exclude file - no default

rsync mode

For remote targets, normal rsync behavior of rsync all changes over the wire.

Attributes:

• host - remote host, used in conjunction with targetdir - no default
• rsyncOpts - array of rsync option strings, lsyncd defaults this to "-lts"
• target - full specification for destination ([host::]/target/dir) - no default
• targetdir - target directory, possibly used in conjunction with host - no default

Example:

"sync" => [
  {
    "mode" => "rsync",
    "source" => "/my/source/dir",
    "target" => "remotehost::/my/target/dir"
  }
]

rsyncssh mode

Causes moves and copies to be executed on the remote host via SSH, rather than retransmitting files over the wire. Normal rsync behavior otherwise.

Attributes:

• host - required - remote host - no default
• rsyncOpts - array of rsync option strings, lsyncd defaults this to "-lts"
• targetdir - required - target directory - no default

Example:

"sync" => [
  {
    "mode" => "rsyncssh",
    "source" => "/my/source/dir",
    "host" => "remotehost",
    "targetdir" => "/my/target/dir"
  }
]

Testing and Development

• Quickly testing with Vagrant: VAGRANT.md
• Full development and testing workflow with Test Kitchen and friends: TESTING.md

Contributing

Please see contributing information in: CONTRIBUTING.md

Maintainers

• Brian Flad ([email protected])

License

Please see licensing information in: LICENSE