enhanced-elastic-beanstalk 1.2.3

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 59b192f9dab3e85cadd651560fcb7f83567fd97e
+  data.tar.gz: 6911fa46009233c5533183550b9b3a6360c50164
+SHA512:
+  metadata.gz: 46b012522dba696920aa6cfe48ae2ec4335b9870cc07929998cc639579e9e2b943e284c267ed9b6396f66b7c2b42261ba0906313f3dd68e92e109e6c3b886533
+  data.tar.gz: 76d99a8724d995b5e453ba6b0725ae09704e2e983b3b426703f17321689e53643d45e0a738cb4a7cd690e1bc06026d2d3d217e8a90a0217dca312b2020ffcc00

data/.gitignore

@@ -0,0 +1,23 @@
+Gemfile.lock
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+
+.idea
+bin/eb.yml
+
+test-reports

data/.rspec

@@ -0,0 +1,4 @@
+--color
+--require spec_helper
+--format RspecJunitFormatter
+--out test-reports/rspec.xml

data/.ruby-gemset

@@ -0,0 +1 @@
+elastic_beanstalk

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.2.2

data/Gemfile

@@ -0,0 +1,3 @@
+source 'https://rubygems.org'
+
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+Copyright (c) 2014-2015 AlienFast, LLC
+
+MIT License
+
+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,294 @@
+# EnhancedElasticBeanstalk
+Configure and deploy a rails app to Elastic Beanstalk via rake in 60 seconds.  Maintain multiple environment DRY configurations and .ebextensions in one easy to use yaml configuration file.
+
+This gem simplifies configuration, and passes the heavy lifting to the [eb_deployer](https://github.com/ThoughtWorksStudios/eb_deployer) from ThoughtWorksStudios.
+
+*IMPORTANT!*
+This fork of `elastic-beanstalk` has some enhancements that we felt weren't
+worthy of a pull request to the original project, thus the forked version.
+Unless you specifically need HipChat support and custom eb env names, it is
+recommended you go use the latest version of the original gem. https://github.com/alienfast/elastic-beanstalk
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'enhanced-elastic-beanstalk'
+
+And then execute:
+
+    $ bundle
+
+Or install it yourself as:
+
+    $ gem install enhanced-elastic-beanstalk
+
+## Features
+
+### The elastic-beanstalk gem provides:
+* Rake tasks to simplify all interactions
+* Multi-environment configuration inheritance for DRY yaml configs
+* Keep all configurations including .ebextensions in one yaml file (they are inheritable and can be overridden too)
+* Full access to the range of configuration options provided by AWS Elastic Beanstalk
+* Provide access to helpers such as the SmokeTester to simplify configurations
+
+### Plus
+Since [eb_deployer](https://github.com/ThoughtWorksStudios/eb_deployer) is doing the heavy lifting, by proxy you get access to great continuous delivery features such as:
+* `blue-green` deployment strategy
+* `inplace-update` deployment strategy
+* Smoke Testing upon deployment before `blue-green` CNAME switching
+
+## Usage
+
+Given an application named 'acme':
+
+### Step 1: Add ~/.aws/acme.yml
+This should contain the access and secret keys generated from the selected IAM user.  This is the only file that will need to reside outside the repository.  Note that this location is configurable in the `config/eb.yml` file.
+
+    access_key_id: XXXXXX
+    secret_access_key: XXXXXX
+
+### Step 2.  Add a config/eb.yml to your rails project
+Something like this should get you started
+
+```ruby
+app: acme
+region: us-east-1
+solution_stack_name: 64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.2 (Passenger Standalone)
+strategy: inplace-update
+keep_latest: 10
+development:
+  options:
+    aws:autoscaling:launchconfiguration:
+      InstanceType: t1.micro
+
+production:
+  strategy: blue-green
+  options:
+    aws:autoscaling:launchconfiguration:
+      InstanceType: t1.small
+```
+
+### Step 3. Package and deploy
+The default is the 'development' environment, change this via command line arguments
+
+    $ rake eb:package eb:deploy
+
+### Step 4. Get some coffee
+This will take a while.   TODO: investigate methods to speed up deployment i.e. cache bundle.  Feel free to post yours in the wiki.
+
+## Rake Tasks
+
+### EB
+
+    rake eb:clobber                             # Remove any generated package
+    rake eb:config[environment,version]         # Setup AWS.config and merge/override environments into one resolved configuration
+    rake eb:deploy[environment,version]         # Deploy to Elastic Beanstalk
+    rake eb:destroy[force]                      # ** Warning: Destroy Elastic Beanstalk application and *all* environments
+    rake eb:package[environment,version]        # Package zip source bundle for Elastic Beanstalk
+    rake eb:show_config[environment,version]    # Show resolved configuration without doing anything
+
+### EB:RDS Rake Tasks
+
+The EB:RDS tasks are intended to make use of RDS tasks simple given existing configuration in the eb.yml.
+i.e. create a snapshot before or after an `eb:deploy`.  The following rake tasks exist:
+
+    rake eb:rds:create_snapshot[instance_id,snapshot_id]   # Creates an RDS snapshot
+    rake eb:rds:instances                                  # List RDS instances
+    rake eb:rds:snapshots                                  # List RDS snapshots
+
+For example, this would create a snapshot prior to the deployment (and migration) to version 1.1.0:
+
+    rake eb:rds:create_snapshot[acme, pre-1.1.0] eb:deploy[1.1.0]
+
+### Using RAILS_ENV vs :environment:  
+Some people prefer to use `RAILS_ENV`, others prefer to use the `:environment` argument.  Both are accepted. Depending on the use case, each one can be DRYer than the other.
+Where the task specifies `[:environment, :version]`, consider the `:environment` optional if you want to use the default of `development` or utilize the `RAILS_ENV` instead.  
+
+**NOTE:** if using the argument `:environment`, you **must** specify it for **both** the `eb:package` and `eb:deploy`, as `eb:package` is responsible for injecting the `RACK_ENV` and `RAILS_ENV`
+in `aws:elasticbeanstalk:application:environment` section of the `.ebextensions` file.
+
+### :version
+If not specified, version will be auto-generated via and MD5 hash of the package file. If specified to the `eb:package` task, the version will be available as the `APP_VERSION`
+environment variable, specified in the `aws:elasticbeanstalk:application:environment` section of the `.ebextensions` file.  
+
+
+## A real-world example
+
+Deploy version 1.1.3 of acme to production using the `:environment` parameter
+
+    $ rake eb:package[production,1.1.3] eb:deploy[production,1.1.3]
+
+Deploy version 1.1.3 of acme to production using `RAILS_ENV`
+
+    $ RAILS_ENV=production rake eb:package[1.1.3] eb:deploy[1.1.3]
+
+Deploy an MD5 hashed version of acme to production using the `:environment` parameter
+
+    $ rake eb:package[production] eb:deploy[production]
+
+Deploy an MD5 hashed version of acme to production using `RAILS_ENV`
+
+    $ RAILS_ENV=production rake eb:package eb:deploy
+
+Deploy an MD5 hashed version of acme to development
+
+    $ rake eb:package eb:deploy
+
+
+config/eb.yml
+
+```ruby
+# This is a sample that has not been executed so it may not be exactly 100%, but is intended to show
+#   that access to full options_settings and .ebextensions is intended.
+#---
+# http://docs.aws.amazon.com/elasticbeanstalk/latest/dg/command-options.html#command-options-ruby
+#
+# This is a sample that has not been executed so it may not be exactly 100%, but is intended to show
+#   that access to full options_settings and .ebextensions is intended.
+#---
+app: acme
+region: us-east-1
+# Choose a platform from http://docs.aws.amazon.com/elasticbeanstalk/latest/dg/concepts.platforms.html
+solution_stack_name: 64bit Amazon Linux 2015.03 v2.0.0 running Ruby 2.2 (Passenger Standalone)
+strategy: inplace-update # default to inplace-update to avoid starting new environments
+keep_latest: 10
+package:
+  verbose: true
+  includes:  ['public/assets/.sprockets-manifest-*.json'] # ensure '.' manifest is added when using assets:precompile
+  exclude_dirs: [features, spec, target, coverage, vcr, flows]  # additional dirs that merge with default excludes
+  exclude_files: [.ruby-*,  rspec.xml, README*, db/*.sqlite3, bower.json]
+smoke_test: |
+    lambda { |host|
+      EbSmokeTester.test_url("http://#{host}/health", 600, 5, 'All good! Everything is up and checks out.')
+    }
+#--
+ebextensions:
+  # General settings for the server environment
+  01-environment.config:
+    commands:
+      01timezone:
+        command: "ln -sf /usr/share/zoneinfo/America/Chicago /etc/localtime"
+
+  # These are things that make sense for any Ruby application
+  02-ruby.config:
+    # Install git in order to be able to bundle gems from git
+    packages:
+      yum:
+        git: []
+        patch: []
+
+  # Run rake tasks before an application deployment
+  03-rake.config:
+    container_commands:
+      01seed:
+        command: rake db:seed
+        leader_only: true
+
+#---
+options:
+
+  # Any environment variables - will be available in ENV
+  aws:elasticbeanstalk:application:environment:
+    FOO: 'bar'
+    RAILS_SKIP_ASSET_COMPILATION: true # Use if doing asset compilation before packaging (recommended)
+
+  aws:autoscaling:launchconfiguration:
+    EC2KeyName: eb-ssh
+    SecurityGroups: 'acme-production-control'
+
+  aws:autoscaling:asg:
+    MinSize: 1
+    MaxSize: 5
+    # Restrict to Reserved Instance zone: http://stackoverflow.com/a/33131364/2363935
+    'Custom Availability Zones': us-east-1c
+    'Availability Zones': Any 1
+
+
+  aws:elb:loadbalancer:
+    SSLCertificateId: 'arn:aws:iam::XXXXXXX:server-certificate/acme'
+    LoadBalancerHTTPSPort: 443
+
+  aws:elb:policies:
+    Stickiness Policy: true
+
+  aws:elasticbeanstalk:sns:topics:
+    Notification Endpoint: 'alerts@acme.com'
+
+  aws:elasticbeanstalk:application:
+    Application Healthcheck URL: '/health'
+
+#---
+# Set "inactive_settings" for saving cost on blue green deployment
+#  https://github.com/ThoughtWorksStudios/eb_deployer/wiki/Elastic-Beanstalk-Tips-and-Tricks#set-inactive_settings-for-saving-cost-on-blue-green-deployment    
+inactive:
+  aws:autoscaling:asg:
+    MinSize: 0
+    Cooldown: 900    
+
+#---
+development:
+  options:
+    aws:autoscaling:launchconfiguration:
+      InstanceType: t1.micro
+    aws:elasticbeanstalk:application:environment:
+      RAILS_SKIP_ASSET_COMPILATION: true
+#---
+production:
+  strategy: blue-green # always fire up a new environment and healthcheck before transitioning cname
+  options:
+    aws:autoscaling:launchconfiguration:
+      InstanceType: t1.small
+```
+
+## ENV interpolation
+
+ENV variable interpolation is provided by [dry-config](https://github.com/alienfast/dry-config/blob/master/README.md#env-interpolationsubstitutionexpansion).  Any of the values in the `eb.yml` may contain interpolated values.
+
+The following formats are acceptable:
+
+```yaml
+  - ~/foo
+  - $HOME/foo
+  - ${HOME}/foo
+  - #{HOME}/foo
+```
+
+## Additional options
+Most of the configurations are defaulted.  The following are less obvious but may be useful:
+
+```ruby
+secrets_dir: (default: '~/.aws')
+package:
+  verbose: (default: false)
+  dir: (default: 'pkg')
+```
+
+### eb_deployer additional options
+The following are passed if not nil, otherwise eb_deployer assigns an appropriate default.
+
+```ruby
+inactive_settings:  (nil if unspecified)
+package_bucket:
+keep_latest:        (if unspecified, it will keep all past versions in the S3 bucket)
+version_prefix:
+tier:
+```
+
+## Still to come
+1. Speedier deployments - investigate caching of bundle and asset pre-compilation to see if there is a common setting to be found
+
+## Contributing
+
+Please contribute! While this is working great, a greater scope of functionality is certainly easily attainable with this foundation in place.
+
+1. Fork it
+2. Create your feature branch (`git checkout -b my-new-feature`)
+3. Commit your changes (`git commit -am 'Add some feature'`)
+4. Push to the branch (`git push origin my-new-feature`)
+5. Create new Pull Request
+
+
+## Copyright and License
+
+MIT License, see LICENSE.txt for further details.

data/Rakefile

@@ -0,0 +1,8 @@
+require 'bundler/gem_tasks'
+
+# add rspec task
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new('spec')
+task :default => :spec
+task :test => :spec
+

data/bin/elastic-beanstalk

@@ -0,0 +1,25 @@
+#!/usr/bin/env ruby
+require 'rake'
+require 'bundler'
+
+raise "Bundler is required.  Please install bundler with 'gem install bundler'" unless defined?(Bundler)
+
+#
+# Example:
+#
+#   elastic-beanstalk eb:show_config
+#   elastic-beanstalk eb:show_config[1.1.1]
+#
+
+# init dependencies
+Bundler.setup
+
+# init rake
+Rake.application.init
+
+# load the rake tasks
+gem_dir = File.expand_path('..',File.dirname(__FILE__))
+load "#{gem_dir}/lib/elastic/beanstalk/tasks/eb.rake"
+
+# invoke the given task
+Rake.application.invoke_task(ARGV[0])

data/enhanced-elastic-beanstalk.gemspec

@@ -0,0 +1,48 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'elastic/beanstalk/version'
+
+Gem::Specification.new do |s|
+  s.name = 'enhanced-elastic-beanstalk'
+  s.version = Elastic::Beanstalk::VERSION
+  s.authors = ['Matt E. Patterson', 'Kevin Ross']
+  s.email = ['mepatterson@skillsengine.com', 'kevin.ross@alienfast.com']
+  s.description = <<-TEXT
+    The simplest way to configure and deploy an Elastic Beanstalk application via rake.
+
+    This fork of `elastic-beanstalk` has some enhancements that we felt weren't
+    worthy of a pull request to the original project, thus the forked version.
+    Unless you specifically need HipChat support and custom eb env names, it is
+    recommended you go use the latest version of the original gem. https://github.com/alienfast/elastic-beanstalk
+  TEXT
+  s.summary = <<-TEXT
+    Configure and deploy a rails app to Elastic Beanstalk via rake in 60 seconds.
+    Maintain multiple environment DRY configurations and .ebextensions in one easy
+    to use configuration file.
+  TEXT
+  s.homepage = 'https://github.com/mepatterson/enhanced-elastic-beanstalk'
+  s.license = 'MIT'
+
+  s.files = `git ls-files`.split($/).reject { |f| f =~ /^samples\// }
+  s.executables = s.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  s.test_files = s.files.grep(%r{^(test|spec|features)/})
+  s.require_paths = ['lib']
+
+  # development
+  s.add_development_dependency 'bundler'
+  s.add_development_dependency 'rake'
+  s.add_development_dependency 'rspec'
+  s.add_development_dependency 'rspec_junit_formatter'
+
+  # runtime
+  s.add_runtime_dependency 'railties', '>= 3.2'
+  s.add_runtime_dependency 'eb_deployer', '>= 0.6.1'
+  s.add_runtime_dependency 'awesome_print'
+  s.add_runtime_dependency 'time_diff'
+  s.add_runtime_dependency 'rubyzip'
+  s.add_runtime_dependency 'table_print'
+  s.add_runtime_dependency 'nokogiri'
+  s.add_runtime_dependency 'dry-config', '>=1.2.0'
+  s.add_runtime_dependency 'hipchat'
+end