outback 0.0.5 → 0.0.6

data/README

@@ -0,0 +1,112 @@
+== Welcome to Outback
+
+Outback is a Ruby backup tool, enabling you to create backups of
+your server files and databases and storing them in a local or
+remote repository.
+
+Using a simple DSL, you can specify multiple sources that generate
+backup data, as well as multiple targets, where backups are going
+to be stored.
+
+Outback configuration files are pure Ruby, so writing dynamic
+configurations or even customized backup sources and targets is a
+piece of cake.
+
+
+== A simple configuration example
+
+# You can instantiate as many configurations as you like
+# Outback will enqueue and execute all configurations that were
+# instantiated during a single run.
+
+Outback::Configuration.new 'name' do  
+  source :directory, '/ver/www' do
+    exclude '/var/www/foo'
+    exclude '/var/www/icons/*.png'
+  end
+  
+  source :mysql do
+    user 'mysqlusername'
+    password 'mysqlpassword'
+    host 'localhost'
+    exclude 'mysql', 'information_schema'
+
+    #
+    # If you do not specify a specific database, all databases
+    # will be dumped and included in the backup
+    # database 'specific_database'  
+  end
+  
+  # Amazon S3 storage
+  target :s3 do
+    access_key  'S3 access key'
+    secret_key  'S3 secret key'
+    bucket      'bucketname'
+    prefix      'backups/daily'
+
+    # Backups will be purged after the time specified here.
+    # Just omit the definition to keep archives forever.
+    ttl         1.month
+  end
+
+  # Store on a local filesystem path
+  target :directory, '/media/backups/daily' do
+    # If you specify the move option, archives will be moved from the temporary
+    # filesystem location in order to speed up things. Otherwise, archives will
+    # be copied. Note that a 'move'-to target must be specified last in the target
+    # chain.
+    move  true
+    ttl   1.day
+    user  'root'
+    group 'root'
+    directory_permissions 0700
+    archive_permissions   0600
+  end
+end
+
+
+== Default configurations and commandline options
+
+If you place your backup configurations in the file /etc/outback.conf they
+will be read automatically when the outback executable is invoked. Make
+sure to have correct permissions on the configuration files, as they might
+include database passwords.
+
+Alternatively, you can pass in the configuration file to read as a
+commandline argument. The default configuration file in /etc will then be
+ignored.
+
+If you have several backup configurations in a single file, say, for daily
+and monthly backups, you can use the -c commandline option to select the
+backup to be invoked:
+
+$ outback -c 'myservername-daily'
+
+This will run only the backup with the specified name, which enables you to
+write DRY configurations like this:
+
+{ :daily => [14.days, 5.days], :monthly	=> [1.year, 1.year] }.each do |frequency, ttls|
+  s3_ttl, directory_ttl = ttls
+
+  Outback::Configuration.new "yourserver-#{frequency}" do
+    source :directory, '/home'
+    source :directory, '/var/svn'
+
+    target :s3 do
+      access_key  'foo'
+      secret_key  'foo'
+      bucket      'somebucket'
+      prefix      "yourserver/#{frequency}"
+      ttl         s3_ttl
+    end
+
+    target :directory, "/media/backups/#{frequency}" do
+      move  true
+      ttl   directory_ttl
+      user  'root'
+      group 'root'
+      directory_permissions 0700
+      archive_permissions   0600
+    end
+  end
+end

data/VERSION

@@ -1 +1 @@
-0.0.5
+0.0.6

data/lib/outback/backup.rb

@@ -36,7 +36,7 @@ module Outback
     end
 
     def purge_targets
-      targets.each { |target| target.purge! }
+      targets.each { |target| target.purge!(name) }
     end
     
   end

data/lib/outback/directory_source.rb

@@ -23,10 +23,10 @@ module Outback
       archive_name = Pathname.new(tmpdir).join("#{backup_name}_#{timestamp}_#{source_name}.tar.gz")
       exclude_list = Pathname.new(tmpdir).join('exclude_list.txt')
       File.open(exclude_list, 'w') { |f| f << excludes.join("\n") }
-      commandline = "tar --create --file #{archive_name} --preserve-permissions --gzip --verbose --exclude-from #{exclude_list} #{source_dir}"
+      commandline = "tar --create --file #{archive_name} --preserve-permissions --gzip --exclude-from #{exclude_list} #{source_dir}"
       Outback.debug "executing command: #{commandline}"
       result = `#{commandline}`
-      Outback.debug result
+      #Outback.debug result
       [TempArchive.new(archive_name, self)]
     end
   end

data/lib/outback/directory_target.rb

@@ -14,6 +14,7 @@ module Outback
     def put(archives)
       Dir.mkdir(path) unless path.directory?
       FileUtils.chmod directory_permissions || 0700, path
+      size = 0
       archives.each do |archive|
         basename = Pathname.new(archive.filename).basename
         if move
@@ -29,12 +30,14 @@ module Outback
         if user && group
           Outback.debug "setting owner #{user}, group #{group} for #{archived_file}"
           FileUtils.chown user, group, archived_file
-        end 
+        end
+        size += archived_file.size
       end
+      Outback.debug "#{move ? 'Moved' : 'Copied'} #{archives.size} archives (#{size} bytes) to directory #{path}"
     end
 
-    def list_archives
-      path.files(Archive::NAME_PATTERN).map { |f| DirectoryArchive.new(f, self) }
+    def list_archives(name)
+      path.files(Archive::NAME_PATTERN).map { |f| DirectoryArchive.new(f, self) }.select(&its.backup_name == name)
     end
     
   end

data/lib/outback/s3_target.rb

@@ -20,12 +20,13 @@ module Outback
         object_exists = AWS::S3::S3Object.exists?(object_name, bucket)
         Outback.debug "Checking if object exists: #{object_exists}"
       end
+      Outback.debug "Uploaded #{archives.sum(&:size)} bytes to S3"
     end
     
-    def list_archives
+    def list_archives(name)
       connect
       entries = AWS::S3::Bucket.objects(bucket).select { |e| e.key.start_with?(prefix.to_s) && e.key[prefix.to_s.size..-1].match(Archive::NAME_PATTERN) }
-      entries.map { |e| S3Archive.new(e.key, self) }
+      entries.map { |e| S3Archive.new(e.key, self) }.select(&its.backup_name == name)
     end
   end
   

data/lib/outback/target.rb

@@ -2,12 +2,12 @@ module Outback
   class Target
     include Configurable
 
-    def outdated_archives
-      list_archives.select(&:outdated?)
+    def outdated_archives(name)
+      list_archives(name).select(&:outdated?)
     end
     
-    def purge!
-      outdated_archives.each &:purge!
+    def purge!(name)
+      outdated_archives(name).each &:purge!
     end
   
   end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: outback
 version: !ruby/object:Gem::Version 
-  hash: 21
+  hash: 19
   prerelease: 
   segments: 
   - 0
   - 0
-  - 5
-  version: 0.0.5
+  - 6
+  version: 0.0.6
 platform: ruby
 authors: 
 - Matthias Grosser
@@ -85,6 +85,7 @@ files:
 - bin/outback
 - MIT-LICENSE
 - VERSION
+- README
 has_rdoc: true
 homepage: http://rubygems.org/gems/outback
 licenses: []