backup 3.0.3.build.0 → 3.0.3

data/lib/backup/storage/sftp.rb

@@ -0,0 +1,106 @@
+# encoding: utf-8
+
+##
+# Only load the Net::SFTP library/gem when the Backup::Storage::SFTP class is loaded
+require 'net/sftp'
+
+module Backup
+  module Storage
+    class SFTP < Base
+
+      ##
+      # Server credentials
+      attr_accessor :username, :password
+
+      ##
+      # Server IP Address and SFTP port
+      attr_accessor :ip, :port
+
+      ##
+      # Path to store backups to
+      attr_accessor :path
+
+      ##
+      # Creates a new instance of the SFTP storage object
+      # First it sets the defaults (if any exist) and then evaluates
+      # the configuration block which may overwrite these defaults
+      def initialize(&block)
+        load_defaults!
+
+        @port ||= 22
+        @path ||= 'backups'
+
+        instance_eval(&block) if block_given?
+
+        @time = TIME
+        @path = path.sub(/^\~\//, '')
+      end
+
+      ##
+      # This is the remote path to where the backup files will be stored
+      def remote_path
+        File.join(path, TRIGGER)
+      end
+
+      ##
+      # Performs the backup transfer
+      def perform!
+        transfer!
+        cycle!
+      end
+
+    private
+
+      ##
+      # Establishes a connection to the remote server and returns the Net::SFTP object.
+      # Not doing any instance variable caching because this object gets persisted in YAML
+      # format to a file and will issues. This, however has no impact on performance since it only
+      # gets invoked once per object for a #transfer! and once for a remove! Backups run in the
+      # background anyway so even if it were a bit slower it shouldn't matter.
+      def connection
+        Net::SFTP.start(ip, username, :password => password, :port => port)
+      end
+
+      ##
+      # Transfers the archived file to the specified remote server
+      def transfer!
+        Logger.message("#{ self.class } started transferring \"#{ remote_file }\".")
+        create_remote_directories!
+        connection.upload!(
+          File.join(local_path, local_file),
+          File.join(remote_path, remote_file)
+        )
+      end
+
+      ##
+      # Removes the transferred archive file from the server
+      def remove!
+        begin
+          connection.remove!(
+            File.join(remote_path, remote_file)
+          )
+        rescue Net::SFTP::StatusException
+          Logger.warn "Could not remove file \"#{ File.join(remote_path, remote_file) }\"."
+        end
+      end
+
+      ##
+      # Creates (if they don't exist yet) all the directories on the remote
+      # server in order to upload the backup file. Net::SFTP does not support
+      # paths to directories that don't yet exist when creating new directories.
+      # Instead, we split the parts up in to an array (for each '/') and loop through
+      # that to create the directories one by one. Net::SFTP raises an exception when
+      # the directory it's trying ot create already exists, so we have rescue it
+      def create_remote_directories!
+        path_parts = Array.new
+        remote_path.split('/').each do |path_part|
+          path_parts << path_part
+          begin
+            connection.mkdir!(path_parts.join('/'))
+          rescue Net::SFTP::StatusException; end
+        end
+      end
+
+    end
+  end
+end

data/lib/backup/syncer/rsync.rb

@@ -0,0 +1,119 @@
+# encoding: utf-8
+
+module Backup
+  module Syncer
+    class RSync
+      include Backup::CLI
+      include Backup::Configuration::Helpers
+
+      ##
+      # Server credentials
+      attr_accessor :username, :password
+
+      ##
+      # Server IP Address and SSH port
+      attr_accessor :ip
+
+      ##
+      # The SSH port to connect to
+      attr_writer :port
+
+      ##
+      # Files/Folders to Sync
+      attr_writer :folders
+
+      ##
+      # Path to store the synced files/folders to
+      attr_accessor :path
+
+      ##
+      # Flag for mirroring the files/folders
+      attr_writer :mirror
+
+      ##
+      # Flag for compressing (only compresses for the transfer)
+      attr_writer :compress
+
+      ##
+      # Additional options for the rsync cli
+      attr_accessor :additional_options
+
+      ##
+      # Instantiates a new RSync Syncer object and sets the default configuration
+      # specified in the Backup::Configuration::Syncer::RSync. Then it sets the object
+      # defaults if particular properties weren't set. Finally it'll evaluate the users
+      # configuration file and overwrite anything that's been defined
+      def initialize(&block)
+        load_defaults!
+
+        @folders              = Array.new
+        @additional_options ||= Array.new
+        @path               ||= 'backups'
+        @port               ||= 22
+        @mirror             ||= false
+        @compress           ||= false
+
+        instance_eval(&block) if block_given?
+
+        @path = path.sub(/^\~\//, '')
+      end
+
+      ##
+      # Performs the RSync operation
+      # debug options: -vhP
+      def perform!
+        Logger.message("#{ self.class } started syncing #{ folders }.")
+        Logger.silent( run("#{ utility(:rsync) } -vhP #{ options } #{ folders } '#{ username }@#{ ip }:#{ path }'") )
+      end
+
+      ##
+      # Returns all the specified Rsync options, concatenated, ready for the CLI
+      def options
+        ([archive, mirror, compress, port] + additional_options).compact.join("\s")
+      end
+
+      ##
+      # Returns Rsync syntax for specifying the --delete option (to enable mirroring)
+      def mirror
+        '--delete' if @mirror
+      end
+
+      ##
+      # Returns Rsync syntax for specifying the the 'compress' option
+      def compress
+        '-z' if @compress
+      end
+
+      ##
+      # Returns Rsync syntax for specifying the --archive option
+      def archive
+        '--archive'
+      end
+
+      ##
+      # Returns Rsync syntax for specifying a port to connect to
+      def port
+        "--port='#{@port}'"
+      end
+
+      ##
+      # If no block has been provided, it'll return the array of @folders.
+      # If a block has been provided, it'll evaluate it and add the defined paths to the @folders
+      def folders(&block)
+        unless block_given?
+          return @folders.map do |folder|
+            "'#{folder}'"
+          end.join("\s")
+        end
+        instance_eval(&block)
+      end
+
+      ##
+      # Adds a path to the @folder array
+      def add(path)
+        @folders << path
+      end
+
+    end
+  end
+end

data/lib/backup/version.rb

@@ -0,0 +1,72 @@
+# encoding: utf-8
+
+module Backup
+
+  ##
+  # Usage:
+  #
+  #  # Returns the current backup version based on the defined constants
+  #    Backup::Version.current
+  #
+  #  # Returns a gemspec compatible version number based on the defined constants
+  #    Backup::Version.gemspec
+  #
+  class Version
+
+    ##
+    # MAJOR:
+    #  Defines the major version
+    # MINOR:
+    #  Defines the minor version
+    # PATCH:
+    #  Defines the patch version
+    # BUILD:
+    #  Defines the build version ( use 'false' if no build )
+    MAJOR, MINOR, PATCH, BUILD = 3, 0, 3, false
+
+    # ========================================================= #
+    #  ADJUST THE CONSTANTS ABOVE TO CHANGE THE BACKUP VERSION  #
+    # ========================================================= #
+
+    ##
+    # Returns the major version ( big release based off of multiple minor releases )
+    def self.major
+      MAJOR
+    end
+
+    ##
+    # Returns the minor version ( small release based off of multiple patches )
+    def self.minor
+      MINOR
+    end
+
+    ##
+    # Returns the patch version ( updates, features and (crucial) bug fixes based off of multiple builds )
+    def self.patch
+      PATCH
+    end
+
+    ##
+    # Returns the build version ( improvements, small additions, frequent releases )
+    def self.build
+      BUILD
+    end
+
+    ##
+    # Returns the current version ( not for gemspec / rubygems )
+    def self.current
+      "#{major}.#{minor}.#{patch} / build #{build or 0}"
+    end
+
+    ##
+    # Returns the (gemspec qualified) current version
+    def self.gemspec
+      if build.eql?(false)
+        "#{major}.#{minor}.#{patch}"
+      else
+        "#{major}.#{minor}.#{patch}.build.#{build}"
+      end
+    end
+
+  end
+end

data/lib/templates/archive

@@ -0,0 +1,4 @@
+  archive :my_archive do |archive|
+    archive.add '/path/to/a/file.rb'
+    archive.add '/path/to/a/folder/'
+  end

data/lib/templates/compressor/gzip

@@ -0,0 +1,4 @@
+  compress_with Gzip do |compression|
+    compression.best = true
+    compression.fast = false
+  end

data/lib/templates/database/mongodb

@@ -0,0 +1,10 @@
+  database MongoDB do |db|
+    db.name               = "my_database_name"
+    db.username           = "my_username"
+    db.password           = "my_password"
+    db.host               = "localhost"
+    db.port               = 5432
+    db.ipv6               = false
+    db.only_collections   = ['only', 'these' 'collections']
+    db.additional_options = []
+  end

data/lib/templates/database/mysql

@@ -0,0 +1,11 @@
+  database MySQL do |db|
+    db.name               = "my_database_name"
+    db.username           = "my_username"
+    db.password           = "my_password"
+    db.host               = "localhost"
+    db.port               = 3306
+    db.socket             = "/tmp/mysql.sock"
+    db.skip_tables        = ['skip', 'these', 'tables']
+    db.only_tables        = ['only', 'these' 'tables']
+    db.additional_options = ['--quick', '--single-transaction']
+  end

data/lib/templates/database/postgresql

@@ -0,0 +1,11 @@
+  database PostgreSQL do |db|
+    db.name               = "my_database_name"
+    db.username           = "my_username"
+    db.password           = "my_password"
+    db.host               = "localhost"
+    db.port               = 5432
+    db.socket             = "/tmp/pg.sock"
+    db.skip_tables        = ['skip', 'these', 'tables']
+    db.only_tables        = ['only', 'these' 'tables']
+    db.additional_options = ['--quick', '--single-transaction']
+  end

data/lib/templates/database/redis

@@ -0,0 +1,10 @@
+  database Redis do |db|
+    db.name               = "my_database_name"
+    db.path               = "/usr/local/var/db/redis"
+    db.password           = "my_password"
+    db.host               = "localhost"
+    db.port               = 5432
+    db.socket             = "/tmp/redis.sock"
+    db.additional_options = []
+    db.invoke_save        = true
+  end

data/lib/templates/encryptor/gpg

@@ -0,0 +1,9 @@
+  encrypt_with GPG do |encryption|
+    encryption.key = <<-KEY
+      -----BEGIN PGP PUBLIC KEY BLOCK-----
+      Version: GnuPG v1.4.11 (Darwin)
+
+          <Your GPG Public Key Here>
+      -----END PGP PUBLIC KEY BLOCK-----
+    KEY
+  end

data/lib/templates/encryptor/openssl

@@ -0,0 +1,5 @@
+  encrypt_with OpenSSL do |encryption|
+    encryption.password = 'my_password'
+    encryption.base64   = true
+    encryption.salt     = true
+  end

data/lib/templates/notifier/mail

@@ -0,0 +1,14 @@
+  notify_by Mail do |mail|
+    mail.on_success           = true
+    mail.on_failure           = true
+
+    mail.from                 = 'sender@email.com'
+    mail.to                   = 'receiver@email.com'
+    mail.address              = 'smtp.gmail.com'
+    mail.port                 = 587
+    mail.domain               = 'your.host.name'
+    mail.user_name            = 'sender@email.com'
+    mail.password             = 'my_password'
+    mail.authentication       = 'plain'
+    mail.enable_starttls_auto = true
+  end

data/lib/templates/readme

@@ -0,0 +1,15 @@
+##
+# Backup
+# Generated Template
+#
+# For more information:
+#
+# View the Git repository at https://github.com/meskyanichi/backup
+# View the Wiki/Documentation at https://github.com/meskyanichi/backup/wiki
+# View the issue log at https://github.com/meskyanichi/backup/issues
+#
+# When you're finished configuring this configuration file,
+# you can run it from the command line by issuing the following command:
+#
+# $ backup -t my_backup [-c <path_to_configuration_file>]
+

data/lib/templates/storage/cloudfiles

@@ -0,0 +1,7 @@
+  store_with CloudFiles do |cf|
+    cf.api_key   = 'my_api_key'
+    cf.username  = 'my_username'
+    cf.container = 'my_container'
+    cf.path      = '/path/to/my/backups'
+    cf.keep      = 5
+  end

data/lib/templates/storage/dropbox

@@ -0,0 +1,8 @@
+  store_with Dropbox do |db|
+    db.email      = 'my@email.com'
+    db.password   = 'my_password'
+    db.api_key    = 'my_api_key'
+    db.api_secret = 'my_api_secret'
+    db.path       = '/path/to/my/backups'
+    db.keep       = 25
+  end

data/lib/templates/storage/ftp

@@ -0,0 +1,8 @@
+  store_with FTP do |server|
+    server.username = 'my_username'
+    server.password = 'my_password'
+    server.ip       = '123.45.678.90'
+    server.port     = 21
+    server.path     = '~/backups/'
+    server.keep     = 5
+  end

data/lib/templates/storage/rsync

@@ -0,0 +1,7 @@
+  store_with RSync do |server|
+    server.username = 'my_username'
+    server.password = 'my_password'
+    server.ip       = '123.45.678.90'
+    server.port     = 22
+    server.path     = '~/backups/'
+  end