beanstalkify 0.0.1

data/.gitignore

@@ -0,0 +1,2 @@
+credentials.yml
+config.yml

data/Gemfile

@@ -0,0 +1,4 @@
+source :rubygems
+
+gem 'rake'
+gemspec

data/Gemfile.lock

@@ -0,0 +1,34 @@
+PATH
+  remote: .
+  specs:
+    beanstalkify (0.0.1)
+      aws-sdk
+
+GEM
+  remote: http://rubygems.org/
+  specs:
+    aws-sdk (1.14.1)
+      json (~> 1.4)
+      nokogiri (< 1.6.0)
+      uuidtools (~> 2.1)
+    diff-lcs (1.2.4)
+    json (1.8.0)
+    nokogiri (1.5.10)
+    rake (10.0.3)
+    rspec (2.14.1)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    rspec-core (2.14.4)
+    rspec-expectations (2.14.0)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.2)
+    uuidtools (2.1.4)
+
+PLATFORMS
+  ruby
+
+DEPENDENCIES
+  beanstalkify!
+  rake
+  rspec

data/LICENSE

@@ -0,0 +1,13 @@
+Copyright (c) 2013 Pranav Raja.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted, provided that the above
+copyright notice and this permission notice appear in all copies.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

data/README.md

@@ -0,0 +1,58 @@
+
+[AWS Elastic Beanstalk](http://aws.amazon.com/elasticbeanstalk/) automation. A work in progress.
+
+# Prerequisites
+
+- Ruby 1.9
+
+# Installation
+
+    gem install beanstalkify
+
+Create a file called `credentials.yml`, with the following format:
+
+    access_key_id: A98KJHBLABLABLA
+    secret_access_key: dkuU90kmySuperSecretKey
+    region: us-east-1
+
+# Running
+
+    beanstalkify -k credentials.yml -a app-version.zip -s "64bit Amazon Linux running Node.js" -e env [-c config.yml]
+
+Should do the following
+
+- Connect to aws using the credentials in `credentials.yml`
+- Publish `app-version.zip` to s3
+- Ensure that a beanstalk application called 'app' exists, and add a version called 'version', linked to the archive in that s3 bucket
+- Ensure that the environment `env` exists (with optional settings overrides in `config.yml` - see below), running the specified stack.
+- Deploy the provided version of the application into `env`
+- Report progress. When complete report the URL where the app can be hit (note: this will be the URL of the ELB).
+
+# Settings overrides
+
+An example `config.yml`:
+
+```yaml
+-
+    namespace: 'aws:autoscaling:asg'
+    option_name: Availability Zones
+    value: Any 2
+-
+    namespace: 'aws:autoscaling:launchconfiguration'
+    option_name: InstanceType
+    value: m1.small
+-
+    namespace: 'aws:autoscaling:launchconfiguration'
+    option_name: EC2KeyName
+    value: MyAwesomeEC2-dev
+```
+
+# Running the somewhat useless tests
+    
+    bundle exec rspec test
+
+# TODO
+
+- Tests around error handling
+- Provide some blue-green deployment integrated with health checks, using the `swap_environment_cnames` feature of the AWS SDK.
+

data/Rakefile

@@ -0,0 +1 @@
+require 'bundler/gem_tasks'

data/beanstalkify.gemspec

@@ -0,0 +1,21 @@
+# -*- encoding: utf-8 -*- 
+$:.push File.expand_path("../lib", __FILE__)
+require 'beanstalkify/version'
+
+Gem::Specification.new do |s|
+  s.name          = 'beanstalkify'
+  s.version       = Beanstalkify::VERSION
+  s.summary       = "Beanstalk automation for dummies"
+  s.description   = "Create Amazon Elastic Beanstalk apps and deploy versions from the command line"
+  s.authors       = ["Pranav Raja"]
+  s.email         = 'rickdangerous1@gmail.com'
+  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.homepage      = 'https://github.com/pranavraja/beanstalkify'
+  s.license       = 'MIT'
+
+  s.add_dependency 'aws-sdk'
+  s.add_development_dependency "rspec"
+end

data/bin/beanstalkify

@@ -0,0 +1,35 @@
+#!/usr/bin/env ruby
+require 'optparse'
+require 'yaml'
+require 'beanstalkify/beanstalk'
+require 'beanstalkify/application'
+
+options = {}
+OptionParser.new do |opts|
+    opts.on("-k", "--keyfile [file]", "Load credentials from yaml file") do |v|
+        options[:credentials] = YAML.load_file(v)
+    end
+    opts.on("-a", "--archive [file]", "Archive to deploy (e.g. AppName-version.zip)") do |v|
+        options[:archive] = v
+    end
+    opts.on("-e", "--environment [env]", "Environment to provision (e.g. AppName-test)") do |v|
+        options[:environment] = v
+    end
+    opts.on("-s", "--stack [stack]", "Stack to provision (e.g. '64bit Amazon Linux running Node.js')") do |v|
+        options[:stack] = v
+    end
+    opts.on("-c", "--config [file]", "Configuration overrides for the environment") do |v|
+        options[:config] = YAML.load_file(v)
+    end
+end.parse!
+
+required_params = [:credentials, :archive, :environment, :stack]
+unless (required_params - options.keys).empty?
+    puts "Example usage: beanstalkify -k credentials.yml -a AppName-version.zip -e AppName-test -s '64bit Amazon Linux running Node.js' -c config.yml"
+    exit
+end
+
+Beanstalkify::Beanstalk.configure! options[:credentials]
+app = Beanstalkify::Application.new(options[:stack], options[:config] || [])
+app.deploy!(options[:archive], options[:environment])
+

data/lib/beanstalkify/application.rb

@@ -0,0 +1,38 @@
+require 'beanstalkify/environment'
+require 'beanstalkify/deploy'
+
+module Beanstalkify
+    class Application
+        attr_accessor :stack, :config
+
+        # config is an array of hashes:
+        #   :namespace, :option_name, :value
+        def initialize(stack, config)
+            @stack = stack
+            @config = config.map { |c| Hash[c.map { |k, v| [k.to_sym,v]}] }
+        end
+
+        # Deploy an archive to an environment. 
+        # If the environment doesn't exist, it will be created.
+        def deploy!(archive, environment_name)
+            deployment = Deploy.new(archive)
+            env = Environment.new(environment_name)
+            if deployment.deployed?
+                puts "#{deployment.application.version} is already uploaded."
+            else
+                deployment.upload!
+                deployment.wait!
+            end
+            if env.status.empty?
+                puts "Creating stack '#{@stack}' for #{deployment.application.name}-#{deployment.application.version}..."
+                env.create!(deployment.application, @stack, @config)
+                env.wait!("Launching")
+            else
+                puts "Deploying #{deployment.application.version} to #{environment_name}..."
+                env.deploy!(deployment.application, @config)
+                env.wait!("Updating")
+            end
+            puts "Done. Visit http://#{env.url} in your browser."
+        end
+    end
+end

data/lib/beanstalkify/archive.rb

@@ -0,0 +1,22 @@
+
+module Beanstalkify
+    class Archive
+        attr_accessor :path
+
+        def initialize(path)
+            @path = path
+        end
+
+        def name
+            filename.split('-')[0]
+        end
+
+        def version
+            File.basename(@path, '.*').split('-')[-1]
+        end
+
+        def filename
+            File.basename(@path)
+        end
+    end
+end

data/lib/beanstalkify/beanstalk.rb

@@ -0,0 +1,15 @@
+require 'aws-sdk'
+
+module Beanstalkify
+    class Beanstalk
+        @@config = {}
+        def self.configure!(config={})
+            # Convert string keys to symbols
+            @@config = Hash[config.map{|(k,v)| [k.to_sym,v]}]
+        end
+        def self.api
+            AWS.config(@@config)
+            AWS::ElasticBeanstalk.new.client
+        end
+    end
+end

data/lib/beanstalkify/deploy.rb

@@ -0,0 +1,49 @@
+require 'beanstalkify/archive'
+require 'beanstalkify/beanstalk'
+require 'aws-sdk'
+
+module Beanstalkify
+    class Deploy
+        attr_accessor :beanstalk, :application
+
+        def initialize(path)
+            @application = Archive.new(path)
+            @beanstalk = Beanstalk.api
+        end
+
+        def bucket
+            @beanstalk.create_storage_location.data[:s3_bucket]
+        end
+
+        def upload!
+            client = AWS::S3.new.client
+            bucket = self.bucket
+            puts "Uploading #{@application.filename} to bucket #{bucket}..."
+            client.put_object({ :bucket_name => bucket, :key => @application.filename, :data => File.open(@application.path) })
+            puts "Creating #{@application.name} - #{@application.version} in beanstalk"
+            @beanstalk.create_application_version({ 
+                :application_name => @application.name, 
+                :version_label => @application.version,
+                :source_bundle => {
+                    :s3_bucket => bucket,
+                    :s3_key => @application.filename
+                },
+                :auto_create_application => true
+            })
+        end
+
+        def deployed?
+            @beanstalk.describe_application_versions({
+                :application_name => @application.name,
+                :version_labels => [@application.version]
+            }).data[:application_versions].count > 0
+        end
+
+        def wait!
+            while not self.deployed?
+                puts "Waiting for #{@application.version} to be available..."
+                sleep 10
+            end
+        end
+    end
+end

data/lib/beanstalkify/environment.rb

@@ -0,0 +1,60 @@
+require 'beanstalkify/beanstalk'
+
+module Beanstalkify
+    class Environment
+        attr_accessor :name
+
+        def initialize(name)
+            @name = name
+            @beanstalk = Beanstalk.api
+        end
+
+        # Assuming the provided app has already been uploaded,
+        # update this environment to the app's version
+        # Optionally pass in a bunch of settings to override
+        def deploy!(app, settings=[])
+            @beanstalk.update_environment({
+                :version_label => app.version,
+                :environment_name => self.name,
+                :option_settings => settings
+            })
+        end
+
+        # Assuming the app has already been uploaded, 
+        # create a new environment with the app deployed onto the provided stack.
+        def create!(app, stack, settings=[])
+            @beanstalk.create_environment({
+                :application_name => app.name,
+                :version_label => app.version,
+                :environment_name => self.name,
+                :solution_stack_name => stack,
+                :option_settings => settings
+            })
+        end
+
+        def status
+            envs = @beanstalk.describe_environments({
+                :environment_names => [self.name],
+                :include_deleted => false
+            }).data[:environments]
+            e = envs.first
+            e ? e[:status] : ""
+        end
+
+        def url
+            envs = @beanstalk.describe_environments({
+                :environment_names => [self.name]
+            }).data[:environments]
+            e = envs.first
+            e ? e[:endpoint_url] : ""
+        end
+
+        # Wait for the status to change from `old_status` to something else
+        def wait!(old_status)
+            while self.status == old_status
+                puts "#{self.name} is still #{old_status}..."
+                sleep 20
+            end
+        end
+    end
+end

data/lib/beanstalkify/version.rb

@@ -0,0 +1,3 @@
+module Beanstalkify
+  VERSION = "0.0.1"  
+end

data/test/application_spec.rb

@@ -0,0 +1,9 @@
+require './application'
+require './environment'
+
+describe Application do
+    it 'should deploy an application' do
+        #application = Application.new('64bit Amazon Linux running Node.js', [])
+        #application.deploy!('/Users/pmoney/tmp/App-64fc96e.zip', 'test-env')
+    end
+end

data/test/archive_spec.rb

@@ -0,0 +1,26 @@
+
+require './archive'
+
+describe Archive do
+  archive = nil
+  before do
+    archive = Archive.new '/path/to/my/archive/appname-version.zip'
+  end
+
+  it 'should store the path' do
+    archive.path.should eq('/path/to/my/archive/appname-version.zip')
+  end
+
+  it 'extracts the application name from the path' do
+    archive.name.should eq('appname')
+  end
+
+  it 'extracts the version from the path' do
+    archive.version.should eq('version')
+  end
+
+  it 'returns the filename of the archive' do
+    archive.filename.should eq('appname-version.zip')
+  end
+end
+

data/test/deploy_spec.rb

@@ -0,0 +1,24 @@
+require './deploy'
+
+describe Deploy do
+    deploy = nil
+    before do
+        deploy = Deploy.new('/Users/pmoney/temp/foo-1.0.zip')
+    end
+
+    it 'should get the s3 bucket' do
+        #puts deploy.bucket
+    end
+
+    it 'should upload the application' do
+        #puts deploy.upload!
+    end
+
+    it 'should create a new environment with the application' do
+        #puts deploy.create!("test3", "64bit Amazon Linux running Node.js").data
+    end
+
+    it 'should get the status of an environment' do
+        #puts deploy.status("test3")
+    end
+end

data/test/environment_spec.rb

@@ -0,0 +1,9 @@
+require './environment'
+
+describe Environment do
+  environment = Environment.new("test")
+
+  it 'should get the status' do
+    #environment.status.should eq("Ready")
+  end
+end

metadata

@@ -0,0 +1,101 @@
+--- !ruby/object:Gem::Specification
+name: beanstalkify
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+  prerelease: 
+platform: ruby
+authors:
+- Pranav Raja
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-08-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: aws-sdk
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Create Amazon Elastic Beanstalk apps and deploy versions from the command
+  line
+email: rickdangerous1@gmail.com
+executables:
+- beanstalkify
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- Gemfile.lock
+- LICENSE
+- README.md
+- Rakefile
+- beanstalkify.gemspec
+- bin/beanstalkify
+- lib/beanstalkify/application.rb
+- lib/beanstalkify/archive.rb
+- lib/beanstalkify/beanstalk.rb
+- lib/beanstalkify/deploy.rb
+- lib/beanstalkify/environment.rb
+- lib/beanstalkify/version.rb
+- test/application_spec.rb
+- test/archive_spec.rb
+- test/deploy_spec.rb
+- test/environment_spec.rb
+homepage: https://github.com/pranavraja/beanstalkify
+licenses:
+- MIT
+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: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Beanstalk automation for dummies
+test_files:
+- test/application_spec.rb
+- test/archive_spec.rb
+- test/deploy_spec.rb
+- test/environment_spec.rb