Project

cfbackup

0.01
No commit activity in last 3 years
No release in over 3 years
There's a lot of open issues
A simple ruby program intended to serve as a useful tool for automated backups to Mosso Cloud Files.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

>= 0

Runtime

>= 1.4.4
>= 0.1.0
 Project Readme

CFBackup

CFBackup is a small ruby program that transfers files or directories from the local machine to a Cloud Files container. It is meant to serve as a useful tool for automated backups.

Features

  • Push (backup) a single file or directory (uses pseudo directories)
  • Pull (restore) a single file or directory
  • Delete (rotate) remote objects
  • Pipe data straight to container
  • Free transfers over local Rackspace network for Slicehost/Cloud Server customers in DFW1 datacenter

Requirements

  • cloudfiles >= 1.4.4

Notes:

  • If you install CFBackup as a gem, all of the dependencies should automatically be installed for you.
  • Ubuntu Users: The Ubuntu rubygems package will install executables outside your normal PATH. You will need to update it or create a symlink to access cfbackup from anywhere. See the wiki for more information.

Install

Configuration

A sample configuration file named cfconfig.yml should have be placed in /etc if installed as a gem. CFBackup will look in the following places (in order) for the configuration file named cfconfig.yml:

  • Hidden in home directory (~/.cfbackup.yml)
  • Non-hidden in present working directory (./cfbackup.yml)
  • In etc (/etc/cfbackup.yml)

The configuration file can be overridden at any time with the --config_file option

Usage

Usage: cfbackup.rb --action push|pull|delete options --container CONTAINER
        --action ACTION              Action to perform: push, pull, or delete.
        --pipe_data                  Pipe data from another application and stream it to Cloud Files
    -r, --recursive                  Traverse local path recursivley
    -v, --verbose                    Run verbosely
        --local_path LOCAL_PATH      Local path or file
        --container CONTAINER        Cloud Files container name
        --version                    Show current version
        --config_file PATH           Use specified config file, rather than the default
        --local_net                  Use unmetered connection in DFW1 (only applicable to Slicehost or Mosso Cloud Server customers)
        --max_retries COUNT          Change the number of times to retry an operation before giving up
        --ignore_errors              Ignore file operation errors (push only) and continue processing other files
        --error_log FILEPATH         Create an error log at the given filepath containing a listing of failed push operations

The wiki has usage examples and some sample automation scripts can be found in the example_scripts directory.

Copyright

Copyright (c) 2009 Jon Stacey. See LICENSE for details.