fallout 0.0.1 → 0.0.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 58b93407bb2b48ce39c73c4dbcc3bc770260b32e
-  data.tar.gz: d3bf1ff41fe648c677518404783c13bb1dd30bfe
+  metadata.gz: 4173f8e75da22b283ef91722f045e2a3dff4e20c
+  data.tar.gz: a390595d7d6db59a458e6a59c1e89d260a70e9f7
 SHA512:
-  metadata.gz: 57ac6f64c67dc9db392c8ea2922eee7025ac906cd024c86c654072fe888cf002e4ea97efc28b4404ff07f5ce5947db2e687903a957d0f6dda31047bd5c0f8015
-  data.tar.gz: 23c065ae1393c703e1e6fd9e37a84f0d77ddd41d5bd758ef5ac80672925c824f186f31e93e8cc83cc45652cc9cd999465aeb63364e1fdde7782ccd22a464d5c4
+  metadata.gz: 5fe8aab0a871b68b8abb6a2447c011f6bc666cea784c2af6fe28de3156569b9accdd758ca7027bf6238b0f7b117ad3537cc52c7b256f22f024cbb46f134fdd5d
+  data.tar.gz: 9240b4ee9b2951ad3a79ea6ffd435cd59337499ef8582cf90e0d86416e759f1d74a31aa63f27699ec181d0f72058ee07cfb983024bba49d7c6d884530eed3651

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    fallout (0.0.1)
+    fallout (0.0.2)
       aws-sdk
       trollop
 

data/README.md

@@ -44,7 +44,63 @@ running every day, it will keep N most fresh snapshots automatically.
 
 ### restore
 
-Work in progress
+Restoring is a one-liner too.
+
+Syntax:
+
+`fallout restore -i <instance_id> -v <volume_id>`
+
+Example:
+
+```
+$ fallout restore -i i-f7850bda -v vol-72436837
+
+Shutting down your instance.
+Shut down instance successfully: i-f7850bda, status: stopped
+Detached volume vol-72436837 from instance i-f7850bda successfully
+Created new volume from the latest snapshot (vol-3942697c)
+Attached new volume to instance
+Successfully restored and started the instance with the new volume
+Instance public hostname: ec2-54-165-20-157.compute-1.amazonaws.com
+You man want to delete the old, detached volume vol-72436837 and old volume snapshots
+IMPORTANT: You must update your backup command to use new volume_id: vol-3942697c
+```
+
+#### How does restoring work?
+
+Restoring with fallout requires you to have at least 1 snapshot for the
+volume. The process will shutdown the instance, detach the root volume,
+create new volume from the latest snapshot and attach it as `/dev/sda1`
+device. Then the process will boot the instance with the new volume and
+display its public hostname.
+
+##### IMPORTANT:
+
+Currently the volume will be attached as `/dev/sda1` device and created
+in `us-east-1a` zone.
+If you need this stuff to be configurable, let me know, I'll implement
+it.
+
+#### General considerations:
+
+I created this gem purely for my own purposes, we only have a handful of
+EC2 instances and the gem is working fine for us.
+
+I run `fallout backup` daily with cron.
+
+Contributions, tips/advices and pull requests are welcome.
+
+### Licence
+
+This code is MIT licenced:
+
+Copyright (c) 2014 Valentin Vasilyev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 
 ## Contributing
 

data/bin/fallout

@@ -66,6 +66,27 @@ when 'restore'
   if(opts[:instance].nil? || opts[:volume].nil?)
     puts '-i and -v are required for restore'
   else
-    Fallout::Restore.new(opts).run
+    begin
+      r = Fallout::Restore.new(opts)
+      snapshot = r.get_latest_snapshot_for_volume(r.get_volume)
+      puts "Initiating omega protocol, retina scan required."
+      sleep 3
+      puts "Ok, let's do it without retina, shutting down your instance."
+      instance = r.shutdown_instance
+      puts "Shut down instance successfully: #{instance.id}, status: #{instance.status}"
+      attachment = r.detach_volume(instance)
+      puts "Detached volume #{attachment.volume.id} from instance #{instance.id} successfully"
+      new_volume = r.create_volume(snapshot)
+      puts "Created new volume from the latest snapshot (#{new_volume.id})"
+      r.attach_volume(new_volume, instance)
+      puts "Attached new volume to instance"
+      instance = r.start_instance(instance)
+      puts "Successfully restored and started the instance with the new volume"
+      puts "Instance public hostname: #{instance.dns_name}"
+      puts "You man want to delete the old, detached volume #{attachment.volume.id} and old volume snapshots"
+      puts "IMPORTANT: You must update your backup command to use new volume_id: #{new_volume.id}"
+    rescue Exception => e
+      puts e.message
+    end
   end
 end

data/lib/fallout/restore.rb

@@ -1,10 +1,77 @@
 module Fallout
   class Restore
     def initialize(options)
+      @instance_id = options[:instance]
+      @volume_id = options[:volume]
+      @ec2 = AWS::EC2.new
+      @ec2_client = AWS::EC2::Client.new
     end
 
-    def run 
-      puts 'running restore with options: ' + @options.inspect
+    def get_volume
+      @ec2.volumes[@volume_id]
+    end
+
+    def shutdown_instance
+      instance = @ec2.instances[@instance_id]
+      raise "Instance does not exist: #{@instance_id}" if instance.nil? || !instance.exists?
+      instance.stop
+      while instance.status != :stopped
+        sleep 1
+      end
+      instance
+    end
+
+    def start_instance(instance)
+      instance.start
+      while instance.status != :running
+        sleep 1
+      end
+      instance
+    end
+
+    def detach_volume(instance, device = '/dev/sda1')
+      volume = @ec2.volumes[@volume_id]
+      raise "Volume does not exist: #{volume_id}" if volume.nil? || !volume.exists?
+      attachment = volume.detach_from(instance, device)
+      while volume.status != :available
+        sleep 1
+      end
+      attachment
+    end
+
+    def attach_volume(volume, instance, device = '/dev/sda1')
+      volume.attach_to(instance, device)
+      while volume.status != :in_use
+        sleep 1
+      end
+      volume
+    end
+
+    def delete_volume(volume)
+      volume.delete
+      while volume.status != :deleted
+        sleep 1
+      end
+      volume
+    end
+
+    def get_latest_snapshot_for_volume(volume)
+      snapshots = @ec2.snapshots.filter('volume-id', @volume_id)
+      raise "No snapshots for volume #{volume.id} found, aborting restore process.\n
+      Hint: have you created a snapshot for this volume at least once?" unless snapshots.any?
+      snapshots.max_by{|ss| Date.parse(ss.tags.to_h[EXPIRES_AFTER_KEY]) rescue Date.new}
+    end
+
+    def create_volume(snapshot, availability_zone = 'us-east-1a', volume_type: 'gp2')
+      resp = @ec2_client.create_volume(
+        snapshot_id: snapshot.id,
+        availability_zone: availability_zone,
+        volume_type: volume_type)
+      volume = @ec2.volumes[resp[:volume_id]]
+      while volume.status != :available
+        sleep 1
+      end
+      volume
     end
   end
-end
+end

data/lib/fallout/version.rb

@@ -1,3 +1,3 @@
 module Fallout
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: fallout
 version: !ruby/object:Gem::Version
-  version: 0.0.1
+  version: 0.0.2
 platform: ruby
 authors:
 - Valentin Vasilyev
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-09-12 00:00:00.000000000 Z
+date: 2014-09-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk