Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Fetching contributors…

Cannot retrieve contributors at this time

232 lines (170 sloc) 7.96 kb

Backup

Backup is a system utility for Linux and Mac OS X, distributed as a RubyGem, that allows you to easily perform backup operations. It provides an elegant DSL in Ruby for modeling your backups. Backup has built-in support for various databases, storage protocols/services, syncers, compressors, encryptors and notifiers which you can mix and match. It was built with modularity, extensibility and simplicity in mind.

Installation

To get the latest stable version:

gem install backup

See Release Notes in the wiki for changes in the latest version.

Backup supports Ruby versions 1.8.7, 1.9.2, 1.9.3 and 2.0.0.

Overview

Backup allows you to model your backup jobs using a Ruby DSL:

Backup::Model.new(:my_backup, 'Description for my_backup') do
  # ... components here ...
end

The :my_backup symbol is the model's trigger and used to perform the job:

$ backup perform --trigger my_backup

Backup's components are added to the backup model to define the actions to be performed.
All of Backup's components are fully documented in the Backup Wiki.
The following is brief overview of the components Backup provides:

Archives and Databases

Archives create basic tar archives. Both GNU and BSD tar are supported.
Databases create backups of one of the following supported databases:

  • MySQL
  • PostgreSQL
  • MongoDB
  • Redis
  • Riak

Any number of Archives and Databases may be defined within a backup model.

Compressors and Encryptors

Adding a Compressor to your backup will compress all the Archives and Database backups within your final archive package.
Gzip, Bzip2 and other similar compressors are supported.

Adding a Encryptor allows you to encrypt your final backup package.
Both OpenSSL and GPG are supported.

Your final backup package might look something like this:

$ gpg --decrypt my_backup.tar.gpg --outfile my_backup.tar
$ tar -tvf my_backup.tar
  my_backup/
  my_backup/archives/
  my_backup/archives/user_avatars.tar.gz
  my_backup/archives/log_files.tar.gz
  my_backup/databases/
  my_backup/databases/PostgreSQL/
  my_backup/databases/PostgreSQL/pg_db_name.sql.gz
  my_backup/databases/Redis/
  my_backup/databases/Redis/redis_db_name.rdb.gz

Storages

Once your final backup package is ready, you can use any number of the following Storages to store it:

  • Amazon Simple Storage Service (S3)
  • Rackspace Cloud Files (Mosso)
  • Ninefold Cloud Storage
  • Dropbox Web Service
  • Remote Servers (Available Protocols: FTP, SFTP, SCP and RSync)
  • Local Storage (including network mounted locations)

All of the above Storages (except RSync) support:

  • Cycling to keep and rotate multiple copies of your stored backups.

  • Splitter to break up a large backup package into smaller files.

When using the RSync Storage, once a full backup has been stored, subsequent backups only need to transmit the changed portions of the final archive to bring the remote copy up-to-date.

Syncers

Syncers are processed after your final backup archive has been stored and allow you to perform file synchronization.

Backup includes two types of Syncers:

  • RSync: Used to sync files locally, local-to-remote (Push), or remote-to-local (Pull).
  • Cloud: Used to sync files to remote storage services like Amazon S3 and Rackspace.

A backup model may contain only Syncers as well.

Notifiers

Notifiers are used to send notifications upon successful and/or failed completion of your backup model.

Supported notification services include:

  • Email (SMTP, Sendmail, Exim and File delivery)
  • Twitter
  • Campfire
  • Presently
  • Prowl
  • Hipchat
  • Pushover

Generators

Backup makes it easy to setup new backup model files with it's Generator command.

$ backup generate:model -t my_backup --archives --databases=postgresql,redis --compressors=gzip \
    --encryptors=gpg --storages=sftp,s3 --notifiers=mail,twitter

Simply generate a new model using the options you need, then update the configuration for each component using the Wiki documentation.

The following is an example of a what this Backup model might look like:

Backup::Model.new(:my_backup, 'Description for my_backup') do
  split_into_chunks_of 250

  archive :user_avatars do |archive|
    archive.add '/var/apps/my_sample_app/public/avatars'
  end

  archive :log_files do |archive|
    archive.add     '/var/apps/my_sample_app/logs'
    archive.exclude '/var/apps/my_sample_app/logs/exclude-this.log'
  end

  database PostgreSQL do |db|
    db.name               = "pg_db_name"
    db.username           = "username"
    db.password           = "password"
  end

  database Redis do |db|
    db.name               = "redis_db_name"
    db.path               = "/usr/local/var/db/redis"
    db.password           = "password"
    db.invoke_save        = true
  end

  compress_with Gzip

  encrypt_with GPG do |encryption|
    encryption.mode = :symmetric
    encryption.passphrase = 'my_password'
  end

  store_with SFTP do |server|
    server.username   = "my_username"
    server.password   = "my_password"
    server.ip         = "123.45.678.90"
    server.port       = 22
    server.path       = "~/backups/"
    server.keep       = 5
  end

  store_with S3 do |s3|
    s3.access_key_id     = "my_access_key_id"
    s3.secret_access_key = "my_secret_access_key"
    s3.region            = "us-east-1"
    s3.bucket            = "bucket-name"
    s3.path              = "/path/to/my/backups"
    s3.keep              = 10
  end

  notify_by Mail do |mail|
    mail.on_success           = false

    mail.from                 = "sender@email.com"
    mail.to                   = "receiver@email.com"
    mail.address              = "smtp.gmail.com"
    mail.port                 = 587
    mail.user_name            = "sender@email.com"
    mail.password             = "my_password"
    mail.authentication       = "plain"
    mail.enable_starttls_auto = true
  end

  notify_by Twitter do |tweet|
    tweet.consumer_key       = "my_consumer_key"
    tweet.consumer_secret    = "my_consumer_secret"
    tweet.oauth_token        = "my_oauth_token"
    tweet.oauth_token_secret = "my_oauth_token_secret"
  end
end

The Getting Started page provides a simple walk-through to familiarize you with setting up, configuring and running a backup job.

Suggestions, Issues, etc...

If you have any suggestions or problems, please submit an Issue or Pull Request using Backup's Issue Log.

If you find any errors or omissions in Backup's documentation Wiki, please feel free to edit it!

Backup has seen many improvements over the years thanks to it's Contributors, as well as those who have help discuss issues and improve the documentation, and looks forward to continuing to provide users with a reliable backup solution.

Copyright (c) 2009-2013 Michael van Rooijen ( @meskyanichi )
Released under the MIT License.

Jump to Line
Something went wrong with that request. Please try again.