cloudutil 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1409a2b9cdb13ae5236b4d4f70fb4eec0b16f47d
+  data.tar.gz: 6ae2a2a2554cc5af1f2ea34e394a89deea8112f3
+SHA512:
+  metadata.gz: f087f0aa8a8ff7202e2bbf8016d6f653e21b617210b72abdfeb8bc2fdbc3f10346f4a2393136c1ee9a091317904e0f1236c8bbab117cc570f0e1b29c245262ad
+  data.tar.gz: 5f83cf1c8de01886765863a7ca87693ccd644d0c4ed9962a03093a85f066fc149386795994ba156a4cb8d7bd8b27bf96c7edcf94b1e0775e39b2ff893dfb974a

data/.gitignore

@@ -0,0 +1,41 @@
+*.gem
+*.rbc
+/.config
+/coverage/
+/InstalledFiles
+/pkg/
+/spec/reports/
+/test/tmp/
+/test/version_tmp/
+/tmp/
+
+## Specific to RubyMotion:
+.dat*
+.repl_history
+build/
+
+## Documentation cache and generated files:
+/.yardoc/
+/_yardoc/
+/doc/
+/rdoc/
+
+## Environment normalisation:
+/.bundle/
+/lib/bundler/man/
+
+# for a library or gem, you might want to ignore these files since the code is
+# intended to run in multiple environments; otherwise, check them in:
+# Gemfile.lock
+# .ruby-version
+# .ruby-gemset
+
+# unless supporting rvm < 1.11.0 or doing something fancy, ignore this:
+.rvmrc
+
+Gemfile.lock
+*.bundle
+*.so
+*.o
+*.a
+mkmf.log

data/.rubocop.yml

@@ -0,0 +1,24 @@
+Encoding:
+  Enabled: false
+
+NumericLiterals:
+  Enabled: false
+
+ClassLength:
+  Max: 200
+
+MethodLength:
+  Max: 25
+
+LineLength:
+  Max: 128
+
+HashSyntax:
+  Exclude:
+    - Rakefile
+
+CyclomaticComplexity:
+  Max: 10
+
+PerceivedComplexity:
+  Max: 10

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in cloudutil.gemspec
+gemspec

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2014 Mike Morris
+
+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.

data/README.md

@@ -0,0 +1,38 @@
+# Cloudutil
+
+A utility library for performing helpful tasks with various cloud platform providers
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'cloudutil'
+
+And then execute:
+
+    $ bundle install
+
+Or install it yourself as:
+
+    $ gem install cloudutil
+
+## Usage
+
+For AWS helpers:
+
+    require 'cloudutil/aws'
+
+    aws = Cloudutil::AWS(config: existing_AWS::Config_object) -or-
+    aws = Cloudutil::AWS(access_key: your_AWS_access_key, secret_key: your_AWS_secret_key)
+
+    subnet_id  = aws.resolve_subnet_id('my_subnet_name_or_tag')
+    sec_grp_id = aws.resolve_subnet_id('my_security_group_name_or_tag')
+    ami_id = aws.resolve_subnet_id('my_ami_name_or_tag')
+
+## Contributing
+
+1. Fork it ( https://github.com/mmmorris1975/cloudutil/fork )
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create a new Pull Request

data/Rakefile

@@ -0,0 +1,29 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+gem_dir = ::File.dirname(__FILE__)
+
+desc 'Rubocop'
+task :rc => [:rubocop]
+task :rubocop do
+  sh "bundle exec rubocop -D #{gem_dir}"
+end
+
+task default: [:rc] do
+  Rake::Task[:spec].invoke('progress', %w(~slow ~account_specific))
+end
+
+desc 'Run rspec'
+RSpec::Core::RakeTask.new(:spec, [:format, :tags]) do |t, args|
+  format = args[:format] || 'documentation'
+  tags = args[:tags] || []
+  t.verbose = false
+  t.fail_on_error = true
+  t.rspec_opts = "--format=#{format}"
+
+  tags.flatten.compact.each do |tag|
+    t.rspec_opts += " --tag #{tag}"
+  end
+
+  t.ruby_opts = '-W0'
+end

data/cloudutil.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'cloudutil/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'cloudutil'
+  spec.version       = Cloudutil::VERSION
+  spec.authors       = ['Mike Morris']
+  spec.email         = ['michael.m.morris@pearson.com']
+  spec.summary       = 'A utility library for performing helpful tasks with various cloud platform providers'
+  spec.description   = IO.read(File.join(File.dirname(__FILE__), 'README.md'))
+  spec.homepage      = ''
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files -z`.split("\x0")
+  spec.executables   = spec.files.grep(/^bin\//) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(/^(test|spec|features)\//)
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.6'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec'
+  spec.add_development_dependency 'rubocop'
+
+  spec.add_dependency 'aws-sdk', '~> 1.44'
+end

data/lib/cloudutil/aws/core.rb

@@ -0,0 +1,92 @@
+require 'aws-sdk'
+
+module Cloudutil
+  module AWS
+    # Class containing common methods and attributes for interfacing with AWS
+    class Core
+      DEFAULT_REGION = 'us-east-1'
+
+      attr_writer :region
+      attr_writer :access_key
+      attr_writer :secret_key
+
+      # Initialize an instance of this class.  Will accept options as a hash, or an array,
+      # with hash form being preferred.  There are no required parameters for this method.
+      #
+      # Array args must be in the order of: AWS region, AWS access key, AWS secret key.
+      #
+      # Supported hash option keys are:
+      #  - config (an pre-built AWS::config object to use for API calls)
+      #  - region (the AWS region to make API calls to)
+      #  - access_key (the AWS access key to use for API authentication)
+      #  - secret_key (the AWS secret key to use for API authentication)
+      #
+      # If no AWS::config object was passed, this class's config method will automatically
+      # be called to create one
+      #
+      def initialize(*args)
+        if args.respond_to? :to_h
+          _process_hash_init(args.to_h)
+        elsif args[0].respond_to? :to_h
+          _process_hash_init(args[0].to_h)
+        else
+          _process_array_init(args.flatten)
+        end
+
+        config(true) if @config.nil?
+      end
+
+      # Getter for the 'region' attribute, uses DEFAULT_REGION
+      # if not explicitly set
+      def region
+        @region = DEFAULT_REGION if !@region || @region.length < 1
+        @region
+      end
+
+      # Getter for the 'access_key' attribute, will use values of the
+      # AWS_ACCESS_KEY_ID or AWS_ACCESS_KEY env vars, if not explicitly set
+      def access_key
+        if !@access_key || @access_key.length < 1
+          @access_key = ENV['AWS_ACCESS_KEY_ID'] || ENV['AWS_ACCESS_KEY'] || nil
+        end
+
+        @access_key
+      end
+
+      # Getter for the 'secret_key' attribute, will use values of the
+      # AWS_SECRET_ACCESS_KEY or AWS_SECRET_KEY env vars, if not explicitly set
+      def secret_key
+        if !@secret_key || @secret_key.length < 1
+          @secret_key = ENV['AWS_SECRET_ACCESS_KEY'] || ENV['AWS_SECRET_KEY'] || nil
+        end
+
+        @secret_key
+      end
+
+      # Create (if not already existing) and return an AWS::config object.
+      # If creating a new AWS::config object, will make calls to this class's
+      # region, access_key, and secret_key methods to populate the config data
+      def config(reconfig = false)
+        if !@config || reconfig
+          @config = ::AWS.config(region: region, access_key_id: access_key, secret_access_key: secret_key)
+        end
+
+        @config
+      end
+
+      private
+
+      def _process_hash_init(args)
+        return unless args
+        @config = args[:config]
+        @region = args[:region]
+        @access_key = args[:access_key]
+        @secret_key = args[:secret_key]
+      end
+
+      def _process_array_init(args)
+        _process_hash_init(region: args[0], access_key: args[1], secret_key: args[2]) if args
+      end
+    end
+  end
+end

data/lib/cloudutil/aws/ec2.rb

@@ -0,0 +1,203 @@
+require_relative './core'
+
+module Cloudutil
+  module AWS
+    # A class of utility methods for the AWS EC2 service
+    class EC2 < Cloudutil::AWS::Core
+      # Resolve the provided value to an AWS subnet id.  By default, the search is not case-sensitive,
+      # but that can be overridden by supplying 'false' as a second argument to this method.
+      # Will return the 1st value in a set, if multiple values returned.
+      def resolve_subnet_id(subnet, ignore_case = true)
+        obj = lookup_subnet(subnet, ignore_case).first
+        return obj.subnet_id unless obj.nil?
+        nil
+      end
+
+      # Resolve the provided value to an array of AWS subnet objects.  By default, the search is not
+      # case-sensitive, but that can be overridden by supplying 'false' as a second argument to this method.
+      def lookup_subnet(subnet, ignore_case = true, nap = 2, retries = 5)
+        ec2 = ::AWS::EC2.new
+        subnets = []
+
+        begin
+          if aws_subnet_id? subnet
+            subnets << ec2.subnets[subnet]
+          else
+            subnets = do_subnet_lookup(ec2.subnets.filter('state', 'available'), subnet, ignore_case)
+          end
+        rescue ::AWS::EC2::Errors::RequestLimitExceeded, ::AWS::Errors::ServerError
+          raise if retries < 1
+          sleep nap
+          lookup_subnet(subnet, ignore_case, (nap * 2), (retries - 1))
+        end
+
+        subnets
+      end
+
+      # Returns true if the supplied value looks like an AWS subnet id
+      def aws_subnet_id?(subnet)
+        return true if subnet.match(/^subnet-\h{8,}$/)
+        false
+      end
+
+      # Resolve the provided value to an AWS sec group id.  By default, the search is not case-sensitive,
+      # but that can be overridden by supplying 'false' as a second argument to this method.
+      # Will return the 1st value in a set, if multiple values returned.
+      def resolve_security_group_id(group, ignore_case = true)
+        obj = lookup_security_group(group, ignore_case).first
+        return obj.security_group_id unless obj.nil?
+        nil
+      end
+
+      # Resolve the provided value to an array of AWS sec group objects.  By default, the search is not
+      # case-sensitive, but that can be overridden by supplying 'false' as a second argument to this method.
+      def lookup_security_group(group, ignore_case = true, nap = 2, retries = 5)
+        ec2 = ::AWS::EC2.new
+        groups = []
+
+        begin
+          if aws_security_group_id? group
+            groups << ec2.security_groups[group]
+          else
+            groups = do_security_group_lookup_by_name(ec2, group, ignore_case)
+            groups = do_security_group_lookup_by_name_tag(ec2, group, ignore_case) if groups.nil? || groups.empty?
+          end
+        rescue ::AWS::EC2::Errors::RequestLimitExceeded, ::AWS::Errors::ServerError
+          raise if retries < 1
+          sleep nap
+          lookup_security_group(group, ignore_case, (nap * 2), (retries - 1))
+        end
+
+        groups
+      end
+
+      # Returns true if the supplied value looks like an AWS security group id
+      def aws_security_group_id?(group)
+        return true if group.match(/^sg-\h{8,}$/)
+        false
+      end
+
+      # Resolve the provided value to an AWS AMI id.  By default, the search is not case-sensitive,
+      # but that can be overridden by supplying 'false' as a second argument to this method.
+      # Will return the 1st value in a set, if multiple values returned.
+      def resolve_ami_id(ami, ignore_case = true)
+        obj = lookup_ami(ami, ignore_case).first
+        return obj.image_id unless obj.nil?
+        nil
+      end
+
+      # Resolve the provided value to an array of AWS AMI objects.  By default, the search is not
+      # case-sensitive, but that can be overridden by supplying 'false' as a second argument to this method.
+      def lookup_ami(ami, ignore_case = true, nap = 2, retries = 5)
+        ec2 = ::AWS::EC2.new
+        amis = []
+
+        begin
+          if aws_ami_id? ami
+            amis << ec2.images[ami]
+          else
+            # Don't bother memoizing, this is fast
+            imgs = ec2.images.filter('image-type', 'machine').filter('state', 'available')
+
+            amis = do_ami_lookup_by_name_tag(imgs, ami, ignore_case)
+            amis = do_private_ami_lookup_by_name(imgs, ami, ignore_case) if amis.nil? || amis.empty?
+            amis = do_ami_lookup_by_name(imgs, ami, ignore_case) if amis.nil? || amis.empty?
+          end
+        rescue ::AWS::EC2::Errors::RequestLimitExceeded, ::AWS::Errors::ServerError
+          raise if retries < 1
+          sleep nap
+          lookup_ami(ami, ignore_case, (nap * 2), (retries - 1))
+        end
+
+        amis
+      end
+
+      # Returns true if the supplied value looks like an AWS AMI id
+      def aws_ami_id?(ami)
+        return true if ami.match(/^ami-\h{8,}$/)
+        false
+      end
+
+      protected
+
+      # Find an AMI based on the value of the 'Name' tag
+      def do_ami_lookup_by_name_tag(filter, ami, ignore_case)
+        # Using memoization, this is fast, relativly speaking (can be < 1 sec, 15-20 sec w/o memoization)
+        ::AWS.memoize do
+          if ignore_case
+            filter.tagged('Name')
+              .select { |obj| !obj.tags.Name.nil? && obj.tags.Name.casecmp(ami) == 0 }
+          else
+            filter.tagged('Name')
+              .select { |obj| !obj.tags.Name.nil? && obj.tags.Name.eql?(ami) }
+          end
+        end
+      end
+
+      # Find a non-public AMI based on the value of the AMI's name property
+      def do_private_ami_lookup_by_name(filter, ami, ignore_case)
+        # Do lookup of non-public AMIs we have access to.  This should be a really short list,
+        # so it should come back pretty fast
+        ::AWS.memoize do
+          if ignore_case
+            filter.filter('is-public', 'false')
+              .select { |obj| !obj.name.nil? && obj.name.casecmp(ami) == 0 }
+          else
+            filter.filter('is-public', 'false')
+              .select { |obj| !obj.name.nil? && obj.name.eql?(ami) }
+          end
+        end
+      end
+
+      # Find an AMI based on the value of the AMI's name property
+      def do_ami_lookup_by_name(filter, ami, ignore_case)
+        # This is an absolute pig of a lookup (30+ sec to return), that's why we do it after the faster tag
+        # and private AMI lookups. Otherwise this code ends up inspecting all 31k+ public AMIs on AWS
+        ::AWS.memoize do
+          if ignore_case
+            filter.select { |obj| !obj.name.nil? && obj.name.casecmp(ami) == 0 }
+          else
+            filter.select { |obj| !obj.name.nil? && obj.name.eql?(ami) }
+          end
+        end
+      end
+
+      # Find a VPC subnet based on the 'Name' tag (subnets don't have a name attribute)
+      def do_subnet_lookup(filter, subnet, ignore_case)
+        ::AWS.memoize do
+          if ignore_case
+            filter.tagged('Name')
+              .select { |obj| !obj.tags.Name.nil? && obj.tags.Name.casecmp(subnet) == 0 }
+          else
+            filter.tagged('Name')
+              .select { |obj| !obj.tags.Name.nil? && obj.tags.Name.eql?(subnet) }
+          end
+        end
+      end
+
+      # Find a VPC security group based on the name attribute
+      def do_security_group_lookup_by_name(ec2, group, ignore_case)
+        ::AWS.memoize do
+          if ignore_case
+            ec2.security_groups.select { |obj| !obj.name.nil? && obj.name.casecmp(group) == 0 }
+          else
+            ec2.security_groups.select { |obj| !obj.name.nil? && obj.name.eql?(group) }
+          end
+        end
+      end
+
+      # Find a VPC security group based on the 'Name' tag
+      def do_security_group_lookup_by_name_tag(ec2, group, ignore_case)
+        ::AWS.memoize do
+          if ignore_case
+            ec2.security_groups.tagged('Name')
+              .select { |obj| !obj.tags.Name.nil? && obj.tags.Name.casecmp(group) == 0 }
+          else
+            ec2.security_groups.tagged('Name')
+              .select { |obj| !obj.tags.Name.nil? && obj.tags.Name.eql?(group) }
+          end
+        end
+      end
+    end
+  end
+end

data/lib/cloudutil/aws.rb

@@ -0,0 +1 @@
+require_relative './aws/ec2'

data/lib/cloudutil/version.rb

@@ -0,0 +1,4 @@
+# Module to hold the version number for this library
+module Cloudutil
+  VERSION = '0.0.1'
+end

data/lib/cloudutil.rb

@@ -0,0 +1,2 @@
+require 'cloudutil/version'
+require 'cloudutil/aws'

data/spec/aws_core_spec.rb

@@ -0,0 +1,107 @@
+require_relative '../lib/cloudutil/aws.rb'
+
+describe Cloudutil::AWS::Core do
+  context 'object initialization' do
+    my_env = ENV.to_h
+
+    it 'creates an object using primary env vars' do
+      ENV.clear
+      ENV['AWS_ACCESS_KEY_ID'] = 'my_primary_access_key'
+      ENV['AWS_SECRET_ACCESS_KEY'] = 'my_primary_secret_key'
+
+      aws = Cloudutil::AWS::Core.new
+
+      expect(aws.region).to eq 'us-east-1'
+      expect(aws.access_key).to eq 'my_primary_access_key'
+      expect(aws.secret_key).to eq 'my_primary_secret_key'
+    end
+
+    it 'creates an object using secondary env vars' do
+      ENV.clear
+      ENV['AWS_ACCESS_KEY'] = 'my_secondary_access_key'
+      ENV['AWS_SECRET_KEY'] = 'my_secondary_secret_key'
+
+      aws = Cloudutil::AWS::Core.new
+
+      expect(aws.region).to eq 'us-east-1'
+      expect(aws.access_key).to eq 'my_secondary_access_key'
+      expect(aws.secret_key).to eq 'my_secondary_secret_key'
+    end
+
+    it 'creates an object without env vars' do
+      ENV.clear
+
+      aws = Cloudutil::AWS::Core.new
+
+      expect(aws.region).to eq 'us-east-1'
+      expect(aws.access_key).to be_nil
+      expect(aws.secret_key).to be_nil
+    end
+
+    ENV.update(my_env)
+
+    it 'creates an object using implicit hash args' do
+      reg = 'us-west-1'
+      ak  = 'my_access_key1'
+      sk  = 'my_secret_key1'
+
+      aws = Cloudutil::AWS::Core.new(region: reg, access_key: ak, secret_key: sk)
+
+      expect(aws.region).to eq reg
+      expect(aws.access_key).to eq ak
+      expect(aws.secret_key).to eq sk
+    end
+
+    it 'creates an object using explicit hash args' do
+      reg = 'us-west-2'
+      ak  = 'my_access_key2'
+      sk  = 'my_secret_key2'
+
+      aws = Cloudutil::AWS::Core.new(region: reg, access_key: ak, secret_key: sk)
+
+      expect(aws.region).to eq reg
+      expect(aws.access_key).to eq ak
+      expect(aws.secret_key).to eq sk
+    end
+
+    it 'creates an object using sparse hash args' do
+      aws = Cloudutil::AWS::Core.new(access_key: 'test_key')
+
+      expect(aws.region).to eq 'us-east-1'
+      expect(aws.access_key).to eq 'test_key'
+      expect(aws.secret_key).to_not be_nil if ENV['AWS_SECRET_ACCESS_KEY']
+    end
+
+    it 'creates an object using implicit array args' do
+      reg = 'us-west-1'
+      ak  = 'my_access_key3'
+      sk  = 'my_secret_key3'
+
+      aws = Cloudutil::AWS::Core.new(region: reg, access_key: ak, secret_key: sk)
+
+      expect(aws.region).to eq reg
+      expect(aws.access_key).to eq ak
+      expect(aws.secret_key).to eq sk
+    end
+
+    it 'creates an object using explicit array args' do
+      reg = 'us-west-2'
+      ak  = 'my_access_key4'
+      sk  = 'my_secret_key4'
+
+      aws = Cloudutil::AWS::Core.new(region: reg, access_key: ak, secret_key: sk)
+
+      expect(aws.region).to eq reg
+      expect(aws.access_key).to eq ak
+      expect(aws.secret_key).to eq sk
+    end
+
+    it 'creates an object using sparse array args' do
+      aws = Cloudutil::AWS::Core.new('us-west-2')
+
+      expect(aws.region).to eq 'us-west-2'
+      expect(aws.access_key).to_not be_nil if ENV['AWS_ACCESS_KEY_ID']
+      expect(aws.secret_key).to_not be_nil if ENV['AWS_SECRET_ACCESS_KEY']
+    end
+  end
+end

data/spec/aws_ec2_spec.rb

@@ -0,0 +1,170 @@
+require_relative '../lib/cloudutil/aws.rb'
+
+describe Cloudutil::AWS::EC2 do
+  context 'object initialization' do
+    it 'creates an object using primary env vars' do
+      ENV.clear
+      ENV['AWS_ACCESS_KEY_ID'] = 'my_primary_access_key'
+      ENV['AWS_SECRET_ACCESS_KEY'] = 'my_primary_secret_key'
+
+      aws = Cloudutil::AWS::EC2.new
+
+      expect(aws.region).to eq 'us-east-1'
+      expect(aws.access_key).to eq 'my_primary_access_key'
+      expect(aws.secret_key).to eq 'my_primary_secret_key'
+    end
+
+    it 'creates an object using implicit hash args' do
+      reg = 'us-west-1'
+      ak  = 'my_access_key1'
+      sk  = 'my_secret_key1'
+
+      aws = Cloudutil::AWS::EC2.new(region: reg, access_key: ak, secret_key: sk)
+
+      expect(aws.region).to eq reg
+      expect(aws.access_key).to eq ak
+      expect(aws.secret_key).to eq sk
+    end
+  end
+
+  context 'resolving VPC subnets' do
+    # Need to do this to read AWS creds from env
+    my_env = ENV.to_h
+    before(:each) do
+      @aws = Cloudutil::AWS::EC2.new(access_key: my_env['AWS_ACCESS_KEY_ID'], secret_key: my_env['AWS_SECRET_ACCESS_KEY'])
+    end
+
+    it 'returns what we passed in, if it looks like an AWS subnet id' do
+      id = @aws.resolve_subnet_id('subnet-deadbeef')
+      expect(id).to eq 'subnet-deadbeef'
+    end
+
+    it 'returns a known VPC subnet object, case-sensitive', account_specific: true do
+      id = @aws.resolve_subnet_id('vpc-private-azA', false)
+
+      expect(id).to_not be_nil
+      expect(id).to match(/^subnet-\h{8,}$/)
+    end
+
+    it 'returns a known VPC subnet object, case-insensitive', account_specific: true do
+      id = @aws.resolve_subnet_id('VPC-Private-AZa')
+
+      expect(id).to_not be_nil
+      expect(id).to match(/^subnet-\h{8,}$/)
+    end
+
+    it 'returns nil for no case-sensitive VPC subnet match', account_specific: true do
+      id = @aws.resolve_subnet_id('VPC-private-aza', false)
+      expect(id).to be_nil
+    end
+
+    it 'returns nil if given a completely bogus name' do
+      id = @aws.resolve_subnet_id('my_totally_bogus_subnet_name')
+      expect(id).to be_nil
+    end
+  end
+
+  context 'resolving security groups' do
+    my_env = ENV.to_h
+    before(:each) do
+      @aws = Cloudutil::AWS::EC2.new(access_key: my_env['AWS_ACCESS_KEY_ID'], secret_key: my_env['AWS_SECRET_ACCESS_KEY'])
+    end
+
+    it 'returns what we pass in, if it looks like an AWS security group id' do
+      id = @aws.resolve_security_group_id('sg-deadbeef')
+      expect(id).to eq 'sg-deadbeef'
+    end
+
+    it 'returns a known security group by name, case-sensitive', account_specific: true do
+      id = @aws.resolve_security_group_id('VPC_Private', false)
+
+      expect(id).to_not be_nil
+      expect(id).to match(/^sg-\h{8,}$/)
+    end
+
+    it 'returns a known security group by name, case-insensitive', account_specific: true do
+      id = @aws.resolve_security_group_id('vpc_PRIVATE')
+
+      expect(id).to_not be_nil
+      expect(id).to match(/^sg-\h{8,}$/)
+    end
+
+    it 'returns a known security group by tag, case-sensitive', account_specific: true do
+      id = @aws.resolve_security_group_id('vpc-private', false)
+
+      expect(id).to_not be_nil
+      expect(id).to match(/^sg-\h{8,}$/)
+    end
+
+    it 'returns a known security group by tag, case-insensitive', account_specific: true do
+      id = @aws.resolve_security_group_id('VPC-PrIvAtE')
+
+      expect(id).to_not be_nil
+      expect(id).to match(/^sg-\h{8,}$/)
+    end
+
+    it 'returns nil for no case-sensitive security group name or tag match', account_specific: true do
+      id = @aws.resolve_security_group_id('vpc_PrivatE', false)
+      expect(id).to be_nil
+    end
+
+    it 'returns nil if given a completely bogus name/tag value' do
+      id = @aws.resolve_subnet_id('my_totally_bogus_subnet_name')
+      expect(id).to be_nil
+    end
+  end
+
+  context 'resolving AMIs' do
+    my_env = ENV.to_h
+    before(:each) do
+      @aws = Cloudutil::AWS::EC2.new(access_key: my_env['AWS_ACCESS_KEY_ID'], secret_key: my_env['AWS_SECRET_ACCESS_KEY'])
+    end
+
+    it 'returns what we pass in, if it looks like an AWS ami id' do
+      id = @aws.resolve_ami_id('ami-deadbeef')
+      expect(id).to eq 'ami-deadbeef'
+    end
+
+    it 'returns a known AMI by name, case-sensitive', account_specific: true do
+      id = @aws.resolve_ami_id('AMIBakery-MRE-28', false)
+
+      expect(id).to_not be_nil
+      expect(id).to match(/^ami-\h{8,}$/)
+    end
+
+    it 'returns a known AMI by name, case-insensitive', account_specific: true do
+      id = @aws.resolve_ami_id('amiBAKERY-mre-28')
+
+      expect(id).to_not be_nil
+      expect(id).to match(/^ami-\h{8,}$/)
+    end
+
+    it 'returns a known AMI by tag, case-sensitive', account_specific: true do
+      id = @aws.resolve_ami_id('pearson_jenkins_ubuntu', false)
+
+      expect(id).to_not be_nil
+      expect(id).to match(/^ami-\h{8,}$/)
+    end
+
+    it 'returns a known AMI by tag, case-insensitive', account_specific: true do
+      id = @aws.resolve_ami_id('Pearson_JENKINS_uBuntu')
+
+      expect(id).to_not be_nil
+      expect(id).to match(/^ami-\h{8,}$/)
+    end
+
+    # WARNING: This test can take over a minute to run, since it has to inspect the
+    # properties of all 31k public AMIs + any private AMIs my account has access to.
+    it 'returns nil for no case-sensitive AMI name or tag match', slow: true, account_specific: true do
+      id = @aws.resolve_ami_id('amiBakery-mRe-28', false)
+      expect(id).to be_nil
+    end
+
+    # WARNING: This test can take over a minute to run, since it has to inspect the
+    # properties of all 31k public AMIs + any private AMIs my account has access to.
+    it 'returns nil if given a completly bogus name/tag value', slow: true do
+      id = @aws.resolve_ami_id('my_totally_bogus_ami_name')
+      expect(id).to be_nil
+    end
+  end
+end

metadata

@@ -0,0 +1,169 @@
+--- !ruby/object:Gem::Specification
+name: cloudutil
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Mike Morris
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-11-19 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.6'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: aws-sdk
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.44'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.44'
+description: |
+  # Cloudutil
+
+  A utility library for performing helpful tasks with various cloud platform providers
+
+  ## Installation
+
+  Add this line to your application's Gemfile:
+
+      gem 'cloudutil'
+
+  And then execute:
+
+      $ bundle install
+
+  Or install it yourself as:
+
+      $ gem install cloudutil
+
+  ## Usage
+
+  For AWS helpers:
+
+      require 'cloudutil/aws'
+
+      aws = Cloudutil::AWS(config: existing_AWS::Config_object) -or-
+      aws = Cloudutil::AWS(access_key: your_AWS_access_key, secret_key: your_AWS_secret_key)
+
+      subnet_id  = aws.resolve_subnet_id('my_subnet_name_or_tag')
+      sec_grp_id = aws.resolve_subnet_id('my_security_group_name_or_tag')
+      ami_id = aws.resolve_subnet_id('my_ami_name_or_tag')
+
+  ## Contributing
+
+  1. Fork it ( https://github.com/mmmorris1975/cloudutil/fork )
+  2. Create your feature branch (`git checkout -b my-new-feature`)
+  3. Commit your changes (`git commit -am 'Add some feature'`)
+  4. Push to the branch (`git push origin my-new-feature`)
+  5. Create a new Pull Request
+email:
+- michael.m.morris@pearson.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rubocop.yml
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- cloudutil.gemspec
+- lib/cloudutil.rb
+- lib/cloudutil/aws.rb
+- lib/cloudutil/aws/core.rb
+- lib/cloudutil/aws/ec2.rb
+- lib/cloudutil/version.rb
+- spec/aws_core_spec.rb
+- spec/aws_ec2_spec.rb
+homepage: ''
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: A utility library for performing helpful tasks with various cloud platform
+  providers
+test_files:
+- spec/aws_core_spec.rb
+- spec/aws_ec2_spec.rb