dumbwaiter 0.3.1 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 7eec67cf367b40acf1fccfefbd0d5fc9ec93cf08
-  data.tar.gz: fef98f893af0c623fde70042cde497a97d8dad41
+  metadata.gz: 20f20eaec8369f54bbc83d62f0ade5f99a735f98
+  data.tar.gz: 1c4eca739c2b72e96ee6908df4ace69fc688f081
 SHA512:
-  metadata.gz: 4d277b944f4eeb954bfce508a9c46858f3a9b59471bf5cddd77f3823b291f56d0d5aa12c9de18efe8feac19fdc4a9dc0714d09982dec1eac17fc9bb8ac12d8bf
-  data.tar.gz: 6b67dad773822e0c930bfd44871defcb6b39b36ebbaa283d03c935a632b74e38549acc8c01cc09cb350ec343ba60f65e960bd271893ecf1fffd9a3248be6e13b
+  metadata.gz: fc160beefbabeca4bc392e0b75c8c80d5e94a4abf2aadde4c39c10dbad7e0a5cf3d82cc26164a7d182fb23c7864c2a2bf5a87ba5967b929f434c43fbe7d0b9f7
+  data.tar.gz: 2bad21df531df0ea6ec2ba1f4b394a2ebc6528f627d0b72ff440035c248f1fa1b5899e9385fdccba0af9ebd24ed6d8433e6b8485dbf91dadc3d0f950b9974d0c

data/README.md

@@ -5,6 +5,39 @@ Dumbwaiter hoists your Rails application up to OpsWorks and ratchets deployment
 information back down.
 
 
+Origin
+------
+
+Before Scalarium became OpsWorks, they maintained a gem that did the sorts of
+functions described here.  Like Heroku Toolbelt, the Scalarium gem offered users
+a very basic workflow experience: upload and run Chef recipes, execute commands
+remotely and watch their output.
+
+
+Goals
+-----
+
+Dumbwaiter prescribes a very specific OpsWorks-centric workflow with the same
+feeling of the Scalarium gem's CLI:
+
+  * Create OpsWorks stacks, layers and instances via YAML files
+  * Collect custom Chef cookbooks via Berkshelf and upload to S3
+  * Create an application corresponding to a GitHub repo
+  * Run versioned deployments, rollbacks and one-off recipes
+
+
+Non-Goals
+---------
+
+Dumbwaiter only deals with OpsWorks workflow, excluding:
+
+  * Standing up VPCs
+  * Running CloudFormation templates
+  * One-off bash-level commands(^) and log tailing
+
+`^ Making a cookbook to run one-off commands is totally not unheard-of.`
+
+
 Installation
 ------------
 
@@ -28,14 +61,18 @@ Deploy the "cinnamon" branch of the "syrup" application to the "Pancake" stack:
 
   `dumbwaiter deploy Pancake syrup cinnamon`
 
-Roll back the "Snowman" stack's "dandruff" application:
-
-  `dumbwaiter rollback Snowman dandruff`
-
 List the deployments on the "Maniacal Checklist" stack:
 
   `dumbwaiter list "Maniacal Checklist"`
 
+Upload all the custom cookbooks for the "Sweden" stack:
+
+  `dumbwaiter rechef Sweden`
+
+Roll back the "Snowman" stack's "dandruff" application:
+
+  `dumbwaiter rollback Snowman dandruff`
+
 List the stacks and apps in your OpsWorks environment:
 
   `dumbwaiter stacks`

data/lib/dumbwaiter/cli.rb

@@ -14,21 +14,12 @@ module Dumbwaiter
       raise Thor::Error.new(e.message)
     end
 
-    desc "rollback STACK_NAME APP_NAME", "Roll back an application"
-    def rollback(stack_name, app_name)
-      stack = Stack.find(stack_name)
-      app = App.find(stack, app_name)
-      app.rollback
-    rescue Dumbwaiter::Stack::NotFound, Dumbwaiter::App::NotFound => e
-      raise Thor::Error.new(e.message)
-    end
-
     desc "list STACK_NAME", "List all the deployments for a stack"
     def list(stack_name)
       stack = Stack.find(stack_name)
 
       deployments = stack.deployments.select do |deployment|
-        %w(rollback deploy).include?(deployment.command_name)
+        %w(rollback deploy update_custom_cookbooks).include?(deployment.command_name)
       end
 
       deployments.each do |deployment|
@@ -38,6 +29,22 @@ module Dumbwaiter
       raise Thor::Error.new(e.message)
     end
 
+    desc "rechef STACK", "Upload new cookbooks to a stack"
+    def rechef(stack_name)
+      Stack.find(stack_name).rechef
+    rescue Dumbwaiter::Stack::NotFound => e
+      raise Thor::Error.new(e.message)
+    end
+
+    desc "rollback STACK_NAME APP_NAME", "Roll back an application"
+    def rollback(stack_name, app_name)
+      stack = Stack.find(stack_name)
+      app = App.find(stack, app_name)
+      app.rollback
+    rescue Dumbwaiter::Stack::NotFound, Dumbwaiter::App::NotFound => e
+      raise Thor::Error.new(e.message)
+    end
+
     desc "stacks", "List all the stacks"
     def stacks
       Stack.all.each { |stack| Kernel.puts("#{stack.name}: #{stack.apps.map(&:name).join(', ')}") }

data/lib/dumbwaiter/stack.rb

@@ -36,4 +36,8 @@ class Dumbwaiter::Stack
   def deployments
     @deployments ||= Dumbwaiter::Deployment.all(self, opsworks)
   end
+
+  def rechef
+    opsworks.create_deployment(stack_id: id, command: {name: "update_custom_cookbooks"})
+  end
 end

data/lib/dumbwaiter/version.rb

@@ -1,3 +1,3 @@
 module Dumbwaiter
-  VERSION = "0.3.1"
+  VERSION = "0.3.2"
 end

data/spec/lib/dumbwaiter/cli_spec.rb

@@ -79,6 +79,15 @@ describe Dumbwaiter::Cli do
         end
       end
 
+      context "when the deployment is a custom cookbook update" do
+        let(:fake_deployment) { double(:deployment, command_name: "update_custom_cookbooks", to_log: "whee!") }
+
+        it "lists the deployment" do
+          Kernel.should_receive(:puts).with("whee!")
+          cli.list("ducks")
+        end
+      end
+
       context "when the deployment is something else" do
         let(:fake_deployment) { double(:deployment, command_name: "gargle", to_log: "brblrgl") }
 
@@ -102,4 +111,19 @@ describe Dumbwaiter::Cli do
       cli.stacks
     end
   end
+
+  describe "#rechef" do
+    context "when the stack exists" do
+      it "deploys the stack with the resolved id" do
+        fake_stack.should_receive(:rechef)
+        cli.rechef("ducks")
+      end
+    end
+
+    context "when the stack does not exist" do
+      it "blows up" do
+        expect { cli.rechef("toques") }.to raise_error(Thor::Error)
+      end
+    end
+  end
 end

data/spec/lib/dumbwaiter/stack_spec.rb

@@ -7,7 +7,7 @@ describe Dumbwaiter::Stack do
   let(:fake_app) { double(:app) }
   let(:fake_deployment) { double(:deployment) }
 
-  subject(:stack) { Dumbwaiter::Stack.new(fake_stack) }
+  subject(:stack) { Dumbwaiter::Stack.new(fake_stack, fake_opsworks) }
 
   before do
     Dumbwaiter::App.stub(all: [fake_app])
@@ -42,4 +42,14 @@ describe Dumbwaiter::Stack do
       end
     end
   end
+
+  describe "#rechef" do
+    it "creates a deployment" do
+      fake_opsworks.should_receive(:create_deployment) do |params|
+        params[:stack_id].should == "cool"
+        params[:command].should == {name: "update_custom_cookbooks"}
+      end
+      stack.rechef
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: dumbwaiter
 version: !ruby/object:Gem::Version
-  version: 0.3.1
+  version: 0.3.2
 platform: ruby
 authors:
 - Doc Ritezel
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-12-10 00:00:00.000000000 Z
+date: 2013-12-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core