awstools 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,9 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in awstools.gemspec
+gemspec
+
+# once the pull is integrated switch to main branch
+# gem 'amazon-ec2'
+gem 'amazon-ec2', :git => 'https://github.com/stw/amazon-ec2.git', :branch => 'add_filters_to_snapshots'
+gem 'trollop'

data/LICENSE

@@ -0,0 +1,66 @@
+Copyright (c) 2007-2009 Glenn Rempe
+
+This software is distributed under the Ruby License.  A copy of which is
+provided below.
+
+RUBY LICENSE
+
+http://www.ruby-lang.org/en/LICENSE.txt
+
+Ruby is copyrighted free software by Yukihiro Matsumoto <matz@netlab.co.jp>.
+You can redistribute it and/or modify it under either the terms of the GPL
+(see COPYING.txt file), or the conditions below:
+
+  1. You may make and give away verbatim copies of the source form of the
+     software without restriction, provided that you duplicate all of the
+     original copyright notices and associated disclaimers.
+
+  2. You may modify your copy of the software in any way, provided that
+     you do at least ONE of the following:
+
+       a) place your modifications in the Public Domain or otherwise
+          make them Freely Available, such as by posting said
+          modifications to Usenet or an equivalent medium, or by allowing
+          the author to include your modifications in the software.
+
+       b) use the modified software only within your corporation or
+          organization.
+
+       c) rename any non-standard executables so the names do not conflict
+          with standard executables, which must also be provided.
+
+       d) make other distribution arrangements with the author.
+
+  3. You may distribute the software in object code or executable
+     form, provided that you do at least ONE of the following:
+
+       a) distribute the executables and library files of the software,
+          together with instructions (in the manual page or equivalent)
+          on where to get the original distribution.
+
+       b) accompany the distribution with the machine-readable source of
+          the software.
+
+       c) give non-standard executables non-standard names, with
+          instructions on where to get the original software distribution.
+
+       d) make other distribution arrangements with the author.
+
+  4. You may modify and include the part of the software into any other
+     software (possibly commercial).  But some files in the distribution
+     are not written by the author, so that they are not under this terms.
+
+     They are gc.c(partly), utils.c(partly), regex.[ch], st.[ch] and some
+     files under the ./missing directory.  See each file for the copying
+     condition.
+
+  5. The scripts and library files supplied as input to or produced as 
+     output from the software do not automatically fall under the
+     copyright of the software, but belong to whomever generated them, 
+     and may be sold commercially, and may be aggregated with this
+     software.
+
+  6. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+     IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+     WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+     PURPOSE.

data/Rakefile

@@ -0,0 +1,2 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks

data/Readme.rdoc

@@ -0,0 +1,68 @@
+= AWS tools
+
+== Note
+
+This is very beta, use at your own risk. That said, I am using it production.
+
+Until my filter patch gets pulled, you'll need to use this version of amazon-ec2:
+
+    https://github.com/stw/amazon-ec2/tree/add_filters_to_snapshots
+
+== Description
+
+A simple gem to provide aws command line tools, currently only snapshots.  snapshots allows you to create snapshots from volumes on aws and deletes snapshots greater than the keep parameter.
+
+== Usage
+
+  snapshots -v volume-id -k 2 -d "Some Description" -q 
+
+Creates a snapshot of volume-id, and deletes all snapshots except for the current and the last most recent.
+
+== Installation 
+
+Ensure you set your amazon keys.
+
+  export EC2_PRIVATE_KEY=/path/to/private_key.pem 
+  export EC2_CERT=/path/to/cert.pem
+
+  gem install awstools
+
+  snapshot -v volume-id -k 2 -d "Some Description"
+
+  snapshot --help for params
+
+  options:
+
+  Usage:
+       snapshots [options]
+
+  where [options] are:
+       --volume, -v <s>:   Volume to snapshot
+         --keep, -k <i>:   Snapshots to keep (default: 2)
+  --description, -d <s>:   Snapshot description
+            --quiet, -q:   Don't print anything
+         --simulate, -s:   Simulate, nothing created/deleted
+             --help, -h:   Show this message
+
+== Reason
+
+I looked for a simple tool to do this and didn't find anything I liked so I put this together.
+
+== Contact
+
+Comments, patches, Git pull requests and bug reports are welcome. Send an email to swalker@walkertek.com
+
+== Patches & Pull Requests
+
+Please follow these steps if you want to send a patch or a GitHub pull request:
+
+* Fork stw/awstools
+* Create a topic branch: `git checkout -b my_fix`
+* Make sure you add tests for your changes and that they all pass with 'rake test'
+* Don't change files that you don't own like the gemspec or version.rb
+* Commit your changes, one change/fix per commit
+* Push your fixes branch: `git push origin my_fix`
+* Open an Issue on GitHub referencing your branch and send a pull request.
+* Please do not push to `master` on your fork. Using a feature/bugfix branch will make everyone’s life easier. 
+
+

data/awstools.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "awstools/version"
+
+Gem::Specification.new do |s|
+  s.name        = "awstools"
+  s.version     = Awstools::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Stephen Walker"]
+  s.email       = ["swalker@walkertek.com"]
+  s.homepage    = "http://stephenwalker.com"
+  s.summary     = %q{Tools to operate on aws}
+  s.description = %q{Right now, only snapshots.rb, creates and deletes snapshots}
+
+  s.rubyforge_project = "awstools"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/bin/snapshots

@@ -0,0 +1,75 @@
+#!/usr/bin/env ruby 
+# swalker@walkertek.com - 2011-04-27  
+
+require 'rubygems'
+require 'trollop'
+require 'AWS' 
+
+# from cron  
+# create a daily snapshot, keep the last 2
+# 0 0 * * * /path/to/snapshots.rb -v volume-id -k 7 -d "Some Snapshot Description"  
+
+options = Trollop::options do
+  banner <<-EOS
+Take a snapshot of a volume and keep the latest <keep> snapshots, removing the rest
+
+Usage:
+       snapshots [options]
+
+where [options] are:
+EOS
+  
+  opt :volume,      "Volume to snapshot",   :type => String,  :short => 'v', :required => true
+  opt :keep,        "Snapshots to keep",    :type => :int,    :short => 'k', :default => 2
+  opt :description, "Snapshot description", :type => String,  :short => 'd'
+  opt :quiet,       "Don't print anything", :short => 'q'
+  opt :simulate,    "Simulate, nothing created/deleted", :short => 's'
+end
+
+volume      = options[:volume] 
+keep        = options[:keep] 
+description = options[:description] || '' 
+quiet       = options[:quiet] || false
+simulate    = options[:simulate] || false
+
+@ec2 = AWS::EC2::Base.new(
+  :access_key_id      => ENV['AMAZON_ACCESS_KEY_ID'], 
+  :secret_access_key  => ENV['AMAZON_SECRET_ACCESS_KEY'])
+
+quiet or puts "Create new snapshot."
+quiet or puts "Volume: #{volume} Description: #{description}"
+begin 
+  simulate or @ec2.create_snapshot(:volume_id => volume, :description => description)
+rescue Exception => e
+  puts "Error: #{e.message}"
+  puts "Exiting"
+  exit
+end
+
+snapshots = @ec2.describe_snapshots(:filter_names => ['volume-id'], :filter_values => [volume]) 
+snapshots = snapshots["snapshotSet"]["item"]
+
+# sort by startTime desc
+snapshots = snapshots.sort {|a,b| b.startTime <=> a.startTime }
+
+# how many to remove, slices off end of array
+remove    = (snapshots.count - keep.to_i) 
+snapshots = snapshots.slice(-remove, remove)  
+
+snapshots && snapshots.each do |s|
+  quiet or puts "Removing..."
+  quiet or puts "Description: #{s.description}"
+  quiet or puts "snapshotId:  #{s.snapshotId}"
+  quiet or puts "volumeId:    #{s.volumeId}"
+  quiet or puts "startTime:   #{s.startTime}" 
+  quiet or puts
+  begin 
+    simulate or @ec2.delete_snapshot(:snapshot_id => s.snapshotId)
+  rescue Exception => e
+    puts "Error: #{e.message}"
+    puts "Exiting"
+    exit
+  end
+end
+
+quiet or puts "Done."

data/lib/awstools.rb

@@ -0,0 +1,3 @@
+module Awstools
+  # Your code goes here...
+end

data/lib/awstools/version.rb

@@ -0,0 +1,3 @@
+module Awstools
+  VERSION = "0.0.1"
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification 
+name: awstools
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Stephen Walker
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-04-27 00:00:00 -04:00
+default_executable: 
+dependencies: []
+
+description: Right now, only snapshots.rb, creates and deletes snapshots
+email: 
+- swalker@walkertek.com
+executables: 
+- snapshots
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- LICENSE
+- Rakefile
+- Readme.rdoc
+- awstools.gemspec
+- bin/snapshots
+- lib/awstools.rb
+- lib/awstools/version.rb
+has_rdoc: true
+homepage: http://stephenwalker.com
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: awstools
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: Tools to operate on aws
+test_files: []
+