engineyard-metadata 0.0.2 → 0.0.3

data/README.rdoc

@@ -4,12 +4,24 @@ Pulls metadata from EC2 and EngineYard so that your EngineYard Cloud instances k
 
 == Purpose
 
-To define an unchanging interface to certain metadata that is buried deep inside JSON config files and EC2 API calls.
+To define an unchanging interface to useful metadata (passwords, IP addresses, etc.) that is otherwise buried deep inside EngineYard's chef config files and EC2 API calls.
 
-== Quickstart
+== Examples
 
-This only runs from EngineYard AppCloud instances (running on Amazon EC2).
+* Get a dynamically updated list of all running app servers so that you can pool memcached over all of them. (<tt>EY::Metadata.app_servers</tt>)
+* Get the current database password so that you can write a script that connects to it. (<tt>EY::Metadata.database_password</tt>)
 
+== Use
+
+Get the full method list in {the engineyard-metadata rdoc}[http://rdoc.info/github/seamusabshere/engineyard-metadata].
+
+Metadata getters are defined directly on <tt>EY::Metadata</tt>. Even if EngineYard changes the structure of the config files or Amazon EC2's API changes, these methods will stay the same.
+
+This only runs on EngineYard AppCloud instances (running on Amazon EC2).
+
+  [...]
+  >> require 'rubygems'
+  [...]
   >> require 'engineyard-metadata'
   [...]
   >> EY::Metadata.database_host

data/VERSION

@@ -1 +1 @@
-0.0.2
+0.0.3

data/engineyard-metadata.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{engineyard-metadata}
-  s.version = "0.0.2"
+  s.version = "0.0.3"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Seamus Abshere"]
-  s.date = %q{2010-09-24}
+  s.date = %q{2010-10-08}
   s.description = %q{Pulls metadata from EC2 and EngineYard so that your EngineYard AppCloud (Amazon EC2) instances know about each other.}
   s.email = %q{seamus@abshere.net}
   s.extra_rdoc_files = [

data/lib/engineyard-metadata/chef_dna.rb

@@ -1,3 +1,4 @@
+require 'active_support'
 require 'active_support/version'
 %w{
   active_support/json
@@ -9,11 +10,18 @@ module EY
   module Metadata
     class ChefDna
       PATH = '/etc/chef/dna.json'
+      MYSQL_BIN = '/usr/bin/mysql'
+      MYSQLDUMP_BIN = '/usr/bin/mysqldump'
       
       def data # :nodoc:
         @data ||= ActiveSupport::JSON.decode File.read(PATH)
       end
     
+      # The present instance's role
+      def present_instance_role
+        data['instance_role']
+      end
+      
       # The present instance's public hostname.
       def present_public_hostname
         data['engineyard']['environment']['instances'].detect { |i| i['id'] == EY::Metadata.present_instance_id }['public_hostname']
@@ -85,6 +93,16 @@ module EY
             data['engineyard']['environment']['instances'].detect { |i| i['role'] == 'solo' }
         i['public_hostname']
       end
+      
+      # The shell command for mysql, including username, password, hostname and database
+      def mysql_command
+        "#{MYSQL_BIN} -h #{database_host} -u #{database_username} -p#{database_password} #{database_name}"
+      end
+
+      # The shell command for mysql, including username, password, hostname and database
+      def mysqldump_command
+        "#{MYSQLDUMP_BIN} -h #{database_host} -u #{database_username} -p#{database_password} #{database_name}"
+      end
     end
   end
 end

data/lib/engineyard-metadata/metadata.rb

@@ -6,6 +6,7 @@ module EY
     }
         
     DELEGATED_TO_CHEF_DNA = %w{
+      present_instance_role
       present_public_hostname
       database_password
       database_username
@@ -18,6 +19,8 @@ module EY
       utilities
       app_master
       db_master
+      mysql_command
+      mysqldump_command
     }
     
     DELEGATED_TO_AMAZON_EC2_API.each do |name|

data/spec/metadata_spec.rb

@@ -1,7 +1,7 @@
 require 'spec_helper'
 
 describe EY do
-  it 'has a dna.json' do
+  it 'has a FakeFS dna.json' do
     File.exist?('/etc/chef/dna.json').should == true
   end
 end
@@ -11,6 +11,10 @@ describe EY::Metadata do
     EY::Metadata.present_instance_id.should == PRESENT_INSTANCE_ID
   end
   
+  it 'gets the present instance role (as a string)' do
+    EY::Metadata.present_instance_role.should == 'app_master'
+  end
+  
   it 'gets the present public hostname' do
     EY::Metadata.present_public_hostname.should == PRESENT_PUBLIC_HOSTNAME
   end
@@ -62,4 +66,12 @@ describe EY::Metadata do
   it 'gets the db master hostname' do
     EY::Metadata.db_master.should == 'db_master.compute-1.amazonaws.com'
   end
+  
+  it 'gets the mysql command' do
+    EY::Metadata.mysql_command.should == '/usr/bin/mysql -h external_db_master.compute-1.amazonaws.com -u USERS-0-USERNAME -pUSERS-0-PASSWORD APPS-0-DATABASE_NAME'
+  end
+  
+  it 'gets the mysqldump command' do
+    EY::Metadata.mysqldump_command.should == '/usr/bin/mysqldump -h external_db_master.compute-1.amazonaws.com -u USERS-0-USERNAME -pUSERS-0-PASSWORD APPS-0-DATABASE_NAME'
+  end
 end

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: engineyard-metadata
 version: !ruby/object:Gem::Version 
-  hash: 27
+  hash: 25
   prerelease: false
   segments: 
   - 0
   - 0
-  - 2
-  version: 0.0.2
+  - 3
+  version: 0.0.3
 platform: ruby
 authors: 
 - Seamus Abshere
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-09-24 00:00:00 -05:00
+date: 2010-10-08 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency