engineyard-metadata 0.1.2 → 0.2.0

data/README.rdoc

@@ -1,45 +1,45 @@
 = engineyard-metadata
 
-Presents a simple, unchanging interface to get metadata about your EngineYard AppCloud instances running on Amazon EC2.
+Presents a simple interface to get metadata about your EngineYard AppCloud instances running on Amazon EC2.
 
 == Purpose
 
-To define an unchanging interface to useful metadata (passwords, IP addresses, etc.) that is otherwise buried deep inside EngineYard's chef config files and various API calls.
+To define a simple interface to useful metadata (passwords, IP addresses, etc.) that is otherwise buried deep inside EngineYard's chef config files and various API calls.
 
 == Examples
 
-* 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>)
+* 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>)
 
 Here's the current method list:
 
-	EY::Metadata.app_master
-	EY::Metadata.app_name
-	EY::Metadata.app_servers
-	EY::Metadata.app_slaves
-	EY::Metadata.current_path
-	EY::Metadata.database_host
-	EY::Metadata.database_name
-	EY::Metadata.database_password       (only works from cloud instances)
-	EY::Metadata.database_username
-	EY::Metadata.db_master
-	EY::Metadata.db_servers
-	EY::Metadata.db_slaves
-	EY::Metadata.environment_name
-	EY::Metadata.mysql_command           (only works from cloud instances)
-	EY::Metadata.mysqldump_command       (only works from cloud instances)
-	EY::Metadata.present_instance_id     (only works from cloud instances)
-	EY::Metadata.present_instance_role   (only works from cloud instances)
-	EY::Metadata.present_public_hostname (only works from cloud instances)
-	EY::Metadata.present_security_group  (only works from cloud instances)
-	EY::Metadata.repository_uri
-	EY::Metadata.shared_path
-	EY::Metadata.solo
-	EY::Metadata.ssh_aliases
-	EY::Metadata.ssh_password            (only works from cloud instances)
-	EY::Metadata.ssh_username
-	EY::Metadata.stack_name
-	EY::Metadata.utilities
+	EY.metadata.app_master
+	EY.metadata.app_name
+	EY.metadata.app_servers
+	EY.metadata.app_slaves
+	EY.metadata.current_path
+	EY.metadata.database_host
+	EY.metadata.database_name
+	EY.metadata.database_password       (only works from cloud instances)
+	EY.metadata.database_username
+	EY.metadata.db_master
+	EY.metadata.db_servers
+	EY.metadata.db_slaves
+	EY.metadata.environment_name
+	EY.metadata.mysql_command           (only works from cloud instances)
+	EY.metadata.mysqldump_command       (only works from cloud instances)
+	EY.metadata.present_instance_id     (only works from cloud instances)
+	EY.metadata.present_instance_role   (only works from cloud instances)
+	EY.metadata.present_public_hostname (only works from cloud instances)
+	EY.metadata.present_security_group  (only works from cloud instances)
+	EY.metadata.repository_uri
+	EY.metadata.shared_path
+	EY.metadata.solo
+	EY.metadata.ssh_aliases
+	EY.metadata.ssh_password            (only works from cloud instances)
+	EY.metadata.ssh_username
+	EY.metadata.stack_name
+	EY.metadata.utilities
 
 == Use
 
@@ -53,23 +53,23 @@ When you're executing the gem from your instances, you don't have to configure a
 
 You must...
 
-* have <tt>~/.eyrc</tt> or set <tt>EY::Metadata.ey_cloud_token=</tt> or set <tt>ENV['EY_CLOUD_TOKEN']</tt>.
-* execute the gem from the local copy of your application's repo or set <tt>EY::Metadata.environment_name=</tt> or set <tt>ENV['EY_ENVIRONMENT_NAME']</tt>.
+* have <tt>~/.eyrc</tt> or set <tt>EY.metadata.ey_cloud_token=</tt> or set <tt>ENV['EY_CLOUD_TOKEN']</tt>.
+* execute the gem from the local copy of your application's repo or set <tt>EY.metadata.environment_name=</tt> or set <tt>ENV['EY_ENVIRONMENT_NAME']</tt>.
 
 === Where the methods are defined
 
-Metadata getters are defined directly on <tt>EY::Metadata</tt> (which in turn delegates out to various adapters). Even if EngineYard changes the structure of the config files or Amazon EC2's API changes, these methods will stay the same.
+Metadata getters are defined directly on <tt>EY.metadata</tt> (which in turn delegates out to various adapters). Even if EngineYard changes the structure of the config files or Amazon EC2's API changes, these methods will stay the same.
 
   [...]
   >> require 'rubygems'
   [...]
   >> require 'engineyard-metadata'
   [...]
-  >> EY::Metadata.database_host
+  >> EY.metadata.database_host
   => "external_db_master.compute-1.amazonaws.com"
-  >> EY::Metadata.app_servers
+  >> EY.metadata.app_servers
   => [ 'app_1.compute-1.amazonaws.com' , 'app_master.compute-1.amazonaws.com' ]
-  >> EY::Metadata.db_servers
+  >> EY.metadata.db_servers
   => [ 'db_master.compute-1.amazonaws.com', 'db_slave_1.compute-1.amazonaws.com' ]
   [...and many more...]
 
@@ -90,8 +90,8 @@ You can put the output of <tt>ey_ssh_aliases</tt> into <tt>~/.ssh/config</tt>:
 
 == Known issues
 
-* Doesn't work with multiple apps per environment.
-* It's not always clear what environment you're running in. For example, you say <tt>EY::Metadata.something</tt> and you're just supposed to know what environment you're in. You can use <tt>.environment_name=</tt>, but you might not remember.
+* Doesn't work with multiple apps per environment. [FIXED!]
+* It's not always clear what environment you're running in. For example, you say <tt>EY.metadata.something</tt> and you're just supposed to know what environment you're in. You can use <tt>.environment_name=</tt>, but you might not remember.
 * There are no factory methods. If we fully fleshed this out, it might be like <tt>my_env = EY::Environment.find('my_env')</tt> and <tt>my_app_master = my_env.app_master</tt>. Not sure that complexity would add a lot of value.
 
 == History

data/Rakefile

@@ -12,6 +12,7 @@ begin
     gem.authors = ["Seamus Abshere"]
     gem.add_dependency 'activesupport', '>=2.3.4'
     gem.add_dependency 'nap', '>=0.4'
+    gem.add_dependency 'eat'
     gem.add_development_dependency "fakeweb"
     gem.add_development_dependency "fakefs"
     gem.add_development_dependency "rspec", "~>2"

data/VERSION

@@ -1 +1 @@
-0.1.2
+0.2.0

data/bin/ey_ssh_aliases

@@ -3,4 +3,4 @@ unless RUBY_VERSION >= '1.9'
 	require 'rubygems'
 end
 require 'engineyard-metadata'
-puts EY::Metadata.ssh_aliases
+puts EY.metadata.ssh_aliases

data/engineyard-metadata.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{engineyard-metadata}
-  s.version = "0.1.2"
+  s.version = "0.2.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Seamus Abshere"]
-  s.date = %q{2010-10-21}
+  s.date = %q{2011-01-12}
   s.default_executable = %q{ey_ssh_aliases}
   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}
@@ -58,12 +58,14 @@ Gem::Specification.new do |s|
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
       s.add_runtime_dependency(%q<activesupport>, [">= 2.3.4"])
       s.add_runtime_dependency(%q<nap>, [">= 0.4"])
+      s.add_runtime_dependency(%q<eat>, [">= 0"])
       s.add_development_dependency(%q<fakeweb>, [">= 0"])
       s.add_development_dependency(%q<fakefs>, [">= 0"])
       s.add_development_dependency(%q<rspec>, ["~> 2"])
     else
       s.add_dependency(%q<activesupport>, [">= 2.3.4"])
       s.add_dependency(%q<nap>, [">= 0.4"])
+      s.add_dependency(%q<eat>, [">= 0"])
       s.add_dependency(%q<fakeweb>, [">= 0"])
       s.add_dependency(%q<fakefs>, [">= 0"])
       s.add_dependency(%q<rspec>, ["~> 2"])
@@ -71,6 +73,7 @@ Gem::Specification.new do |s|
   else
     s.add_dependency(%q<activesupport>, [">= 2.3.4"])
     s.add_dependency(%q<nap>, [">= 0.4"])
+    s.add_dependency(%q<eat>, [">= 0"])
     s.add_dependency(%q<fakeweb>, [">= 0"])
     s.add_dependency(%q<fakefs>, [">= 0"])
     s.add_dependency(%q<rspec>, ["~> 2"])

data/lib/engineyard-metadata.rb

@@ -1,3 +1,6 @@
 module EY
   autoload :Metadata, 'engineyard-metadata/metadata'
+  def self.metadata
+    Metadata.instance
+  end
 end

data/lib/engineyard-metadata/amazon_ec2_api.rb

@@ -1,17 +1,17 @@
-require 'open-uri'
+require 'eat'
 
 module EY
-  module Metadata
+  class Metadata
     # An adapter that reads from Amazon EC2's metadata web service, which is only available from cloud instances.
     class AmazonEc2Api
       # The present instance's Amazon Ec2 instance id.
       def present_instance_id
-        open("http://169.254.169.254/latest/meta-data/instance-id").gets
+        @present_instance_id ||= eat 'http://169.254.169.254/latest/meta-data/instance-id'
       end
 
       # The present instance's Amazon Ec2 security group.
       def present_security_group
-        open('http://169.254.169.254/latest/meta-data/security-groups').gets
+        @present_security_group ||= eat 'http://169.254.169.254/latest/meta-data/security-groups'
       end
     end
   end

data/lib/engineyard-metadata/chef_dna.rb

@@ -7,62 +7,49 @@ require 'active_support/version'
 end if ActiveSupport::VERSION::MAJOR == 3
 
 module EY
-  module Metadata
+  class Metadata
     # An adapter that reads from /etc/chef/dna.json, which is only available on cloud instances.
     class ChefDna
       PATH = '/etc/chef/dna.json'
 
       include SshAliasHelper
 
-      def data # :nodoc:
-        @data ||= ActiveSupport::JSON.decode File.read(PATH)
+      def dna # :nodoc:
+        @dna ||= ActiveSupport::JSON.decode File.read(PATH)
+      end
+      
+      def application # :nodoc:
+        dna['engineyard']['environment']['apps'].detect { |a| a['name'] == EY.metadata.app_name }
       end
   
       # The present instance's role
       def present_instance_role
-        data['instance_role']
+        dna['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']
+        dna['engineyard']['environment']['instances'].detect { |i| i['id'] == EY.metadata.present_instance_id }['public_hostname']
       end
   
       # Currently the same as the SSH password.
       def database_password
-        data['users'][0]['password']
+        dna['users'][0]['password']
       end
     
       # Currently the same as the SSH username.
       def database_username
-        data['users'][0]['username']
+        dna['users'][0]['username']
       end
     
       # For newly deployed applications, equal to the application name.
       def database_name
-        data['engineyard']['environment']['apps'][0]['database_name']
+        application['database_name']
       end
       
       # The git repository that you told EngineYard to use for this application.
       def repository_uri
-        data['engineyard']['environment']['apps'][0]['repository_name']
-      end
-      
-      # The name of the single app that runs in this environment.
-      #
-      # Warning: this gem currently doesn't support multiple apps per environment.
-      def app_name
-        data['engineyard']['environment']['apps'][0]['name']
-      end
-      
-      # The path to the current deploy on app servers.
-      def current_path
-        "/data/#{app_name}/current"
-      end
-      
-      # The path to the shared directory on app servers.
-      def shared_path
-        "/data/#{app_name}/shared"
+        application['repository_name']
       end
 
       # Public hostname where you should connect to the database.
@@ -74,50 +61,50 @@ module EY
   
       # SSH username.
       def ssh_username
-        data['engineyard']['environment']['ssh_username']
+        dna['engineyard']['environment']['ssh_username']
       end
     
       # SSH password.
       def ssh_password
-        data['engineyard']['environment']['ssh_password']
+        dna['engineyard']['environment']['ssh_password']
       end
   
       # The public hostnames of all the app servers.
       #
       # If you're on a solo app, it counts the solo as an app server.
       def app_servers
-        data['engineyard']['environment']['instances'].select { |i| %w{ app_master app solo }.include? i['role'] }.map { |i| i['public_hostname'] }.sort
+        dna['engineyard']['environment']['instances'].select { |i| %w{ app_master app solo }.include? i['role'] }.map { |i| i['public_hostname'] }.sort
       end
     
       # The public hostnames of all the app slaves.
       def app_slaves
-        data['engineyard']['environment']['instances'].select { |i| %w{ app }.include? i['role'] }.map { |i| i['public_hostname'] }.sort
+        dna['engineyard']['environment']['instances'].select { |i| %w{ app }.include? i['role'] }.map { |i| i['public_hostname'] }.sort
       end
   
       # The public hostnames of all the db servers.
       #
       # If you're on a solo app, it counts the solo as a db server.
       def db_servers
-        data['engineyard']['environment']['instances'].select { |i| %w{ db_master db_slave solo }.include? i['role'] }.map { |i| i['public_hostname'] }.sort
+        dna['engineyard']['environment']['instances'].select { |i| %w{ db_master db_slave solo }.include? i['role'] }.map { |i| i['public_hostname'] }.sort
       end
   
       # The public hostnames of all the db slaves.
       def db_slaves
-        data['engineyard']['environment']['instances'].select { |i| %w{ db_slave }.include? i['role'] }.map { |i| i['public_hostname'] }.sort
+        dna['engineyard']['environment']['instances'].select { |i| %w{ db_slave }.include? i['role'] }.map { |i| i['public_hostname'] }.sort
       end
   
       # The public hostnames of all the utility servers.
       #
       # If you're on a solo app, it counts the solo as a utility.
       def utilities
-        data['engineyard']['environment']['instances'].select { |i| %w{ util solo }.include? i['role'] }.map { |i| i['public_hostname'] }.sort
+        dna['engineyard']['environment']['instances'].select { |i| %w{ util solo }.include? i['role'] }.map { |i| i['public_hostname'] }.sort
       end
   
       # The public hostname of the app_master.
       #
       # If you're on a solo app, it counts the solo as the app_master.
       def app_master
-        if x = data['engineyard']['environment']['instances'].detect { |i| i['role'] == 'app_master' }
+        if x = dna['engineyard']['environment']['instances'].detect { |i| i['role'] == 'app_master' }
           x['public_hostname']
         else
           solo
@@ -128,7 +115,7 @@ module EY
       #
       # If you're on a solo app, it counts the solo as the app_master.
       def db_master
-        if x = data['engineyard']['environment']['instances'].detect { |i| i['role'] == 'db_master' }
+        if x = dna['engineyard']['environment']['instances'].detect { |i| i['role'] == 'db_master' }
           x['public_hostname']
         else
           solo
@@ -137,7 +124,7 @@ module EY
     
       # The public hostname of the solo.
       def solo
-        if x = data['engineyard']['environment']['instances'].detect { |i| i['role'] == 'solo' }
+        if x = dna['engineyard']['environment']['instances'].detect { |i| i['role'] == 'solo' }
           x['public_hostname']
         end
       end
@@ -154,12 +141,12 @@ module EY
     
       # The name of the EngineYard AppCloud environment.
       def environment_name
-        data['environment']['name']
+        dna['environment']['name']
       end
       
       # The stack in use, like nginx_passenger.
       def stack_name
-        data['engineyard']['environment']['stack_name']
+        dna['engineyard']['environment']['stack_name']
       end
     end
   end

data/lib/engineyard-metadata/engine_yard_cloud_api.rb

@@ -4,35 +4,41 @@ require 'active_support'
 require 'active_support/version'
 %w{
   active_support/json
+  active_support/core_ext/enumerable
 }.each do |active_support_3_requirement|
   require active_support_3_requirement
 end if ActiveSupport::VERSION::MAJOR == 3
 
 module EY
-  module Metadata
+  class Metadata
     # An adapter that reads from the public EngineYard Cloud API (https://cloud.engineyard.com). Available from anywhere.
     #
     # See README for what environment variables and/or files you need to have in place for this to work.
     class EngineYardCloudApi
+      attr_reader :last_used_ey_cloud_token
       URL = 'https://cloud.engineyard.com/api/v2/environments'
       
       include SshAliasHelper
       
+      def initialize(last_used_ey_cloud_token)
+        @last_used_ey_cloud_token = last_used_ey_cloud_token
+      end
+      
       # Currently the same as the SSH username.
       def database_username
-        data['ssh_username']
+        environment['ssh_username']
       end
       
       # The username for connecting by SSH.
       def ssh_username
-        data['ssh_username']
+        environment['ssh_username']
       end
       
       # Currently the same as the app name, at least for recently-created environments.
       #
       # This is less reliable that the answer you would get running from an instance, because databases used to be named after environments.
       def database_name
-        app_name
+        EY.metadata.app_name
       end
       
       # The hostname of the database host.
@@ -44,7 +50,7 @@ module EY
       #
       # If you're on a solo app, it counts the solo as the app_master.
       def db_master
-        if x = data['instances'].detect { |i| i['role'] == 'db_master' }
+        if x = environment['instances'].detect { |i| i['role'] == 'db_master' }
           x['public_hostname']
         else
           solo
@@ -55,38 +61,38 @@ module EY
       #
       # If you're on a solo app, it counts the solo as an app server.
       def app_servers
-        data['instances'].select { |i| %w{ app_master app solo }.include? i['role'] }.map { |i| i['public_hostname'] }.sort
+        environment['instances'].select { |i| %w{ app_master app solo }.include? i['role'] }.map { |i| i['public_hostname'] }.sort
       end
       
       # The public hostnames of all the db servers.
       #
       # If you're on a solo app, it counts the solo as a db server.
       def db_servers
-        data['instances'].select { |i| %w{ db_master db_slave solo }.include? i['role'] }.map { |i| i['public_hostname'] }.sort
+        environment['instances'].select { |i| %w{ db_master db_slave solo }.include? i['role'] }.map { |i| i['public_hostname'] }.sort
       end
       
       # The public hostnames of all the utility servers.
       #
       # If you're on a solo app, it counts the solo as a utility.
       def utilities
-        data['instances'].select { |i| %w{ util solo }.include? i['role'] }.map { |i| i['public_hostname'] }.sort
+        environment['instances'].select { |i| %w{ util solo }.include? i['role'] }.map { |i| i['public_hostname'] }.sort
       end
       
       # The public hostnames of all the app slaves.
       def app_slaves
-        data['instances'].select { |i| %w{ app }.include? i['role'] }.map { |i| i['public_hostname'] }.sort
+        environment['instances'].select { |i| %w{ app }.include? i['role'] }.map { |i| i['public_hostname'] }.sort
       end
   
       # The public hostnames of all the db slaves.
       def db_slaves
-        data['instances'].select { |i| %w{ db_slave }.include? i['role'] }.map { |i| i['public_hostname'] }.sort
+        environment['instances'].select { |i| %w{ db_slave }.include? i['role'] }.map { |i| i['public_hostname'] }.sort
       end
       
       # The public hostname of the app_master.
       #
       # If you're on a solo app, it counts the solo as the app_master.
       def app_master
-        if x = data['instances'].detect { |i| i['role'] == 'app_master' }
+        if x = environment['instances'].detect { |i| i['role'] == 'app_master' }
           x['public_hostname']
         else
           solo
@@ -95,75 +101,109 @@ module EY
 
       # The public hostname of the solo.
       def solo
-        if x = data['instances'].detect { |i| i['role'] == 'solo' }
+        if x = environment['instances'].detect { |i| i['role'] == 'solo' }
           x['public_hostname']
         end
       end
       
       # The name of the EngineYard AppCloud environment.
       def environment_name
-        data['name']
+        environment['name']
       end
       
       # The stack in use, like nginx_passenger.
       def stack_name
-        data['stack_name']
+        environment['stack_name']
       end
       
       # The git repository that you told EngineYard to use for this application.
       def repository_uri
-        data['apps'][0]['repository_uri']
+        application['repository_uri']
       end
-
+      
       # A list of all the environment names belonging to this account.
       def environment_names
         environments.map { |environment| environment['name'] }
       end
       
-      # The name of the single app that runs in this environment.
-      #
-      # Warning: this gem currently doesn't support multiple apps per environment.
+      # The name of the app we're looking at.
       def app_name
-        data['apps'][0]['name']
+        application['name']
+      end
+      
+      # Used internally to store the full list of environments that the API gives us.
+      def environments
+        return @environments if @environments.is_a? Array
+        raw_json = REST.get(URL, 'X-EY-Cloud-Token' => last_used_ey_cloud_token).body
+        raw_data = ActiveSupport::JSON.decode raw_json
+        @environments = raw_data['environments']
+      end
+      
+      # Used internally to store data about the specific application we're working with.
+      def application
+        hit = if EY.metadata.preset_app_name?
+          catch(:found_it) do
+            environments.each do |e|
+              if hit = e['apps'].detect { |a| a['name'] == EY.metadata.app_name }
+                throw :found_it, hit
+              end
+            end
+          end
+        elsif possible_to_detect_app_from_environment_name?
+          environment['apps'][0]
+        elsif possible_to_detect_app_from_git_config?
+          catch(:found_it) do
+            environments.each do |e|
+              if hit = e['apps'].detect { |a| a['repository_uri'] == repository_uri_from_git_config }
+                throw :found_it, hit
+              end
+            end
+          end
+        end
+        raise RuntimeError, "[engineyard-metadata gem] Couldn't find a matching application. Please set EY.metadata.app_name= or ENV['EY_APP_NAME']" unless hit
+        hit
       end
       
-      # The path to the current deploy on app servers.
-      def current_path
-        "/data/#{app_name}/current"
+      def repository_uri_from_git_config
+        return @repository_uri_from_git_config if @repository_uri_from_git_config.is_a? String
+        git_config_path = File.join Dir.pwd, '.git', 'config'
+        if File.exist? git_config_path
+          git_config = File.read git_config_path
+          git_config =~ /^\[remote.*?\burl = (.*?)\n/m
+          @repository_uri_from_git_config = $1
+        end
       end
       
-      # The path to the shared directory on app servers.
-      def shared_path
-        "/data/#{app_name}/shared"
+      def possible_to_detect_app_from_environment_name?
+        environment['apps'].length == 1
       end
       
-      # Used internally to determine whether we've decoded the API response yet.
-      def data_loaded?
-        defined?(@data) and @data.is_a? Hash
+      def possible_to_detect_environment_from_app_name?
+        return false unless EY.metadata.preset_app_name?
+        environments.sum { |e| e['apps'].sum { |a| (a['name'] == EY.metadata.app_name) ? 1 : 0 } } == 1
       end
       
-      # Used internally to store the full list of environments that the API gives us.
-      def environments
-        return @environments if @environments.is_a? Array
-        raw_json = REST.get(URL, 'X-EY-Cloud-Token' => EY::Metadata.ey_cloud_token).body
-        raw_data = ActiveSupport::JSON.decode raw_json
-        @environments = raw_data['environments']
+      def possible_to_detect_app_from_git_config?
+        return false unless repository_uri_from_git_config
+        environments.sum { |e| e['apps'].sum { |a| (a['repository_uri'] == repository_uri_from_git_config) ? 1 : 0 } } == 1
+      end
+      
+      def possible_to_detect_environment_from_git_config?
+        return false unless repository_uri_from_git_config
+        environments.any? { |e| e['apps'].any? { |a| a['repository_uri'] == repository_uri_from_git_config } }
       end
       
       # Used internally to store data about the specific environment we're working with.
-      def data
-        return @data if data_loaded?
-        matching_environments = environments.select do |environment|
-          if EY::Metadata.environment_name
-            environment['name'] == EY::Metadata.environment_name
-          else
-            environment['apps'].any? { |app| app['repository_uri'] == EY::Metadata.repository_uri }
-          end
+      def environment
+        hit = if EY.metadata.preset_environment_name?
+          environments.detect { |e| e['name'] == EY.metadata.environment_name }
+        elsif possible_to_detect_environment_from_app_name?
+          environments.detect { |e| e['apps'].any? { |a| a['name'] == EY.metadata.app_name } }
+        elsif possible_to_detect_environment_from_git_config?
+          environments.detect { |e| e['apps'].any? { |a| a['repository_uri'] == repository_uri_from_git_config } }
         end
-        raise RuntimeError, "[engineyard-metadata gem] Found too many environments: #{matching_environments.map { |environment| environments['name'] }.join(', ')}" if matching_environments.length > 1
-        @data = matching_environments[0]
-        raise RuntimeError, "[engineyard-metadata gem] Couldn't find an EngineYard environment with the repository uri #{repository_uri}" unless data_loaded?
-        @data
+        raise RuntimeError, "[engineyard-metadata gem] Couldn't find a matching environment. Please set EY.metadata.environment_name= or ENV['EY_ENVIRONMENT_NAME']" unless hit
+        hit
       end
     end
   end