ec2_meta 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 440bc0cad223de4782e2bf03477901e0f6a9be94
+  data.tar.gz: 50a1f47e43fd18de836c4b88c64a1147aec8fd18
+SHA512:
+  metadata.gz: c6eba6b6168dcc66818f9c50ba5772efb43182f635bd49fd0750d64fb022ce98f98d005f5a30a07277aff3447adee2f7199e98428a3fb48453bfd1c3ea9f1123
+  data.tar.gz: bfd026571b5acf6b39912c607dbbe2e8c950c062d5b19a9b18091ad6f9965830d58fff3c712df5f1eec919be05d54dc09750193e05d732e0ce5c34150480b8ce

data/.coveralls.yml

@@ -0,0 +1 @@
+service_name: travis-ci

data/.gitignore

@@ -0,0 +1,47 @@
+# Created by https://www.gitignore.io
+
+### Ruby ###
+*.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/
+/vendor/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
+
+
+### Vim ###
+[._]*.s[a-w][a-z]
+[._]s[a-w][a-z]
+*.un~
+Session.vim
+.netrwhist
+*~

data/.rspec

@@ -0,0 +1,2 @@
+--format documentation
+--color

data/.travis.yml

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

data/Gemfile

@@ -0,0 +1,14 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in ec2_meta.gemspec
+gemspec
+
+group :development, :test do
+  gem 'pry-byebug'
+  gem 'gem-release'
+end
+
+group :test do
+  gem 'coveralls', require: false
+  gem 'codeclimate-test-reporter', require: false
+end

data/Gemfile.lock

@@ -0,0 +1,112 @@
+PATH
+  remote: .
+  specs:
+    ec2_meta (0.1.0)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    addressable (2.3.8)
+    ast (2.0.0)
+    astrolabe (1.3.0)
+      parser (>= 2.2.0.pre.3, < 3.0)
+    byebug (4.0.5)
+      columnize (= 0.9.0)
+    codeclimate-test-reporter (0.4.7)
+      simplecov (>= 0.7.1, < 1.0.0)
+    coderay (1.1.0)
+    columnize (0.9.0)
+    coveralls (0.8.0)
+      multi_json (~> 1.10)
+      rest-client (>= 1.6.8, < 2)
+      simplecov (~> 0.9.1)
+      term-ansicolor (~> 1.3)
+      thor (~> 0.19.1)
+    crack (0.4.2)
+      safe_yaml (~> 1.0.0)
+    diff-lcs (1.2.5)
+    docile (1.1.5)
+    domain_name (0.5.23)
+      unf (>= 0.0.5, < 1.0.0)
+    gem-release (0.7.3)
+    http-cookie (1.0.2)
+      domain_name (~> 0.5)
+    method_source (0.8.2)
+    mime-types (2.4.3)
+    multi_json (1.11.0)
+    netrc (0.10.3)
+    parser (2.2.0.3)
+      ast (>= 1.1, < 3.0)
+    powerpack (0.1.0)
+    pry (0.10.1)
+      coderay (~> 1.1.0)
+      method_source (~> 0.8.1)
+      slop (~> 3.4)
+    pry-byebug (3.1.0)
+      byebug (~> 4.0)
+      pry (~> 0.10)
+    rainbow (2.0.0)
+    rake (10.4.2)
+    rest-client (1.8.0)
+      http-cookie (>= 1.0.2, < 2.0)
+      mime-types (>= 1.16, < 3.0)
+      netrc (~> 0.7)
+    rspec (3.2.0)
+      rspec-core (~> 3.2.0)
+      rspec-expectations (~> 3.2.0)
+      rspec-mocks (~> 3.2.0)
+    rspec-core (3.2.3)
+      rspec-support (~> 3.2.0)
+    rspec-expectations (3.2.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.2.0)
+    rspec-mocks (3.2.1)
+      diff-lcs (>= 1.2.0, < 2.0)
+      rspec-support (~> 3.2.0)
+    rspec-support (3.2.2)
+    rubocop (0.30.0)
+      astrolabe (~> 1.3)
+      parser (>= 2.2.0.1, < 3.0)
+      powerpack (~> 0.1)
+      rainbow (>= 1.99.1, < 3.0)
+      ruby-progressbar (~> 1.4)
+    ruby-progressbar (1.7.5)
+    safe_yaml (1.0.4)
+    simplecov (0.9.2)
+      docile (~> 1.1.0)
+      multi_json (~> 1.0)
+      simplecov-html (~> 0.9.0)
+    simplecov-html (0.9.0)
+    slop (3.6.0)
+    term-ansicolor (1.3.0)
+      tins (~> 1.0)
+    thor (0.19.1)
+    tins (1.3.5)
+    unf (0.1.4)
+      unf_ext
+    unf_ext (0.0.6)
+    webmock (1.21.0)
+      addressable (>= 2.3.6)
+      crack (>= 0.3.2)
+    yard (0.8.7.6)
+    yardstick (0.9.9)
+      yard (~> 0.8, >= 0.8.7.2)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  bundler (~> 1.7)
+  codeclimate-test-reporter
+  coveralls
+  ec2_meta!
+  gem-release
+  pry-byebug
+  rake (~> 10.0)
+  rspec (~> 3.2)
+  rspec-mocks (~> 3.2)
+  rubocop (~> 0.30)
+  simplecov (~> 0.9)
+  webmock (~> 1.21)
+  yard (~> 0.8)
+  yardstick (~> 0.9)

data/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Leonis & Co.
+
+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,80 @@
+# Ec2Meta
+
+[![Build Status](https://travis-ci.org/leonis/ec2_meta.svg?branch=master)](https://travis-ci.org/leonis/ec2_meta)
+[![Coverage Status](https://coveralls.io/repos/leonis/ec2_meta/badge.svg)](https://coveralls.io/r/leonis/ec2_meta)
+[![Code Climate](https://codeclimate.com/github/leonis/ec2_meta/badges/gpa.svg)](https://codeclimate.com/github/leonis/ec2_meta)
+
+Welcome to your new gem! In this directory, you'll find the files you need to be able to package up your Ruby library into a gem. Put your Ruby code in the file `lib/ec2_meta`. To experiment with that code, run `bin/console` for an interactive prompt.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+```ruby
+gem 'ec2_meta'
+```
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install ec2_meta
+
+## Usage
+
+### Get Client
+
+```ruby
+# without options
+client = Ec2Meta.client
+
+# with all options
+client = Ec2Meta.client(
+  logger: Logger.new($stdout),
+  fail_on_not_found: true
+)
+```
+
+#### options
+
+name | default | description
+---- | ------- | ------------
+logger | Ec2Meta::NullLogger.new | Pass your logger if you want
+fail_on_not_found | false | If set true, raise error on metadata not found.
+
+### Get Meta
+
+Currently supports all of `Instance metadata` on [Instance Metadata and User Data - Instance Metadata Categories](http://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ec2-instance-metadata.html#instancedata-data-categories) at this time.
+
+[Supported Meta Apis](https://github.com/leonis/ec2_meta/wiki/Supported-Meta-Apis)
+
+#### Sample Code
+
+You can fetch meta data like below.
+
+```ruby
+# fetch ami-id
+client.ami_id
+
+# fetch hostname
+client.hostname
+
+# fetch vpc_id for first network interface
+client.network.interfaces.macs(0).vpc_id
+```
+
+When meta data not found, return `nil` if `fail_on_not_found` is not true.
+
+## License
+
+MIT License
+
+## Contributing
+
+1. Fork it ( https://github.com/[my-github-username]/ec2_meta/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,21 @@
+require 'rubygems'
+require 'bundler/setup'
+
+require 'bundler/gem_tasks'
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec)
+task test: :spec
+
+require 'rubocop/rake_task'
+RuboCop::RakeTask.new
+
+require 'yard'
+YARD::Rake::YardocTask.new
+
+require 'yardstick/rake/measurement'
+Yardstick::Rake::Measurement.new do |measurement|
+  measurement.output = ' measurement/report.txt'
+end
+
+task default: [:spec]

data/bin/console

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+
+require "bundler/setup"
+require "ec2_meta"
+
+# You can add fixtures and/or initialization code here to make experimenting
+# with your gem easier. You can also use a different console, if you like.
+
+# (If you use this, don't forget to add pry to your Gemfile!)
+# require "pry"
+# Pry.start
+
+require "irb"
+IRB.start

data/bin/setup

@@ -0,0 +1,7 @@
+#!/bin/bash
+set -euo pipefail
+IFS=$'\n\t'
+
+bundle install
+
+# Do any other automated setup that you need to do here

data/ec2_meta.gemspec

@@ -0,0 +1,29 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'ec2_meta/version'
+
+Gem::Specification.new do |spec|
+  spec.name          = 'ec2_meta'
+  spec.version       = Ec2Meta::VERSION
+  spec.authors       = ['daisuke.hirakiuchi']
+  spec.email         = ['devops@leonisand.co']
+  spec.licenses      = ['MIT']
+
+  spec.summary       = 'AWS Metadata API client library'
+  spec.description   = 'AWS Metadata API client library. This gem is available only on AWS EC2 instance.'
+  spec.homepage      = 'https://github.com/leonis/ec2_meta'
+
+  spec.files         = `git ls-files -z`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
+  spec.require_paths = ['lib']
+
+  spec.add_development_dependency 'bundler', '~> 1.7'
+  spec.add_development_dependency 'rake', '~> 10.0'
+  spec.add_development_dependency 'rspec', '~> 3.2'
+  spec.add_development_dependency 'rspec-mocks', '~> 3.2'
+  spec.add_development_dependency 'webmock', '~> 1.21'
+  spec.add_development_dependency 'rubocop', '~> 0.30'
+  spec.add_development_dependency 'simplecov', '~> 0.9'
+  spec.add_development_dependency 'yard', '~> 0.8'
+  spec.add_development_dependency 'yardstick', '~> 0.9'
+end

data/lib/ec2_meta/apis/2014_02_25/base.rb

@@ -0,0 +1,9 @@
+module Ec2Meta
+  module Api20140225
+    module Base
+      def self.extended(obj)
+        obj.extend Ec2Meta::Api20140225::MetaData
+      end
+    end
+  end
+end

data/lib/ec2_meta/apis/2014_02_25/meta_data.rb

@@ -0,0 +1,238 @@
+module Ec2Meta
+  module Api20140225
+    module MetaData
+      def meta_data
+        MetaData.new(fetcher, 'meta-data')
+      end
+
+      class BlockDeviceMapping < Ec2Meta::Api::Path
+        # Fetch 'block-device-mapping/ami'
+        def ami
+          fetch('ami')
+        end
+
+        # Fetch 'block-device-mapping/ebs#{no}'
+        def ebs(no)
+          fetch("ebs#{no}")
+        end
+
+        # Fetch 'block-device-mapping/ephemeral#{no}'
+        def ephemeral(no)
+          fetch("ephemeral#{no}")
+        end
+
+        # Fetch 'block-device-mapping/root'
+        def root
+          fetch('root')
+        end
+
+        # Fetch 'block-device-mapping/swap'
+        def swap
+          fetch('swap')
+        end
+      end
+
+      class Iam < Ec2Meta::Api::Path
+        # Fetch 'iam/info'
+        def info
+          fetch('info')
+        end
+
+        # Fetch 'iam/security-credentials/#{role_name}'
+        def security_credentials(role_name)
+          fetch("security-credentials/#{role_name}")
+        end
+      end
+
+      class Network < Ec2Meta::Api::Path
+        def interfaces
+          Interfaces.new(fetcher, new_prefix('interfaces'))
+        end
+      end
+
+      class Interfaces < Ec2Meta::Api::Path
+        def macs(mac = nil)
+          case mac
+          when ::String
+            mac_address_for(mac)
+          when ::Integer
+            mac_address_at(mac)
+          when nil
+            fetch_macs
+          else
+            ::Kernel.raise ::ArgumentError, 'require String or Integer, or nil.'
+          end
+        end
+
+        private
+
+        def fetch_macs
+          result = fetch('macs/')
+          (result.nil? ? [] : result.split("\n").map { |v| v.chomp('/') })
+        end
+
+        def mac_address_for(address)
+          MacAddress.new(fetcher, new_prefix("macs/#{address}"), address)
+        end
+
+        def mac_address_at(position)
+          addr = fetch_macs.at(position)
+          return nil if addr.nil?
+
+          mac_address_for(addr)
+        end
+      end
+
+      class MacAddress < Ec2Meta::Api::Path
+        def initialize(fetcher, prefix, mac_addr)
+          super(fetcher, prefix)
+          @mac_addr = mac_addr
+        end
+
+        # Fetch network/interfaces/macs/#{mac}/device-number
+        def device_number
+          fetch('device-number')
+        end
+
+        # Fetch network/interfaces/macs/#{mac}/ipv4-associations/#{public-ip}
+        def ipv4_associations(public_ip)
+          fetch("ipv4-associations/#{public_ip}")
+        end
+
+        # Fetch network/interfaces/macs/#{mac}/local-hostname
+        def local_hostname
+          fetch('local-hostname')
+        end
+
+        def local_ipv4s
+          fetch('local-ipv4s')
+        end
+
+        def mac
+          fetch('mac')
+        end
+
+        def owner_id
+          fetch('owner-id')
+        end
+
+        def public_hostname
+          fetch('public-hostname')
+        end
+
+        def public_ipv4s
+          fetch('public-ipv4s')
+        end
+
+        def security_groups
+          fetch('security-groups')
+        end
+
+        def security_group_ids
+          fetch('security-group-ids')
+        end
+
+        def subnet_id
+          fetch('subnet-id')
+        end
+
+        def subnet_ipv4_cidr_block
+          fetch('subnet-ipv4-cidr-block')
+        end
+
+        def vpc_id
+          fetch('vpc-id')
+        end
+
+        def vpc_ipv4_cidr_block
+          fetch('vpc-ipv4-cidr-block')
+        end
+      end
+
+      class Placement < Ec2Meta::Api::Path
+        def availability_zone
+          fetch('availability-zone')
+        end
+      end
+
+      class PublicKeys < Ec2Meta::Api::Path
+        def initialize(fetcher, prefix, no)
+          super(fetcher, prefix)
+          @key_no = no
+        end
+
+        def openssh_key
+          fetch('openssh-key')
+        end
+      end
+
+      class Services < Ec2Meta::Api::Path
+        def domain
+          fetch('domain')
+        end
+      end
+
+      class Spot < Ec2Meta::Api::Path
+        def termination_time
+          fetch('termination-time')
+        end
+      end
+
+      class MetaData < Ec2Meta::Api::Path
+        %w[
+          ami-id
+          ami-launch-index
+          ami-manifest-path
+          ancestor-ami-ids
+          hostname
+          instance-action
+          instance-id
+          instance-type
+          kernel-id
+          local-hostname
+          local-ipv4
+          mac
+          product-codes
+          public-hostname
+          public-ipv4
+          ramdisk-id
+          reservation-id
+          reservation-id
+          security-groups
+        ].each do |attr|
+          define_method(attr.gsub('-', '_')) do
+            fetch(attr)
+          end
+        end
+
+        def block_device_mapping
+          BlockDeviceMapping.new(fetcher, new_prefix('block-device-mapping'))
+        end
+
+        def iam
+          Iam.new(fetcher, new_prefix('iam'))
+        end
+
+        def network
+          Network.new(fetcher, new_prefix('network'))
+        end
+
+        def placement
+          Placement.new(fetcher, new_prefix('placement'))
+        end
+
+        def public_keys(no)
+          PublicKeys.new(fetcher, new_prefix("public-keys/#{no}"), no)
+        end
+
+        def services
+          Services.new(fetcher, new_prefix('services'))
+        end
+
+        def spot
+          Spot.new(fetcher, new_prefix('spot'))
+        end
+      end
+    end
+  end
+end

data/lib/ec2_meta/apis/path.rb

@@ -0,0 +1,31 @@
+module Ec2Meta
+  module Api
+    class Path < BasicObject
+      attr_reader :prefix
+
+      def initialize(fetcher, prefix = [])
+        @_fetcher = fetcher
+        @prefix = (prefix.is_a?(::String) ? [prefix] : prefix)
+      end
+
+      private
+
+      def fetch(path)
+        fetcher.fetch(request_path(path))
+      end
+
+      def request_path(path)
+        path_prefix = prefix.empty? ? '' : '/' + prefix.join('/')
+        path_prefix + '/' + path
+      end
+
+      def new_prefix(part)
+        prefix.dup << part
+      end
+
+      def fetcher
+        @_fetcher
+      end
+    end
+  end
+end

data/lib/ec2_meta/cache.rb

@@ -0,0 +1,36 @@
+module Ec2Meta
+  class Cache
+    def initialize
+      @cache = {}
+    end
+
+    def write(key, value)
+      @cache[key.to_s] = value
+    end
+
+    def read(key)
+      @cache[key.to_s]
+    end
+
+    def fetch(key)
+      return read(key) if exist?(key)
+
+      fail ArgumentError, 'require block' unless block_given?
+
+      value = yield
+      write(key, value)
+    end
+
+    def exist?(key)
+      @cache.key?(key.to_s)
+    end
+
+    def delete(key)
+      @cache.delete(key)
+    end
+
+    def clear
+      @cache.clear
+    end
+  end
+end

data/lib/ec2_meta/client.rb

@@ -0,0 +1,22 @@
+module Ec2Meta
+  class Client
+    def initialize(options = {})
+      @options = {
+        api_version: '2014-02-25'
+      }.merge(options)
+
+      load_api_module
+    end
+
+    private
+
+    def fetcher
+      return @fetcher if @fetcher
+      @fetcher = Fetcher.new(@options)
+    end
+
+    def load_api_module
+      extend ApiLoader.api_module(@options[:api_version])
+    end
+  end
+end

data/lib/ec2_meta/fetcher.rb

@@ -0,0 +1,60 @@
+require 'net/http'
+require 'timeout'
+
+module Ec2Meta
+  class MetaNotFound < StandardError; end
+
+  class Fetcher
+    API_HOST = '169.254.169.254'.freeze
+    API_VERSION = '2014-02-25'.freeze
+
+    def initialize(options = {})
+      @options = options
+      @cache = ::Ec2Meta::Cache.new
+    end
+
+    def fetch(path)
+      @cache.fetch(path) do
+        res = http_client.get(request_path(path))
+        break res.body if res.code != '404'
+
+        fail MetaNotFound, "'#{path}' not found." if fail_on_not_found?
+        nil
+      end
+    rescue Timeout::Error => e
+      logger.error 'Can\'t fetch EC2 metadata from EC2 METADATA API.'
+      logger.error 'ec2_meta gem is only available on AWS EC2 instance.'
+      raise e
+    rescue MetaNotFound => e
+      raise e
+    rescue => e
+      logger.error "Can't fetch EC2 metadata from EC2 METADATA API.(#{e.message})"
+      logger.error e.backtrace.join("\n")
+      raise e
+    end
+
+    private
+
+    def logger
+      @options[:logger]
+    end
+
+    def http_client
+      return @http_client unless @http_client.nil?
+
+      @http_client = Net::HTTP.new(API_HOST)
+      @http_client.open_timeout = @options[:open_timeout] || 2.0
+      @http_client.read_timeout = @options[:read_timeout] || 2.0
+
+      @http_client
+    end
+
+    def request_path(path)
+      '/' + API_VERSION + path
+    end
+
+    def fail_on_not_found?
+      @options[:fail_on_not_found]
+    end
+  end
+end

data/lib/ec2_meta/loader.rb

@@ -0,0 +1,14 @@
+module Ec2Meta
+  class NotSupported < StandardError; end
+
+  class ApiLoader
+    def self.api_module(api_version)
+      fail 'require valid api_version' if api_version.nil? || api_version.empty?
+
+      api_namespace = Ec2Meta.const_get('Api' + api_version.gsub('-', ''))
+      api_namespace.const_get('Base')
+    rescue NameError
+      raise NotSupported, "Not Supported the api_version: #{api_version}"
+    end
+  end
+end

data/lib/ec2_meta/null_logger.rb

@@ -0,0 +1,30 @@
+module Ec2Meta
+  class NullLogger
+    def debug(_progname = nil, &_block)
+    end
+
+    def debug?
+      false
+    end
+
+    def error(_progname = nil, &_block); end
+
+    def error?
+      false
+    end
+
+    def fatal(_progname = nil, &_block)
+    end
+
+    def fatal?
+      false
+    end
+
+    def info(_progname = nil, &_block)
+    end
+
+    def info?
+      false
+    end
+  end
+end

data/lib/ec2_meta/version.rb

@@ -0,0 +1,3 @@
+module Ec2Meta
+  VERSION = "0.1.0"
+end

data/lib/ec2_meta.rb

@@ -0,0 +1,27 @@
+require 'logger'
+
+require 'ec2_meta/version'
+require 'ec2_meta/client'
+require 'ec2_meta/loader'
+require 'ec2_meta/cache'
+require 'ec2_meta/fetcher'
+require 'ec2_meta/null_logger'
+require 'ec2_meta/apis/path.rb'
+
+require 'ec2_meta/apis/2014_02_25/base'
+require 'ec2_meta/apis/2014_02_25/meta_data'
+
+module Ec2Meta
+  # Your code goes here...
+  class << self
+    attr_reader :options
+
+    def client(options = {})
+      opts = {
+        logger: ::Ec2Meta::NullLogger.new
+      }.merge(options)
+
+      Client.new(opts)
+    end
+  end
+end

data/sample.rb

@@ -0,0 +1,156 @@
+require 'pry'
+require 'rubygems'
+require 'bundler/setup'
+
+require 'ec2_meta'
+require 'pry'
+
+client = Ec2Meta.client
+
+m = client.meta_data
+
+puts '#ami-id'
+p m.ami_id
+
+puts '#ami-launch-index'
+p m.ami_launch_index
+
+puts '#ami-manifest-path'
+p m.ami_manifest_path
+
+puts '#ancestor-ami-ids'
+p m.ancestor_ami_ids
+
+puts '#block-device-mapping/ami'
+p m.block_device_mapping.ami
+
+# TODO: change no
+puts '#block-device-mapping/ebs0'
+p m.block_device_mapping.ebs(0)
+
+# TODO: change no
+puts '#block-device-mapping/ephemeral0'
+p m.block_device_mapping.ephemeral(0)
+
+puts '#block-device-mapping/root'
+p m.block_device_mapping.root
+
+puts '#block-device-mapping/swap'
+p m.block_device_mapping.swap
+
+puts '#hostname'
+p m.hostname
+
+puts '#iam/info'
+p m.iam.info
+
+# TODO: change role-name
+puts '#iam/security-credentials/#{role-name}'
+p m.iam.security_credentials('role-name')
+
+puts '#instance-action'
+p m.instance_action
+
+puts '#instance-id'
+p m.instance_id
+
+puts '#instance-type'
+p m.instance_type
+
+puts '#kernel-id'
+p m.kernel_id
+
+puts '#local-hostname'
+p m.local_hostname
+
+puts '#local-ipv4'
+p m.local_ipv4
+
+puts '#mac'
+p m.mac
+
+puts '#network/interfaces/macs/0'
+#p m.network.interfaces.macs(0)
+
+puts '#network/interfaces/macs/0/device-number'
+p m.network.interfaces.macs(0).device_number
+
+p m.network.interfaces.macs(m.mac).device_number
+
+### network/interfaces/macs/#{mac}
+puts '-------------'
+mac = m.network.interfaces.macs('mac')
+
+puts '#network/interfaces/macs/#{mac}/device-number'
+p mac.device_number
+
+puts '#network/interfaces/macs/#{mac}/ipv4-associations/#{public-ip}'
+p mac.ipv4_associations('public-ip')
+
+puts '#network/interfaces/macs/#{mac}/local-hostname'
+p mac.local_hostname
+
+puts '#network/interfaces/macs/#{mac}/local-ipv4s'
+p mac.local_ipv4s
+
+puts '#network/interfaces/macs/#{mac}/mac'
+p mac.mac
+
+puts '#network/interfaces/macs/#{mac}/owner-id'
+p mac.owner_id
+
+puts '#network/interfaces/macs/#{mac}/public-hostname'
+p mac.public_hostname
+
+puts '#network/interfaces/macs/#{mac}/public-ipv4s'
+p mac.public_ipv4s
+
+puts '#network/interfaces/macs/#{mac}/security-groups'
+p mac.security_groups
+
+puts '#network/interfaces/macs/#{mac}/security-group-ids'
+p mac.security_group_ids
+
+puts '#network/interfaces/macs/#{mac}/subnet-id'
+p mac.subnet_id
+
+puts '#network/interfaces/macs/#{mac}/subnet-ipv4-cidr-block'
+p mac.subnet_ipv4_cidr_block
+
+puts '#network/interfaces/macs/#{mac}/vpc-id'
+p mac.vpc_id
+
+puts '#network/interfaces/macs/#{mac}/vpc-ipv4-cidr-block'
+p mac.vpc_ipv4_cidr_block
+
+puts '-------------'
+
+puts '#placement/availability-zone'
+p m.placement.availability_zone
+
+puts '#product-codes'
+p m.product_codes
+
+puts '#public-hostname'
+p m.public_hostname
+
+puts '#public-keys/0/openssh-key'
+p m.public_keys(0).openssh_key
+
+puts '#ramdisk-id'
+p m.ramdisk_id
+
+puts '#security-groups'
+p m.security_groups
+
+puts '#reservation_id'
+p m.reservation_id
+
+puts '#security-groups'
+p m.security_groups
+
+puts '#services/domain'
+p m.services.domain
+
+puts '#spot/termination-time'
+p m.spot.termination_time

metadata

@@ -0,0 +1,195 @@
+--- !ruby/object:Gem::Specification
+name: ec2_meta
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- daisuke.hirakiuchi
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-05-20 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.7'
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: rspec-mocks
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.2'
+- !ruby/object:Gem::Dependency
+  name: webmock
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.21'
+- !ruby/object:Gem::Dependency
+  name: rubocop
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.30'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.30'
+- !ruby/object:Gem::Dependency
+  name: simplecov
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+- !ruby/object:Gem::Dependency
+  name: yard
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.8'
+- !ruby/object:Gem::Dependency
+  name: yardstick
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.9'
+description: AWS Metadata API client library. This gem is available only on AWS EC2
+  instance.
+email:
+- devops@leonisand.co
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".coveralls.yml"
+- ".gitignore"
+- ".rspec"
+- ".travis.yml"
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- bin/console
+- bin/setup
+- ec2_meta.gemspec
+- lib/ec2_meta.rb
+- lib/ec2_meta/apis/2014_02_25/base.rb
+- lib/ec2_meta/apis/2014_02_25/meta_data.rb
+- lib/ec2_meta/apis/path.rb
+- lib/ec2_meta/cache.rb
+- lib/ec2_meta/client.rb
+- lib/ec2_meta/fetcher.rb
+- lib/ec2_meta/loader.rb
+- lib/ec2_meta/null_logger.rb
+- lib/ec2_meta/version.rb
+- sample.rb
+homepage: https://github.com/leonis/ec2_meta
+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: AWS Metadata API client library
+test_files: []
+has_rdoc: