engineyard-serverside-adapter 1.3.3 → 1.3.3.1

data/LICENSE

@@ -0,0 +1,19 @@
+ 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/README.md

@@ -0,0 +1,66 @@
+EY::Serverside::Adapter
+=======================
+
+This library provides an interface bound to the same version of
+engineyard-serverside.
+
+It tries very hard to throw an exception whenever the caller does
+anything wrong. The benefit of this is that you can depend on a newer
+version of engineyard-serverside-adapter and run your tests; if they
+pass, you can be fairly confident that your code will work with the
+newer version of engineyard-serverside.
+
+engineyard-serverside-adapter provides you with a builder to describe
+a cluster, and yields commands to the block you pass. Because it knows
+nothing about how to connect to a server, only what commands to run,
+it can be used anywhere where interaction with engineyard-serverside
+is needed.
+
+
+Example
+-------
+
+This example is adapted from the engineyard gem:
+
+    require 'engineyard-serverside-adapter'
+
+    def adapter(app, verbose)
+      EY::Serverside::Adapter.new("/usr/local/ey_resin/ruby/bin") do |args|
+        args.app           = app.name
+        args.repo          = app.repository_uri
+        args.instances     = environment.instances.map { |i| {:hostname => i.public_hostname, :role => i.role, :name => i.name} }
+        args.verbose       = verbose || ENV['DEBUG']
+        args.stack         = environment.stack_name
+        args.framework_env = environment.framework_env
+      end
+    end
+    private :adapter
+
+    def deploy(app, ref, migration_command=nil, extra_configuration=nil, verbose=false)
+      deploy_command = adapter(app, verbose).deploy do |args|
+        args.config  = extra_configuration if extra_configuration # anything that can be to_json'd
+        args.migrate = migration_command if migration_command
+        args.ref     = ref
+      end
+
+      deploy_command.call { |command| app_master.ssh(command) }
+    end
+
+You can set up args in Adapter.new, in Adapter#deploy (#rollback,
+ #restart, etc.), or in both. A good idea is to set up common args
+(e.g. app, instances) in Adapter.new and then supply deploy-specific
+args to Adapter#deploy. We hope this lets your code stay DRY while
+also avoiding unnecessary work from generating unnecessary args.
+
+Releasing
+---------
+
+Bump the version in lib/engineyard-serverside-adapter/version.rb, commit it, and then run
+
+    $ rake release
+
+This will tag and push for you.
+
+The engineyard gem depends on this gem to talk to the server side deploy mechanism.
+Update the version of engineyard-serverside-adapter in engineyard's Gemfile to
+interact with a new version of engineyard-serverside.

data/engineyard-serverside-adapter.gemspec

@@ -15,9 +15,10 @@ Gem::Specification.new do |s|
   s.rubyforge_project         = "engineyard-serverside-adapter"
 
   s.add_dependency             "escape",     "~> 0.0.4"
-  s.add_dependency             "json_pure",  "~> 1.4.6"
+  s.add_dependency             "json_pure"
   s.add_development_dependency "bundler",    ">= 1.0.0"
   s.add_development_dependency "rspec",      "~> 1.3.0"
+  s.add_development_dependency "rake"
 
   s.files        = `git ls-files`.split("\n")
   s.executables  = `git ls-files`.split("\n").map{|f| f =~ /^bin\/(.*)/ ? $1 : nil}.compact

data/lib/engineyard-serverside-adapter.rb

@@ -14,7 +14,10 @@ module EY
       autoload :Rollback,               'engineyard-serverside-adapter/rollback'
       autoload :VERSION,                'engineyard-serverside-adapter/version'
 
-      ENGINEYARD_SERVERSIDE_VERSION = ENV['ENGINEYARD_SERVERSIDE_VERSION'] || VERSION
+      # engineyard-serverside uses major.minor.patch; using a
+      # potentially-4-digit version lets us release fixes in the
+      # adapter while still keeping in version sync
+      ENGINEYARD_SERVERSIDE_VERSION = ENV['ENGINEYARD_SERVERSIDE_VERSION'] || VERSION.split('.')[0..2].join('.')
 
       def initialize(gem_bin_path = "")
         @gem_bin_path = Pathname.new(gem_bin_path)

data/lib/engineyard-serverside-adapter/version.rb

@@ -1,7 +1,7 @@
 module EY
   module Serverside
     class Adapter
-      VERSION = "1.3.3"
+      VERSION = "1.3.3.1"
     end
   end
 end

data/spec/deploy_spec.rb

@@ -42,7 +42,7 @@ describe EY::Serverside::Adapter::Deploy do
     end
 
     it "invokes exactly the right command" do
-      command.should == "engineyard-serverside _#{EY::Serverside::Adapter::VERSION}_ deploy --app rackapp --config '{\"a\":1}' --framework-env production --instance-names localhost:chewie --instance-roles localhost:han,solo --instances localhost --migrate 'rake db:migrate' --ref master --repo git@github.com:engineyard/engineyard-serverside.git --stack nginx_unicorn"
+      command.should == "engineyard-serverside _#{EY::Serverside::Adapter::ENGINEYARD_SERVERSIDE_VERSION}_ deploy --app rackapp --config '{\"a\":1}' --framework-env production --instance-names localhost:chewie --instance-roles localhost:han,solo --instances localhost --migrate 'rake db:migrate' --ref master --repo git@github.com:engineyard/engineyard-serverside.git --stack nginx_unicorn"
     end
   end
 end

data/spec/disable_maintenance_page_spec.rb

@@ -20,7 +20,7 @@ describe EY::Serverside::Adapter::DisableMaintenancePage do
     end
 
     it "invokes exactly the right command" do
-      command.should == "engineyard-serverside _#{EY::Serverside::Adapter::VERSION}_ deploy disable_maintenance_page --app rackapp --instance-names localhost:chewie --instance-roles localhost:han,solo --instances localhost"
+      command.should == "engineyard-serverside _#{EY::Serverside::Adapter::ENGINEYARD_SERVERSIDE_VERSION}_ deploy disable_maintenance_page --app rackapp --instance-names localhost:chewie --instance-roles localhost:han,solo --instances localhost"
     end
   end
 end

data/spec/enable_maintenance_page_spec.rb

@@ -21,7 +21,7 @@ describe EY::Serverside::Adapter::EnableMaintenancePage do
     end
 
     it "invokes exactly the right command" do
-      command.should == "engineyard-serverside _#{EY::Serverside::Adapter::VERSION}_ deploy enable_maintenance_page --app rackapp --instance-names localhost:chewie --instance-roles localhost:han,solo --instances localhost"
+      command.should == "engineyard-serverside _#{EY::Serverside::Adapter::ENGINEYARD_SERVERSIDE_VERSION}_ deploy enable_maintenance_page --app rackapp --instance-names localhost:chewie --instance-roles localhost:han,solo --instances localhost"
     end
   end
 

data/spec/integrate_spec.rb

@@ -26,7 +26,7 @@ describe EY::Serverside::Adapter::Integrate do
     end
 
     it "invokes exactly the right command" do
-      command.should == "engineyard-serverside _#{EY::Serverside::Adapter::VERSION}_ integrate --app rackapp --framework-env production --instance-names localhost:chewie --instance-roles localhost:han,solo --instances localhost --stack nginx_unicorn"
+      command.should == "engineyard-serverside _#{EY::Serverside::Adapter::ENGINEYARD_SERVERSIDE_VERSION}_ integrate --app rackapp --framework-env production --instance-names localhost:chewie --instance-roles localhost:han,solo --instances localhost --stack nginx_unicorn"
     end
   end
 end

data/spec/restart_spec.rb

@@ -23,7 +23,7 @@ describe EY::Serverside::Adapter::Restart do
     end
 
     it "invokes exactly the right command" do
-      command.should == "engineyard-serverside _#{EY::Serverside::Adapter::VERSION}_ restart --app rackapp --instance-names localhost:chewie --instance-roles localhost:han,solo --instances localhost --stack nginx_unicorn"
+      command.should == "engineyard-serverside _#{EY::Serverside::Adapter::ENGINEYARD_SERVERSIDE_VERSION}_ restart --app rackapp --instance-names localhost:chewie --instance-roles localhost:han,solo --instances localhost --stack nginx_unicorn"
     end
   end
 end

data/spec/rollback_spec.rb

@@ -31,7 +31,7 @@ describe EY::Serverside::Adapter::Rollback do
     end
 
     it "invokes exactly the right command" do
-      command.should == "engineyard-serverside _#{EY::Serverside::Adapter::VERSION}_ deploy rollback --app rackapp --config '{\"a\":1}' --framework-env production --instance-names localhost:chewie --instance-roles localhost:han,solo --instances localhost --stack nginx_unicorn"
+      command.should == "engineyard-serverside _#{EY::Serverside::Adapter::ENGINEYARD_SERVERSIDE_VERSION}_ deploy rollback --app rackapp --config '{\"a\":1}' --framework-env production --instance-names localhost:chewie --instance-roles localhost:han,solo --instances localhost --stack nginx_unicorn"
     end
   end
 end

data/spec/spec_helper.rb

@@ -79,7 +79,7 @@ Spec::Runner.configure do |config|
 
       installation_command.should =~ /gem list engineyard-serverside/
       installation_command.should =~ /egrep -q /
-      installation_command.should =~ /gem install engineyard-serverside.*-v #{Regexp.quote EY::Serverside::Adapter::VERSION}/
+      installation_command.should =~ /gem install engineyard-serverside.*-v #{Regexp.quote EY::Serverside::Adapter::ENGINEYARD_SERVERSIDE_VERSION}/
     end
   end
 

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification 
 name: engineyard-serverside-adapter
 version: !ruby/object:Gem::Version 
-  hash: 29
+  hash: 73
   prerelease: false
   segments: 
   - 1
   - 3
   - 3
-  version: 1.3.3
+  - 1
+  version: 1.3.3.1
 platform: ruby
 authors: []
 
@@ -40,14 +41,12 @@ dependencies:
   requirement: &id002 !ruby/object:Gem::Requirement 
     none: false
     requirements: 
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version 
-        hash: 11
+        hash: 3
         segments: 
-        - 1
-        - 4
-        - 6
-        version: 1.4.6
+        - 0
+        version: "0"
   type: :runtime
   version_requirements: *id002
 - !ruby/object:Gem::Dependency 
@@ -82,6 +81,20 @@ dependencies:
         version: 1.3.0
   type: :development
   version_requirements: *id004
+- !ruby/object:Gem::Dependency 
+  name: rake
+  prerelease: false
+  requirement: &id005 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        hash: 3
+        segments: 
+        - 0
+        version: "0"
+  type: :development
+  version_requirements: *id005
 description: A separate adapter for speaking the CLI language of the engineyard-serverside gem.
 email: []
 
@@ -94,6 +107,8 @@ extra_rdoc_files: []
 files: 
 - .gitignore
 - Gemfile
+- LICENSE
+- README.md
 - Rakefile
 - engineyard-serverside-adapter.gemspec
 - lib/engineyard-serverside-adapter.rb