mulder 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 44712c7a381d8ee15b33ed9d69b946568d5b3f2d
+  data.tar.gz: e2b50b9c6d9e3ceb02be3330d9069808d18ecaad
+SHA512:
+  metadata.gz: 614965a919802992a0910ea806fc4e73d2df8a54272e842eeed056fac43fa65d5c6d7030854174801cb9301c2b376abc44e2527dd6af9e26508e00a3af199813
+  data.tar.gz: 3859cfc374268011ba7b9607c29b9efbbe8a18030b0e130f86e2f4c8fca83f83508202de8465dc9be51b327cacf0a715b535e55bf840d1bad37aa00854484533

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+_yardoc
+coverage
+config/aws.yml
+doc/
+Gemfile.lock
+InstalledFiles
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp

data/.rspec

@@ -0,0 +1 @@
+--color

data/.ruby-gemset

@@ -0,0 +1 @@
+mulder

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.0.0-p247

data/.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+rvm:
+  - 2.0.0

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2013 ShopKeep POS
+
+MIT License
+
+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.markdown

@@ -0,0 +1,60 @@
+# Mulder
+
+A deploy-time helper for your AWS AutoScaling groups, and servers. Discover the IP addresses of your instances by AutoScalingGroup.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'mulder'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install mulder
+
+## Usage
+
+### Capistrano
+
+At the top of your `deploy.rb` file, add:
+
+    require 'mulder/capistrano'
+
+Configure some variables for later use:
+
+    set :application, 'banana_sandwich'
+    set :environment, 'production'
+    set :aws_creds,   '/foo/config/aws.yml'
+    set :mulder,      { Mulder::Capistrano.new(aws_creds, environment, application) }
+
+Setting up your `worker` role:
+
+    role :worker, *mulder.ips('WorkerServerGroup')
+
+And your `app` role:
+
+    role(:app, *mulder.ips('AppServerGroup')
+
+And your `web` role:
+
+    role :web, *mulder.ips('WebServerGroup')
+
+And your `db` role:
+
+    role :db, mulder.ips('WorkerServerGroup').first, primary: true
+
+You can ask for private IPs as well:
+
+    role :app, *mulder.ips('WorkerServerGroup', true)
+
+## Contributing
+
+1. Fork it
+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 new Pull Request

data/Rakefile

@@ -0,0 +1,6 @@
+require 'bundler/gem_tasks'
+require 'rspec/core/rake_task'
+
+RSpec::Core::RakeTask.new(:spec)
+
+task :default => :spec

data/config/aws.example.yml

@@ -0,0 +1,2 @@
+aws_access_key_id: TEST
+aws_secret_access_key: TEST

data/lib/mulder.rb

@@ -0,0 +1,9 @@
+module Mulder
+
+  require_relative 'mulder/client'
+  require_relative 'mulder/config'
+  require_relative 'mulder/connection'
+  require_relative 'mulder/instance'
+  require_relative 'mulder/version'
+
+end

data/lib/mulder/capistrano.rb

@@ -0,0 +1,23 @@
+require 'mulder'
+
+module Mulder
+  class Capistrano
+
+    def initialize(config_file, application, environment)
+      config       = ::Mulder::Config.from(:yaml, file: config_file)
+      @connection  = ::Mulder::Connection.new(config)
+      @application = application
+      @environment = environment
+    end
+
+    def client(role)
+      @client ||= ::Mulder::Client.new(@connection, @application, @environment, role)
+    end
+
+    def ips(role, use_private = false)
+      type_of_ips = use_private ? :private_ip_address : :public_ip_address
+
+      client(role).instances.collect(&type_of_ips).compact
+    end
+  end
+end

data/lib/mulder/client.rb

@@ -0,0 +1,28 @@
+module Mulder
+  class Client
+
+    attr_reader :app, :role, :environment
+
+    def initialize(connection, app, environment, role)
+      @connection  = connection
+      @app         = app
+      @environment = environment
+      @role        = role
+    end
+
+    def group
+      @connection.group_by_id_regexp(id_regexp)
+    end
+
+    def instances
+      @connection.instances_by_group(group)
+    end
+
+    private
+
+      def id_regexp
+        /^#{@app}-#{@environment}-#{@role}-.*$/i
+      end
+
+  end
+end

data/lib/mulder/config.rb

@@ -0,0 +1,8 @@
+require 'isomer'
+
+module Mulder
+  class Config < Isomer::Base
+    parameter :aws_access_key_id
+    parameter :aws_secret_access_key
+  end
+end

data/lib/mulder/connection.rb

@@ -0,0 +1,44 @@
+require 'fog'
+
+module Mulder
+  class Connection
+
+    attr_reader :config
+
+    def initialize(config)
+      @config = config
+    end
+
+    def group_by_id_regexp(id_regexp)
+      autoscaler.groups.find_all do |group|
+        group.id =~ id_regexp
+      end.last
+    end
+
+    def instances_by_group(group)
+      group.instances.collect do |instance|
+        compute_instance = server_by_instance_id(instance.id)
+        Mulder::Instance.new(compute_instance)
+      end
+    end
+
+    def server_by_instance_id(instance_id)
+      compute.servers.get(instance_id)
+    end
+
+    def autoscaler
+      @autoscaler ||= ::Fog::AWS::AutoScaling.new(
+        :aws_access_key_id => @config.aws_access_key_id,
+        :aws_secret_access_key => @config.aws_secret_access_key
+      )
+    end
+
+    def compute
+      @compute ||= ::Fog::Compute::AWS.new(
+        :aws_access_key_id => @config.aws_access_key_id,
+        :aws_secret_access_key => @config.aws_secret_access_key
+      )
+    end
+
+  end
+end

data/lib/mulder/instance.rb

@@ -0,0 +1,47 @@
+require 'json'
+
+module Mulder
+  class Instance
+
+    attr_reader :fog_compute_instance
+
+    def initialize(fog_compute_instance)
+      @fog_compute_instance = fog_compute_instance
+    end
+
+    def id
+      @fog_compute_instance.id
+    end
+
+    def dns_name
+      @fog_compute_instance.dns_name
+    end
+
+    def public_ip_address
+      @fog_compute_instance.public_ip_address
+    end
+
+    def private_ip_address
+      @fog_compute_instance.private_ip_address
+    end
+
+    def vpc_id
+      @fog_compute_instance.vpc_id
+    end
+
+    def created_at
+      @fog_compute_instance.created_at
+    end
+
+    def as_hash
+      @as_hash ||= {
+        id: id,
+        dns_name: dns_name,
+        public_ip_address: public_ip_address,
+        private_ip_address: private_ip_address,
+        vpc_id: vpc_id,
+        created_at: created_at
+      }.delete_if { |_, value| value == '' || value == nil }
+    end
+  end
+end

data/lib/mulder/version.rb

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

data/mulder.gemspec

@@ -0,0 +1,30 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'mulder/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'mulder'
+  spec.version       = Mulder::VERSION
+  spec.authors       = ['Duncan Grazier']
+  spec.email         = ['itsmeduncan@gmail.com']
+  spec.description   = %q{Discover information about AWS Autoscaling Groups}
+  spec.summary       = %q{Autoscaling groups, and their metadata}
+  spec.homepage      = 'https://www.github.com/shopkeep/mulder'
+  spec.license       = 'MIT'
+
+  spec.files         = `git ls-files`.split($/)
+  spec.executables   = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files    = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.3'
+  spec.add_development_dependency 'mocha', '~> 0.14.0'
+  spec.add_development_dependency 'rake'
+  spec.add_development_dependency 'rspec', '~> 2.14.1'
+  spec.add_development_dependency 'simplecov', '~> 0.7.1'
+
+  spec.add_dependency 'fog', '~> 1.15.0'
+  spec.add_dependency 'isomer', '~> 0.1.3'
+  spec.add_dependency 'thor', '~> 0.18.1'
+end

data/spec/lib/mulder/capistrano_spec.rb

@@ -0,0 +1,45 @@
+require 'spec_helper'
+require 'mulder/capistrano'
+
+describe Mulder::Capistrano do
+
+  describe '#client' do
+    it 'instantiates a new client with the correct role' do
+      mocked_connection = mock
+      mocked_config = mock
+      Mulder::Config.expects(:from).returns(mocked_config)
+      Mulder::Connection.expects(:new).returns(mocked_connection)
+
+      capistrano = described_class.new('foo', 'bar', 'widget')
+      ::Mulder::Client.expects(:new).with(mocked_connection, 'bar', 'widget', 'ROLE')
+
+      capistrano.client('ROLE')
+    end
+  end
+
+  describe '.ips' do
+    it 'it returns the public ips for the client' do
+      mocked_connection = mock
+      mocked_config = mock
+      Mulder::Config.expects(:from).returns(mocked_config)
+      Mulder::Connection.expects(:new).returns(mocked_connection)
+
+      capistrano = described_class.new('foo', 'bar', 'widget')
+      capistrano.expects(:client).with('bananas').returns(mock(instances: [mock(public_ip_address: 'foo')]))
+
+      capistrano.ips('bananas').should == ['foo']
+    end
+
+    it 'returns the private ips for the client' do
+      mocked_connection = mock
+      mocked_config = mock
+      Mulder::Config.expects(:from).returns(mocked_config)
+      Mulder::Connection.expects(:new).returns(mocked_connection)
+
+      capistrano = described_class.new('foo', 'bar', 'widget')
+      capistrano.expects(:client).with('bananas').returns(mock(instances: [mock(private_ip_address: 'foo')]))
+
+      capistrano.ips('bananas', true).should == ['foo']
+    end
+  end
+end

data/spec/lib/mulder/client_spec.rb

@@ -0,0 +1,39 @@
+require 'spec_helper'
+
+describe Mulder::Client do
+
+  describe '.initialize' do
+    let(:mocked_connection) { mock }
+
+    it 'stores the app' do
+      described_class.new(mocked_connection, 'foo', 'bar', 'worker').app.should == 'foo'
+    end
+
+    it 'stores the environment' do
+      described_class.new(mocked_connection, 'foo', 'bar', 'worker').environment.should == 'bar'
+    end
+  end
+
+  describe '#group' do
+    it 'finds the correct group based on the given attributes' do
+      mocked_connection = mock
+      mocked_connection.expects(:group_by_id_regexp).with(/^foo-bar-WorkerGroup-.*$/i)
+      client = described_class.new(mocked_connection, 'foo', 'bar', 'WorkerGroup')
+
+      client.group
+    end
+  end
+
+  describe '#instances' do
+    it 'finds the instances for the group' do
+      mocked_connection = mock
+      mocked_group = mock
+      mocked_connection.expects(:instances_by_group).with(mocked_group)
+      client = described_class.new(mocked_connection, 'foo', 'bar', 'worker')
+      client.expects(:group).returns(mocked_group)
+
+      client.instances
+    end
+  end
+
+end

data/spec/lib/mulder/connection_spec.rb

@@ -0,0 +1,73 @@
+require 'spec_helper'
+
+describe Mulder::Connection do
+
+  let(:config) { stub(aws_access_key_id: 'foo', aws_secret_access_key: 'bar') }
+  let(:connection) { described_class.new(config) }
+
+  describe ".new" do
+    it 'stores the config' do
+      connection.config.should == config
+    end
+  end
+
+  describe "#autoscaler" do
+    it 'initializes a Fog::AWS::AutoScaling' do
+      Fog::AWS::AutoScaling.expects(:new)
+      connection.autoscaler
+    end
+
+    it 'memoizes the initalized Fog::AWS::AutoScaling' do
+      Fog::AWS::AutoScaling.expects(:new).once.returns(mock)
+      2.times { connection.autoscaler }
+    end
+  end
+
+  describe "#compute" do
+    it 'initializes a Fog::Compute::AWS' do
+      Fog::Compute::AWS.expects(:new)
+      connection.compute
+    end
+
+    it 'memoizes the initalized Fog::Compute::AWS' do
+      ::Fog::Compute::AWS.expects(:new).once.returns(mock)
+      2.times { connection.compute }
+    end
+  end
+
+  describe "#group_by_id_regexp" do
+    it 'finds all of the groups whose id matches the regexp' do
+      mocked_group  = mock(id: 'foo-bar')
+      connection = described_class.new(config)
+      connection.expects(:autoscaler).returns(mock(groups: [mocked_group]))
+
+      connection.group_by_id_regexp(/foo-bar/).should == mocked_group
+    end
+  end
+
+  describe "#instances_by_group" do
+    it 'finds the instances for the group and returns Mulder::Instances' do
+      mocked_instance = mock(id: 'foo')
+      compute_instance = mock
+      mocked_group = mock(instances: [mocked_instance])
+      connection = described_class.new(config)
+      connection.expects(:server_by_instance_id).with('foo').returns(compute_instance)
+      Mulder::Instance.expects(:new).with(compute_instance)
+      connection.instances_by_group(mocked_group)
+    end
+  end
+
+  describe "#server_by_instance_id" do
+    it 'finds the compute connections server by the given id' do
+      mocked_compute  = mock
+      mocked_servers  = mock
+
+      connection = described_class.new(config)
+      connection.expects(:compute).returns(mocked_compute)
+      mocked_compute.expects(:servers).returns(mocked_servers)
+      mocked_servers.expects(:get).with('foo').returns('bar')
+      connection.server_by_instance_id('foo').should == 'bar'
+    end
+  end
+
+end

data/spec/lib/mulder/instance_spec.rb

@@ -0,0 +1,34 @@
+require 'spec_helper'
+
+describe Mulder::Instance do
+
+  let(:attributes) { { id: "i-f17bf19e", dns_name: 'foo.example.org', public_ip_address: '10.0.0.2', private_ip_address: '10.1.1.1', vpc_id: 'vpc-e9663d87', created_at: DateTime.parse('2013-09-10 19:39:26 UTC').to_s } }
+
+  describe '.new' do
+    it 'stores the fog computer instance' do
+      fog_compute_instance = mock
+      described_class.new(fog_compute_instance).fog_compute_instance.should == fog_compute_instance
+    end
+  end
+
+  describe '#as_hash' do
+    let(:instance) { mock(attributes) }
+
+    it 'has the expected attributes' do
+      described_class.new(instance).as_hash.should == attributes
+    end
+
+    it 'rejects blank values' do
+      instance = mock(attributes.merge(id: ''))
+      described_class.new(instance).as_hash.should ==
+        attributes.reject { |key, _| key == :id }
+    end
+
+    it 'rejects nil values' do
+      instance = mock(attributes.merge(id: nil))
+      described_class.new(instance).as_hash.should ==
+        attributes.reject { |key, _| key == :id }
+    end
+  end
+
+end

data/spec/lib/mulder_spec.rb

@@ -0,0 +1,5 @@
+require 'spec_helper'
+
+describe Mulder do
+
+end

data/spec/spec_helper.rb

@@ -0,0 +1,23 @@
+require 'simplecov'
+SimpleCov.start
+
+$LOAD_PATH.unshift File.expand_path('../../lib', __FILE__)
+require 'mulder'
+require 'mocha/api'
+
+RSpec.configure do |config|
+
+  config.treat_symbols_as_metadata_keys_with_true_values = true
+
+  config.run_all_when_everything_filtered = true
+
+  config.filter_run :focus
+
+  config.mock_with :mocha
+
+  config.order = 'random'
+
+  config.before(:suite) do
+    Fog.mock!
+  end
+end

metadata

@@ -0,0 +1,188 @@
+--- !ruby/object:Gem::Specification
+name: mulder
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Duncan Grazier
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-09-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.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '1.3'
+- !ruby/object:Gem::Dependency
+  name: mocha
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.14.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.14.0
+- !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: 2.14.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 2.14.1
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.7.1
+- !ruby/object:Gem::Dependency
+  name: fog
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.15.0
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 1.15.0
+- !ruby/object:Gem::Dependency
+  name: isomer
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.1.3
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.1.3
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.18.1
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.18.1
+description: Discover information about AWS Autoscaling Groups
+email:
+- itsmeduncan@gmail.com
+executables:
+- .gitkeep
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- .rspec
+- .ruby-gemset
+- .ruby-version
+- .travis.yml
+- Gemfile
+- LICENSE.txt
+- README.markdown
+- Rakefile
+- bin/.gitkeep
+- config/aws.example.yml
+- lib/mulder.rb
+- lib/mulder/capistrano.rb
+- lib/mulder/client.rb
+- lib/mulder/config.rb
+- lib/mulder/connection.rb
+- lib/mulder/instance.rb
+- lib/mulder/version.rb
+- mulder.gemspec
+- spec/lib/mulder/capistrano_spec.rb
+- spec/lib/mulder/client_spec.rb
+- spec/lib/mulder/connection_spec.rb
+- spec/lib/mulder/instance_spec.rb
+- spec/lib/mulder_spec.rb
+- spec/spec_helper.rb
+homepage: https://www.github.com/shopkeep/mulder
+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.0.6
+signing_key: 
+specification_version: 4
+summary: Autoscaling groups, and their metadata
+test_files:
+- spec/lib/mulder/capistrano_spec.rb
+- spec/lib/mulder/client_spec.rb
+- spec/lib/mulder/connection_spec.rb
+- spec/lib/mulder/instance_spec.rb
+- spec/lib/mulder_spec.rb
+- spec/spec_helper.rb