engineyard-dns 0.4.0

data/.gitignore

@@ -0,0 +1,5 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*
+tmp

data/.rspec

@@ -0,0 +1,2 @@
+--format=progress
+--colour

data/.travis.yml

@@ -0,0 +1,5 @@
+rvm:
+  - 1.8.7
+  - 1.9.2
+  - rbx
+  - ree

data/ChangeLog.md

@@ -0,0 +1,29 @@
+# ChangeLog
+
+## v0.4.0 - 2011/5/23
+
+* supporting many DNS providers via fog
+* automatic discovery of which DNS provider hosts your domain
+* see README for setting up fog credentials
+
+## v0.3.0 - 2011/5/22
+
+* ey-dns assign DOMAIN NAME - can pass a subdomain name (only that record is created)
+
+## v0.2.0 - 2011/5/22
+
+* If [domain, name] pair already exists then prompt for override
+
+## v0.1.2 - 2011/5/22
+
+* Cucumber scenario is now working against http://test.dnsimple.com
+* Worth rereleasing gem just to celebrate
+
+## v0.1.1 - 2011/5/22
+
+* Create .myapp.com and www.myapp.com A records
+
+## v0.1.0 - 2011/5/22
+
+* Initial release
+* Basic implementation of `ey-dns assign DOMAIN`

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in engineyard-dns.gemspec
+gemspec

data/README.md

@@ -0,0 +1,106 @@
+# Simple DNS for Engine Yard AppCloud environments
+
+Currently creates A records for a domain (.myapp.com and www.myapp.com) to
+point to the public IP of an AppCloud environment.
+
+You can use any DNS provider supported by fog, including AWS Route 53, Blue Box, DNSimple, Linode, Slicehost and Zerigo.
+
+For example:
+
+<img src="https://img.skitch.com/20110523-x5mhutfr8r79parhuq7r44sqma.png">
+
+NOTE: This image is an artist's impression. Probably an artist who doesn't know how
+HTTP requests and DNS work. HTTP reqests don't go through DNSimple (or any DNS nameserver).
+The host in the URL is translated from myapp.com into an IP address (e.g. 1.2.3.4) by DNS. 
+The HTTP request then goes to the IP address. But the picture looks nice.
+
+## Usage
+
+First, setup DNS credentials in `~/.fog` (see below).
+
+Basic usage is very simple. Assuming you have registered `myapp.com`
+with one of your DNS providers, the following will automatically work:
+
+    $ ey-dns assign myapp.com
+    Found AppCloud environment giblets on account main with IP 1.2.3.4
+    Found myapp.com in DNSimple account
+
+    Assigning myapp.com --> 1.2.3.4 (drnic/myapp_production)
+    Assigning www.myapp.com --> 1.2.3.4 (drnic/myapp_production)
+
+If an AppCloud environment cannot be automatically detected, explicitly pass -e or -a flags
+like the `ey` CLI itself:
+
+    $ ey-dns assign myapp.com -e myapp_production
+
+If .myapp.com or www.myapp.com already exist you will be prompted to override them.
+You can force the override with the `--override` or `-o` flag.
+
+## Setup
+
+    $ gem install engineyard-dns
+
+To setup credentials for AppCloud, run the following command for the first time and
+you will be prompted for credentials:
+
+    $ ey environments --all
+
+To setup credentials for DNSimple, create a file `~/.fog` to look like:
+
+    :default:
+      :dnsimple_email:        EMAIL
+      :dnsimple_password:     PASSWORD
+
+To setup credentials for AWS Route 53, create a file `~/.fog` to look like:
+
+    :default:
+      :aws_access_key_id:     ACCESS_KEY
+      :aws_secret_access_key: SECRET_ACCESS_KEY
+
+If you have multiple DNS providers then add as many credentials within `:default`
+as you like.
+
+On Unix, make this file readable to you only:
+
+    $ chmod 600 ~/.fog
+
+Test you have fog working with your DNS provider:
+
+    $ fog
+    >> provider = 'DNSimple' # or 'AWS' or 'Slicehost' etc
+    >> Fog::DNS.new({:provider => provider}).zones.all.map(&:domain)
+    ["drnicwilliams.com", "emrubyconf.com", ...]
+
+
+## Development
+
+[![Build Status](http://travis-ci.org/engineyard/engineyard-dns.png)](http://travis-ci.org/engineyard/engineyard-dns)
+
+The test suite is purely cucumber scenarios. No rspec tests are being used. There are credentials for http://test.dnsimple.com built into the test suite. You should not have to do anything to run the tests except:
+
+    git clone git://github.com/engineyard/engineyard-dns.git
+    cd engineyard-dns
+    bundle
+    bundle exec rake
+
+## License
+
+Copyright (c) 2010 Engine Yard, Inc
+
+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/Rakefile

@@ -0,0 +1,24 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+
+desc "Run all examples"
+RSpec::Core::RakeTask.new
+
+namespace :cucumber do
+  require 'cucumber/rake/task'
+  Cucumber::Rake::Task.new(:wip, 'Run features that are being worked on') do |t|
+    t.cucumber_opts = "--tags @wip"
+  end
+  Cucumber::Rake::Task.new(:ok, 'Run features that should be working') do |t|
+    t.cucumber_opts = "--tags ~@wip"
+  end
+  task :all => [:ok, :wip]
+end
+
+desc 'Alias for cucumber:ok'
+task :cucumber => 'cucumber:ok'
+
+desc "Specs and Cucumber features by default"
+task :default => ["spec", "cucumber"]

data/bin/ey-dns

@@ -0,0 +1,17 @@
+#!/usr/bin/env ruby
+
+$:.unshift(File.expand_path(File.dirname(__FILE__) + "/../lib"))
+require 'engineyard-dns'
+require 'engineyard-dns/cli'
+
+begin
+  EngineYard::DNS::CLI.start
+rescue EY::Error => e
+  EY.ui.print_exception(e)
+  exit(1)
+rescue Interrupt => e
+  puts
+  EY.ui.print_exception(e)
+  EY.ui.say("Quitting...")
+  exit(1)
+end

data/engineyard-dns.gemspec

@@ -0,0 +1,35 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "engineyard-dns/version"
+
+Gem::Specification.new do |s|
+  s.name        = "engineyard-dns"
+  s.version     = EngineYard::DNS::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["Dr Nic Williams"]
+  s.email       = ["drnicwilliams@gmail.com"]
+  s.homepage    = "https://github.com/engineyard/engineyard-dns#readme"
+  s.summary     = %q{Configure your Engine Yard AppCloud environment and your DNSimple domain.}
+  s.description = %q{Easily configure your DNS with Engine Yard AppCloud via DNSimple.}
+
+  s.rubyforge_project = "engineyard-dns"
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+
+  s.add_dependency("thor")
+  s.add_dependency("engineyard")
+  s.add_dependency("fog")
+
+  s.add_development_dependency("rake", ["~> 0.9.0"])
+  s.add_development_dependency("cucumber", ["~> 0.10"])
+  s.add_development_dependency("rspec", ["~> 2.5"])
+  s.add_development_dependency("json", ["~>1.4.0"])
+  s.add_development_dependency("awesome_print")
+  s.add_development_dependency("realweb", '~>0.1.6')
+  s.add_development_dependency("open4")
+  s.add_development_dependency("sinatra")
+  s.add_development_dependency("fakeweb", "~>1.3.0")
+end

data/features/assign_dns_to_environment.feature

@@ -0,0 +1,74 @@
+Feature: Assign DNS to environment IP address via DNSimple
+  I want to assign DNS record to an AppCloud environment IP address
+
+  Background:
+    Given I have setup my engineyard email/password for API access
+    And I have "two apps" in AppCloud
+    And I have setup my fog credentials for "DNSimple"
+    And I have DNS domain "myapp.com" with provider "DNSimple"
+    
+  Scenario: Assign new DNS A Record to an environment
+    When I run local executable "ey-dns" with arguments "assign myapp.com --account main --environment giblets"
+    Then I should see exactly
+      """
+      Fetching AppCloud environment information...
+      Found AppCloud environment giblets on account main with IP 174.129.7.113
+      
+      Searching for myapp.com amongst your DNS providers...
+      Found myapp.com in DNSimple account
+      
+      Assigning myapp.com --> 174.129.7.113 (main/giblets)
+      Created A record for myapp.com
+      Assigning www.myapp.com --> 174.129.7.113 (main/giblets)
+      Created A record for www.myapp.com
+      Complete!
+      
+      """
+      # Found 2 records for myapp.com
+      #   .myapp.com (A)-> 174.129.7.113 (ttl:60, id:\d+)
+      #   www.myapp.com (A)-> 174.129.7.113 (ttl:60, id:\d+)
+  
+  Scenario: Resssign DNS A Record to an environment
+    When I run local executable "ey-dns" with arguments "assign myapp.com --account main --environment giblets"
+    And I run local executable "ey-dns" with arguments "assign myapp.com --account main --environment giblets --override"
+    Then I should see matching
+      """
+      Fetching AppCloud environment information...
+      Found AppCloud environment giblets on account main with IP 174.129.7.113
+      
+      Searching for myapp.com amongst your DNS providers...
+      Found myapp.com in DNSimple account
+      
+      Deleted myapp.com
+      Assigning myapp.com --> 174.129.7.113 (main/giblets)
+      Created A record for myapp.com
+      Deleted www.myapp.com
+      Assigning www.myapp.com --> 174.129.7.113 (main/giblets)
+      Created A record for www.myapp.com
+      Complete!
+      
+      """
+      # Found 2 records for myapp.com
+      #   .myapp.com (A)-> 174.129.7.113 (ttl:60, id:\d+)
+      #   www.myapp.com (A)-> 174.129.7.113 (ttl:60, id:\d+)
+
+  Scenario: Assign subdomain A Record to an environment
+    When I run local executable "ey-dns" with arguments "assign myapp.com staging --account main --environment giblets"
+    Then I should see exactly
+      """
+      Fetching AppCloud environment information...
+      Found AppCloud environment giblets on account main with IP 174.129.7.113
+      
+      Searching for myapp.com amongst your DNS providers...
+      Found myapp.com in DNSimple account
+      
+      Assigning staging.myapp.com --> 174.129.7.113 (main/giblets)
+      Created A record for staging.myapp.com
+      Complete!
+      
+      """
+      # Found 1 records for myapp.com
+      #   staging.myapp.com (A)-> 174.129.7.113 (ttl:60, id:\d+)
+
+  
+  

data/features/assign_dns_to_environment_via_different_dns_providers.feature

@@ -0,0 +1,26 @@
+Feature: Assign DNS to environment IP address
+  I want to assign DNS record to an AppCloud environment IP address
+
+  Background:
+    Given I have setup my engineyard email/password for API access
+    And I have "two apps" in AppCloud
+  
+  Scenario: Assign new DNS A Record to an environment via fog to DNSimple
+    Given I have setup my fog credentials for "DNSimple"
+    And I have DNS domain "myapp.com" with provider "DNSimple"
+    When I run local executable "ey-dns" with arguments "assign myapp.com --account main --environment giblets"
+    Then I should see exactly
+      """
+      Fetching AppCloud environment information...
+      Found AppCloud environment giblets on account main with IP 174.129.7.113
+      
+      Searching for myapp.com amongst your DNS providers...
+      Found myapp.com in DNSimple account
+      
+      Assigning myapp.com --> 174.129.7.113 (main/giblets)
+      Created A record for myapp.com
+      Assigning www.myapp.com --> 174.129.7.113 (main/giblets)
+      Created A record for www.myapp.com
+      Complete!
+      
+      """

data/features/step_definitions/common_steps.rb

@@ -0,0 +1,175 @@
+Given /^this project is active project folder/ do
+  @active_project_folder = File.expand_path(File.dirname(__FILE__) + "/../..")
+end
+
+Given /^env variable \$([\w_]+) set to "(.*)"/ do |env_var, value|
+  ENV[env_var] = value
+end
+
+Given /"(.*)" folder is deleted/ do |folder|
+  in_project_folder { FileUtils.rm_rf folder }
+end
+
+When /^I invoke "(.*)" generator with arguments "(.*)"$/ do |generator, arguments|
+  @stdout = StringIO.new
+  in_project_folder do
+    if Object.const_defined?("APP_ROOT")
+      APP_ROOT.replace(FileUtils.pwd)
+    else 
+      APP_ROOT = FileUtils.pwd
+    end
+    run_generator(generator, arguments.split(' '), SOURCES, :stdout => @stdout)
+  end
+  File.open(File.join(@tmp_root, "generator.out"), "w") do |f|
+    @stdout.rewind
+    f << @stdout.read
+  end
+end
+
+When /^I run executable "(.*)" with arguments "(.*)"/ do |executable, arguments|
+  @stdout = File.expand_path(File.join(@tmp_root, "executable.out"))
+  in_project_folder do
+    system "#{executable} #{arguments} > #{@stdout} 2> #{@stdout}"
+  end
+end
+
+When /^I run project executable "(.*)" with arguments "(.*)"/ do |executable, arguments|
+  @stdout = File.expand_path(File.join(@tmp_root, "executable.out"))
+  in_project_folder do
+    system "ruby #{executable} #{arguments} > #{@stdout} 2> #{@stdout}"
+  end
+end
+
+When /^I run local executable "(.*)" with arguments "(.*)"/ do |executable, arguments|
+  @stdout = File.expand_path(File.join(@tmp_root, "executable.out"))
+  executable = File.expand_path(File.join(File.dirname(__FILE__), "/../../bin", executable))
+  in_project_folder do
+    system "ruby #{executable} #{arguments} > #{@stdout} 2> #{@stdout}"
+  end
+end
+
+When /^I invoke task "rake (.*)"/ do |task|
+  @stdout = File.expand_path(File.join(@tmp_root, "tests.out"))
+  in_project_folder do
+    system "rake #{task} --trace > #{@stdout} 2> #{@stdout}"
+  end
+end
+
+Then /^folder "(.*)" (is|is not) created/ do |folder, is|
+  in_project_folder do
+    File.exists?(folder).should(is == 'is' ? be_true : be_false)
+  end
+end
+
+Then /^file "(.*)" (is|is not) created/ do |file, is|
+  in_project_folder do
+    File.exists?(file).should(is == 'is' ? be_true : be_false)
+  end
+end
+
+Then /^file with name matching "(.*)" is created/ do |pattern|
+  in_project_folder do
+    Dir[pattern].should_not be_empty
+  end
+end
+
+Then /^file "(.*)" contents (does|does not) match \/(.*)\// do |file, does, regex|
+  in_project_folder do
+    actual_output = File.read(file)
+    (does == 'does') ?
+      actual_output.should(match(/#{regex}/)) :
+      actual_output.should_not(match(/#{regex}/))
+  end
+end
+
+Then /gem file "(.*)" and generated file "(.*)" should be the same/ do |gem_file, project_file|
+  File.exists?(gem_file).should be_true
+  File.exists?(project_file).should be_true
+  gem_file_contents = File.read(File.dirname(__FILE__) + "/../../#{gem_file}")
+  project_file_contents = File.read(File.join(@active_project_folder, project_file))
+  project_file_contents.should == gem_file_contents
+end
+
+Then /^(does|does not) invoke generator "(.*)"$/ do |does_invoke, generator|
+  actual_output = File.read(@stdout)
+  does_invoke == "does" ?
+    actual_output.should(match(/dependency\s+#{generator}/)) :
+    actual_output.should_not(match(/dependency\s+#{generator}/))
+end
+
+Then /help options "(.*)" and "(.*)" are displayed/ do |opt1, opt2|
+  actual_output = File.read(@stdout)
+  actual_output.should match(/#{opt1}/)
+  actual_output.should match(/#{opt2}/)
+end
+
+Then /^I should see "([^\"]*)"$/ do |text|
+  actual_output = File.read(@stdout)
+  actual_output.should contain(text)
+end
+
+Then /^I should see$/ do |text|
+  actual_output = File.read(@stdout)
+  actual_output.should contain(text)
+end
+
+Then /^I should not see$/ do |text|
+  actual_output = File.read(@stdout)
+  actual_output.should_not contain(text)
+end
+
+Then /^I should see exactly$/ do |text|
+  actual_output = File.read(@stdout)
+  actual_output.should == text
+end
+
+Then /^I should see matching$/ do |text|
+  regexp = Regexp.new(text.gsub("(", '\(').gsub(")", '\)'))
+  actual_output = File.read(@stdout)
+  actual_output.should match(regexp)
+end
+
+
+Then /^I should see all (\d+) tests pass/ do |expected_test_count|
+  expected = %r{^#{expected_test_count} tests, \d+ assertions, 0 failures, 0 errors}
+  actual_output = File.read(@stdout)
+  actual_output.should match(expected)
+end
+
+Then /^I should see all (\d+) examples pass/ do |expected_test_count|
+  expected = %r{^#{expected_test_count} examples?, 0 failures}
+  actual_output = File.read(@stdout)
+  actual_output.should match(expected)
+end
+
+Then /^yaml file "(.*)" contains (\{.*\})/ do |file, yaml|
+  in_project_folder do
+    yaml = eval yaml
+    YAML.load(File.read(file)).should == yaml
+  end
+end
+
+Then /^Rakefile can display tasks successfully/ do
+  @stdout = File.expand_path(File.join(@tmp_root, "rakefile.out"))
+  in_project_folder do
+    system "rake -T > #{@stdout} 2> #{@stdout}"
+  end
+  actual_output = File.read(@stdout)
+  actual_output.should match(/^rake\s+\w+\s+#\s.*/)
+end
+
+Then /^task "rake (.*)" is executed successfully/ do |task|
+  @stdout.should_not be_nil
+  actual_output = File.read(@stdout)
+  actual_output.should_not match(/^Don't know how to build task '#{task}'/)
+  actual_output.should_not match(/Error/i)
+end
+
+Then /^gem spec key "(.*)" contains \/(.*)\// do |key, regex|
+  in_project_folder do
+    gem_file = Dir["pkg/*.gem"].first
+    gem_spec = Gem::Specification.from_yaml(`gem spec #{gem_file}`)
+    spec_value = gem_spec.send(key.to_sym)
+    spec_value.to_s.should match(/#{regex}/)
+  end
+end

data/features/step_definitions/dnsimple_steps.rb

@@ -0,0 +1,9 @@
+Given /^I have setup my dnsimple credentials$/ do
+  setup_dnsimple_credentials
+end
+
+Given /^I have DNSimple domain "([^"]*)"$/ do |domain|
+  create_dnsimple_domain domain
+end
+
+

data/features/step_definitions/ey_api_steps.rb

@@ -0,0 +1,15 @@
+Given /^I have setup my engineyard email\/password for API access$/ do
+  ENV['EYRC'] = File.join(@home_path, ".eyrc")
+  token = { ENV['CLOUD_URL'] => {
+      "api_token" => "f81a1706ddaeb148cfb6235ddecfc1cf"} }
+  File.open(ENV['EYRC'], "w"){|f| YAML.dump(token, f) }
+end
+
+When /^I have "two accounts, two apps, two environments, ambiguous" in AppCloud$/ do
+  api_scenario "two accounts, two apps, two environments, ambiguous"
+end
+
+# has a known public IP in its hostname ec2-174-129-7-113.compute-1.amazonaws.com
+When /^I have "two apps" in AppCloud$/ do
+  api_scenario "two apps"
+end

data/features/step_definitions/fog_steps.rb

@@ -0,0 +1,7 @@
+Given /^I have setup my fog credentials for "([^"]*)"$/ do |provider|
+  setup_dns_credentials(provider)
+end
+
+Given /^I have DNS domain "([^"]*)" with provider "([^"]*)"$/ do |domain, provider|
+  setup_domain(provider, domain)
+end

data/features/support/common.rb

@@ -0,0 +1,29 @@
+module CommonHelpers
+  def in_tmp_folder(&block)
+    FileUtils.chdir(@tmp_root, &block)
+  end
+
+  def in_project_folder(&block)
+    project_folder = @active_project_folder || @tmp_root
+    FileUtils.chdir(project_folder, &block)
+  end
+
+  def in_home_folder(&block)
+    FileUtils.chdir(@home_path, &block)
+  end
+
+  def force_local_lib_override(project_name = @project_name)
+    rakefile = File.read(File.join(project_name, 'Rakefile'))
+    File.open(File.join(project_name, 'Rakefile'), "w+") do |f|
+      f << "$:.unshift('#{@lib_path}')\n"
+      f << rakefile
+    end
+  end
+
+  def setup_active_project_folder project_name
+    @active_project_folder = File.join(@tmp_root, project_name)
+    @project_name = project_name
+  end
+end
+
+World(CommonHelpers)

data/features/support/engineyard.rb

@@ -0,0 +1,24 @@
+engineyard_loaded_path = $:.select { |path| path =~ %r|gems/engineyard-\d+| }.first
+EY_ROOT = engineyard_loaded_path.gsub(%r|/\w+$|,'')
+
+# helper to be stubbed out from engineyard spec_helper.rb
+def shared_examples_for(title)
+end
+
+support = Dir[File.join(EY_ROOT,'/spec/support/*.rb')]
+support.each{|helper| require helper }
+World(Spec::Helpers)
+
+require "fakeweb"
+
+Before do
+  ENV["NO_SSH"] = "true"
+  ENV['CLOUD_URL'] = EY.fake_awsm
+  FakeWeb.allow_net_connect = true
+end
+
+After do
+  ENV.delete('CLOUD_URL')
+  ENV.delete('EYRC')
+  ENV.delete('NO_SSH')
+end

data/features/support/env.rb

@@ -0,0 +1,21 @@
+$:.unshift(File.expand_path(File.dirname(__FILE__) + '/../../lib'))
+require 'bundler/setup'
+require 'engineyard-dns'
+require 'dnsimple'
+require 'dnsimple/cli'
+require 'fog'
+
+path = ENV['PATH']
+
+Before do
+  @tmp_root      = File.dirname(__FILE__) + "/../../tmp"
+  @active_project_folder = @tmp_root
+  @home_path     = File.expand_path(File.join(@tmp_root, "home"))
+  @lib_path      = File.expand_path(File.dirname(__FILE__) + "/../../lib")
+  @fixtures_path = File.expand_path(File.dirname(__FILE__) + "/../../fixtures")
+  FileUtils.rm_rf   @tmp_root
+  FileUtils.mkdir_p @home_path
+  ENV['HOME'] = @home_path
+  fixture_bin_path = File.expand_path('../../../fixtures/bin', __FILE__)
+  ENV['PATH'] = fixture_bin_path + ":" + path
+end

data/features/support/fog_helpers.rb

@@ -0,0 +1,26 @@
+module FogHelpers
+  def setup_dns_credentials(provider)
+    email, password = "ossgrants+dns@engineyard.com", "ossgrants1"
+    File.open("#{ENV['HOME']}/.fog", "w") do |file|
+      @credentials = case provider.to_sym
+      when :DNSimple
+        { :dnsimple_email => email, :dnsimple_password => password}
+      else
+        raise "No credentials available for provider '#{provider}'"
+      end
+      file << YAML::dump(:default => @credentials)
+    end
+  end
+  
+  def setup_domain(provider, domain)
+    dns_provider(provider).zones.select { |z| z.domain == domain }.each do |domain|
+      domain.destroy
+    end
+    dns_provider(provider).zones.create(:domain => domain)
+  end
+  
+  def dns_provider(provider)
+    @dns_provider ||= Fog::DNS.new({:provider => provider})
+  end
+end
+World(FogHelpers)

data/features/support/matchers.rb

@@ -0,0 +1,11 @@
+module Matchers
+  def contain(expected)
+    simple_matcher("contain #{expected.inspect}") do |given, matcher|
+      matcher.failure_message = "expected #{given.inspect} to contain #{expected.inspect}"
+      matcher.negative_failure_message = "expected #{given.inspect} not to contain #{expected.inspect}"
+      given.index expected
+    end
+  end
+end
+
+World(Matchers)

data/lib/engineyard-dns.rb

@@ -0,0 +1,5 @@
+module EngineYard
+  module DNS
+    # Your code goes here...
+  end
+end

data/lib/engineyard-dns/cli.rb

@@ -0,0 +1,166 @@
+require "engineyard"
+require "engineyard/thor"
+require "engineyard/cli"
+require "engineyard/cli/ui"
+require "engineyard/error"
+require "fog"
+require "fog/bin"
+
+module EngineYard
+  module DNS
+    class CLI < Thor
+      include EY::UtilityMethods
+      # include Thor::Actions
+
+      def self.start(*)
+        Thor::Base.shell = EY::CLI::UI
+        EY.ui = EY::CLI::UI.new
+        super
+      end
+
+
+      desc "assign DOMAIN [NAME]", "Assign DNS domain/tld (or name.tld) to your AppCloud environment"
+      method_option :verbose, :aliases     => ["-V"], :desc => "Display more output"
+      method_option :environment, :aliases => ["-e"], :desc => "Environment in which to deploy this application", :type => :string
+      method_option :account, :aliases     => ["-c"], :desc => "Name of the account you want to deploy in"
+      method_option :override, :aliases    => ["-o"], :type => :boolean, :desc => "Override DNSimple records if they already exist"
+      def assign(domain_name, name = "")
+        say "Fetching AppCloud environment information..."; $stdout.flush
+        
+        environment = fetch_environment(options[:environment], options[:account])
+        account_name, env_name = environment.account.name, environment.name
+        unless environment.instances.first
+          error "Environment #{account_name}/#{env_name} has no booted instances."
+        end
+        public_hostname = environment.instances.first.public_hostname
+        status          = environment.instances.first.status
+        
+        # TODO - use DNS client to convert public_hostname into IP address
+        unless public_hostname =~ /ec2-(\d+)-(\d+)-(\d+)-(\d+)/
+          error "Cannot determine public IP from current hostname #{public_hostname}"
+        end
+        public_ip = "#{$1}.#{$2}.#{$3}.#{$4}"
+
+        say "Found AppCloud environment #{env_name} on account #{account_name} with IP #{public_ip}"        
+        
+        say ""
+        say "Searching for #{domain_name} amongst your DNS providers..."; $stdout.flush
+
+        domain, provider_name = find_domain(domain_name)
+        unless domain
+          error "Please register domain #{domain_name} with your DNS provider"
+        end
+        say "Found #{domain_name} in #{provider_name} account"
+        say ""; $stdout.flush
+        
+        assign_dns(domain, account_name, env_name, public_ip, name, options[:override])
+        assign_dns(domain, account_name, env_name, public_ip, "www", options[:override]) if name == ""
+          
+        say "Complete!", :green
+        
+        # ::DNSimple::Commands::ListRecords.new.execute([domain])
+      end
+      
+      desc "version", "show version information"
+      def version
+        require 'engineyard-jenkins/version'
+        shell.say Engineyard::Jenkins::VERSION
+      end
+
+      map "-v" => :version, "--version" => :version, "-h" => :help, "--help" => :help
+
+      private
+      def say(msg, color = nil)
+        color ? shell.say(msg, color) : shell.say(msg)
+      end
+
+      def display(text)
+        shell.say text
+        exit
+      end
+
+      def error(text)
+        shell.say "ERROR: #{text}", :red
+        exit
+      end
+      
+      def watch_page_while(host, port, path)
+        waiting = true
+        while waiting
+          begin
+            Net::HTTP.start(host, port) do |http|
+              req = http.get(path)
+              waiting = yield req
+            end
+            sleep 1; print '.'; $stdout.flush
+          rescue SocketError => e
+            sleep 1; print 'x'; $stdout.flush
+          rescue Exception => e
+            puts e.message
+            sleep 1; print '.'; $stdout.flush
+          end
+        end
+      end
+      
+      # Discover which DNS provider (DNSimple, etc) is controlling +domain_name+ (a zone)
+      # and return [domain/zone, provider name]
+      #
+      # TODO remove hard-wiring for dnsimple; and discover which provider hosts domain/zone
+      # TODO how to get provider name (2nd result) from fog's Zone class? (no need to return 2nd arg)
+      def find_domain(domain_name)
+        dns_provider_names.each do |provider|
+          dns_provider = ::Fog::DNS.new({:provider => provider})
+          if domain = dns_provider.zones.select {|z| z.domain == domain_name}.first
+            return [domain, provider]
+          end
+        end
+        [nil, nil]
+      end
+      
+      def assign_dns(domain, account_name, env_name, public_ip, name = "", override = false)
+        if record = domain.records.select {|r| r.name == name}.first
+          if override || ask_override_dns?(domain, name)
+            record.destroy
+            say "Deleted #{domain_name domain, name}"
+          else
+            error "Cannot replace existing #{domain_name domain, name} DNS"
+          end
+        end
+        say "Assigning "; say "#{domain_name domain, name} ", :green; say "--> "; say "#{public_ip} ", :green; say "(#{account_name}/#{env_name})"
+        $stdout.flush
+        
+        record = domain.records.create(:ip => public_ip, :name => name, :type => "A", :ttl => "60")
+        say "Created A record for #{domain_name domain, name}"
+      end
+      
+      def ask_override_dns?(domain, name)
+        ui = EY::CLI::UI::Prompter.backend
+        ui.agree("Replace #{domain_name domain, name}: ", "y")
+      end
+      
+      # "myapp.com", "name" => "name.myapp.com"
+      # "myapp.com", ""     => "myapp.com"
+      def domain_name(domain, name = nil)
+        if name && name.length > 0
+          "#{name}.#{domain.domain}"
+        else
+          domain.domain
+        end
+      end
+      
+      # Returns the list of DNS providers that the current user has access to
+      # Includes the +fog_dns_providers+ list
+      # TODO find credentials in alternate locations (e.g. ~/.dnsimple)
+      def dns_provider_names
+        fog_dns_provider_names
+      end
+      
+      # Returns the list of DNS providers that the current user has fog credentials
+      # TODO how do I get the base list from fog?
+      def fog_dns_provider_names
+        ['AWS', 'Bluebox', 'DNSimple', 'Linode', 'Slicehost', 'Zerigo'] & Fog.providers
+      end
+      
+    end
+  end
+end

data/lib/engineyard-dns/version.rb

@@ -0,0 +1,5 @@
+module EngineYard
+  module DNS
+    VERSION = "0.4.0"
+  end
+end

data/posts/engineyard-2011-05-24.md

@@ -0,0 +1,34 @@
+# Simple DNS for AppCloud with DNSimple
+
+For me, one of the things I liked to do with a new AppCloud application is to attached a pretty domain. The default AWS EC2 URL doesn't glorify my fine efforts.
+
+I've started using the new [DNSimple](http://dnsimple.com/) as my DNS registrar and name server, and I believe an increasing number of AppCloud customers are too.
+
+To make setting up DNS easier with AppCloud, we've released the `ey-dns` command line application.
+
+It's really quite easy to use:
+
+1. Register your application's domain with [DNSimple](http://dnsimple.com/)
+2. Transfer your domain to DNSimple or change the name servers to ns1.dnsimple.com (ns2, ns3, etc)
+3. Install and run the command line application:
+
+    $ gem install engineyard-dns
+    $ cd path/to/my/app
+    $ ey-dns apply myapp.com
+    Assigning myapp.com --> 1.2.3.4 (drnic/myapp_production)
+    Assigning www.myapp.com --> 1.2.3.4 (drnic/myapp_production)
+
+    Found 2 records for myapp.com
+    	.myapp.com (A)-> 1.2.3.4 (ttl:, id:12345)
+    	www.myapp.com (A)-> 1.2.3.4 (ttl:, id:12346)
+
+If you have previously assigned the domain records to another host, it will prompt you to change them. 
+
+If there is any confusion about which AppCloud environment is hosting your application, it will show you your options and then you can use the `--environment` and `--account` options to be more specific:
+
+    $ ey-dns apply myapp.com --environment myapp_production
+    $ ey-dns apply myapp.com staging --environment myapp_staging
+
+Hopefully this tool makes it much easier to setup or change DNS for your AppCloud environments. Let us know in the comments or in the project's [Issues](https://github.com/engineyard/engineyard-dns/issues) if you love it, find bugs or have feature requests.
+
+The source and instructions for the project is [available on GitHub](https://github.com/engineyard/engineyard-dns#readme).

data/spec/spec_helper.rb

@@ -0,0 +1,11 @@
+require 'bundler'
+Bundler.setup
+require 'rspec'
+
+Dir[File.dirname(__FILE__) + '/support/*'].each{|path| require path}
+
+require 'engineyard-dns'
+
+RSpec.configure do |config|
+
+end

metadata

@@ -0,0 +1,223 @@
+--- !ruby/object:Gem::Specification 
+name: engineyard-dns
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.4.0
+platform: ruby
+authors: 
+- Dr Nic Williams
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-05-23 00:00:00 -07:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: thor
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: engineyard
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+- !ruby/object:Gem::Dependency 
+  name: fog
+  prerelease: false
+  requirement: &id003 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :runtime
+  version_requirements: *id003
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id004 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.9.0
+  type: :development
+  version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: cucumber
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "0.10"
+  type: :development
+  version_requirements: *id005
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  prerelease: false
+  requirement: &id006 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: "2.5"
+  type: :development
+  version_requirements: *id006
+- !ruby/object:Gem::Dependency 
+  name: json
+  prerelease: false
+  requirement: &id007 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.4.0
+  type: :development
+  version_requirements: *id007
+- !ruby/object:Gem::Dependency 
+  name: awesome_print
+  prerelease: false
+  requirement: &id008 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id008
+- !ruby/object:Gem::Dependency 
+  name: realweb
+  prerelease: false
+  requirement: &id009 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 0.1.6
+  type: :development
+  version_requirements: *id009
+- !ruby/object:Gem::Dependency 
+  name: open4
+  prerelease: false
+  requirement: &id010 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id010
+- !ruby/object:Gem::Dependency 
+  name: sinatra
+  prerelease: false
+  requirement: &id011 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+  type: :development
+  version_requirements: *id011
+- !ruby/object:Gem::Dependency 
+  name: fakeweb
+  prerelease: false
+  requirement: &id012 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ~>
+      - !ruby/object:Gem::Version 
+        version: 1.3.0
+  type: :development
+  version_requirements: *id012
+description: Easily configure your DNS with Engine Yard AppCloud via DNSimple.
+email: 
+- drnicwilliams@gmail.com
+executables: 
+- ey-dns
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- .rspec
+- .travis.yml
+- ChangeLog.md
+- Gemfile
+- README.md
+- Rakefile
+- bin/ey-dns
+- engineyard-dns.gemspec
+- features/assign_dns_to_environment.feature
+- features/assign_dns_to_environment_via_different_dns_providers.feature
+- features/step_definitions/common_steps.rb
+- features/step_definitions/dnsimple_steps.rb
+- features/step_definitions/ey_api_steps.rb
+- features/step_definitions/fog_steps.rb
+- features/support/common.rb
+- features/support/engineyard.rb
+- features/support/env.rb
+- features/support/fog_helpers.rb
+- features/support/matchers.rb
+- lib/engineyard-dns.rb
+- lib/engineyard-dns/cli.rb
+- lib/engineyard-dns/version.rb
+- posts/engineyard-2011-05-24.md
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: https://github.com/engineyard/engineyard-dns#readme
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+requirements: []
+
+rubyforge_project: engineyard-dns
+rubygems_version: 1.6.2
+signing_key: 
+specification_version: 3
+summary: Configure your Engine Yard AppCloud environment and your DNSimple domain.
+test_files: 
+- features/assign_dns_to_environment.feature
+- features/assign_dns_to_environment_via_different_dns_providers.feature
+- features/step_definitions/common_steps.rb
+- features/step_definitions/dnsimple_steps.rb
+- features/step_definitions/ey_api_steps.rb
+- features/step_definitions/fog_steps.rb
+- features/support/common.rb
+- features/support/engineyard.rb
+- features/support/env.rb
+- features/support/fog_helpers.rb
+- features/support/matchers.rb
+- spec/spec_helper.rb