Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Retrieve environment and host information from your Engine Yard account, providing detailed information for each EC2 instance.
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
lib Bump to 0.9.2
spec Update to rest-client, and readme
.gitignore Ignore Gemfile.lock
Gemfile Fix dependencies
LICENSE Update copyright Update copyright
Rakefile Update to rest-client, and readme
ey_aws.gemspec Fix dependencies


ey_aws will connect EngineYard and AWS to and retrieve environment and instance data from both, this allows us to view which environments we have and metadata for each instance which makes up each enironment. It can be useful to find out instance sizes, IP addresses and attached storage for each running instance.


gem install ey_aws


This gem may be used from the command line to display a formatted Hash describing all your environments and instances. If running from the command line you must set some environment variables before executing ey_aws.

ACCESS_KEY_ID/SECRET_ACCESS_KEY are required for AWS authentication, and EY_CLOUD_TOKEN (which can be found in ~/.eyrc) for EngineYard.

From the command line

export ACCESS_KEY_ID='...'
export SECRET_ACCESS_KEY='...'
export EY_CLOUD_TOKEN='...'

Or from your application

require 'ey_aws'

data ={
  :access_key_id     => 'AWS_ACCESS_KEY',
  :secret_access_key => 'AWS_SECRET_KEY',
  :ey_cloud_token    => 'EY_CLOUD_TOKEN' })

pp data[:environments]


  :account=>{:id=>1234, :name=>"account"},
     :public_hostname=> "",
     :launch_time=>2012-06-13 23:14:52 UTC,
        :attach_time=>2012-06-13 23:15:59 UTC,
          :create_time=>2012-06-13 23:15:55 UTC,
     :account=>{:id=>1234, :name=>"account"}}],
      :migrate=>{:perform=>false, :command=>""},


bundle exec rake spec


An alternative to this gem is the engineyard-metadata gem which also provides similar functionality, engineyard-metadata also supports returning local data from the chef dna.json file when executed from an EC2 instance.

Known Issues

Y U SO SLOW? It couldn't hurt to help speed this library up, it will generally take about 60 seconds for a reasonably sized environment. This may be able to be helped by memoising the additional AWS calls.


Copyright (c) 2012 Hooroo. See LICENSE for details.

Something went wrong with that request. Please try again.