ec2manage 0.0.1

data/README.md

@@ -0,0 +1,74 @@
+ec2manage
+=========
+
+ec2manage is a command line tool for managing EC2 instances.
+
+It's main goal is to provide the same style of control as the Amazon EC2 API Tools but with additional structure and metadata make administrative decisions easier.
+
+Installation
+============
+
+    gem install ec2manage
+
+ec2manage will read your `EC2_PRIVATE_KEY` and `EC2_CERT` environment variables if you've already defined them for the Amazon EC2 API Tools. Or if you only plan to use ec2manage, you can just drop your `pk-*.pem` and `cert-*.pem` in `~/.ec2manage`.
+
+ec2manage uses SDB for storing nicknames for instances and volumes so you'll need to also have your SDB access credentials available.
+
+Usage
+=====
+
+Creating machines
+-----------------
+
+Create a new Ubuntu 9 machine with 10GB blank EBS on /dev/sdi1 nicknamed "beta" in the web security group:
+
+    > ec2manage create -z us-east-1d -a ami-bb709dd2 -k my-keypair \
+                       -g web -v 10 -s snap-6a0a8c03 -d sdi -n beta
+
+Of course, specifying this every time would be tedious, so you can also build machine templates in JSON. The above machine would look like this:
+
+    { "zone":    "us-east-1d",
+      "ami":     "ami-bb709dd2",
+      "keypair": "my-keypair",
+      "group":   "web",
+      "volumes": [
+        { "size":     10,
+          "snapshot": "snap-6a0a8c0",
+          "device":   "sdi" }
+      ] }
+
+You can save this template as a file and load it with `-t`:
+
+    > ec2manage create -t web.json -n beta
+
+If ec2manage can't find the specified path in the current directory it will attempt to load the file from `~/.ec2manage/web.json`. In this case you could also omit the extension and just use `-t web`.
+
+Additionally, if you omit all configuration options, ec2manage will try to load `~/.ec2manage/default.json`.
+
+Create a new ec2 instance and ssh into it:
+
+    > ec2manage create -c "ssh %"
+
+The external hostname of the instance is passed to the command string using `String#%`. See [Kernel.sprintf](http://ruby-doc.org/core/classes/Kernel.html#M005962) for details on how this function works.
+
+Naming machines
+---------------
+
+You can get a JSON list of all images and volumes by running ec2manage with no arguments:
+
+    > ec2manage
+
+You can also give your instances new nicknames using the rename command:
+
+    > ec2manage rename i-12345 staging
+
+Deleting machines
+-----------------
+
+And finally you can remove machines as well as their associated volumes by using the delete command with the `-v` flag:
+
+    > ec2manage delete staging -v
+
+If you have an unassociated volume you can delete it by name as well:
+
+    > ec2manage delete v-12345

data/bin/ec2manage

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+
+begin
+  require 'ec2manage'
+rescue LoadError
+  require 'rubygems'
+  require 'ec2manage'
+end
+
+EC2Manage::Commands.start

data/lib/ec2manage.rb

@@ -0,0 +1,7 @@
+module EC2Manage
+  class Commands
+    def self.start
+      puts "hello world"
+    end
+  end
+end

metadata

@@ -0,0 +1,123 @@
+--- !ruby/object:Gem::Specification 
+name: ec2manage
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- Mat Schaffer
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-07-09 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: thor
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        - 13
+        - 7
+        version: 0.13.7
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: json
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 1
+        - 4
+        - 3
+        version: 1.4.3
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: right_aws
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - "="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 2
+        - 0
+        - 0
+        version: 2.0.0
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id004
+description: |
+  ec2manage is a command line tool for managing EC2 instances.
+  
+  It's main goal is to provide the same style of control as the
+  Amazon EC2 API Tools but with additional structure and metadata
+  make administrative decisions easier.
+
+email: mat@schaffer.me
+executables: 
+- ec2manage
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.md
+- bin/ec2manage
+- lib/ec2manage.rb
+has_rdoc: false
+homepage: http://matschaffer.com
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: suppress_warnings
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: A command-line manager for EC2 instances.
+test_files: []
+