easy-deployment 0.6.1 → 0.6.2

checksums.yaml

@@ -1,15 +1,7 @@
 ---
-!binary "U0hBMQ==":
-  metadata.gz: !binary |-
-    MmFkOWVkMTY3MTk4YmRmMWUxZWE2NzJkZmQwNThjNzg5MDEzMjZkZQ==
-  data.tar.gz: !binary |-
-    NGIzMTY2MzA2MGFkMWUzNmU1ZGU5MWQwNzk2NmUyZTMxOWM0ZmZkYw==
+SHA1:
+  metadata.gz: 9e097e22365db6a37523b417d1df5740798c8da3
+  data.tar.gz: 70a522d246755ae8a1591fe09016e03347ec983a
 SHA512:
-  metadata.gz: !binary |-
-    ODIxYjQ0YWNkNDQ3N2U2ZDE0MmYwYjg4Y2FhOWEyZjFmYjc1NTA1NmU3YTc4
-    NTViNGYzOWRkYmJlZjEyNzMyYjU0NjUzZTkwY2RmYjBjNWZiZDY0MDk4MGE3
-    NzEzMzAxZTU0ZTk4NzZjMGJhYjE5MWQzNmNhNDViMzNkM2IxMzQ=
-  data.tar.gz: !binary |-
-    NDlkYzI5YjRlYmU4YjIyNGVlYzBjODcxYjBmNWM2YTIyMGM2YzJkZDgzYzg3
-    OTc1NGQxMjk4Njc4MzJkOWJiNzhhN2UwMGZjZTZjODBjY2IyZDdjZDI0ZTYw
-    N2Q0MmE0Njg2NjA0Mjg2ZjQ1YTIyY2RmZTNiMjI2N2M3NmI4Njc=
+  metadata.gz: 59b3756e98ff9240f4957030393eb504f467ae9088b7dadb22340c254f62a4ca4a6bf15e435176bd6ae71734723b0a79f521a1dd30c2c0ea29ec27e82b708304
+  data.tar.gz: d7a1ce0608de54eb62188a203b66d8b8a002f3e4c89841a9944769da6ba5f92cc3ff02b7b2a2034011b9a8ea830d362fb82eee0aa1e703e4aaa8cfd943231a78

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog for easy-deployment
 
+## 0.6.2 (2015-11-10)
+
+Enhancements:
+
+* Add support for maintenance mode using the `turnout` gem.
+
+## 0.6.1 (2014-05-23)
+
+Minor changes:
+
+* Update reference data load to use the new rake task from `easy-reference` gem
+
 ## 0.6.0 (2013-11-05)
 
 Features:
@@ -9,7 +21,7 @@ Features:
 
 Bugfixes:
 
-* Using builting `easy-reference` gem support now works with a custom bundler path if set.
+* Using built-in `easy-reference` gem support now works with a custom bundler path if set.
 
 ## 0.5.3 (2013-09-05)
 

data/README.md

@@ -99,12 +99,20 @@ The created backup configuration will be scheduled on deploy to run nightly via
 The default setup is to backup the capistrano system folder, the configured database, to store the backup in S3, and notify of failures via email.
 All these settings are configurable, to read more see the documentation for the backup gem https://github.com/meskyanichi/backup and setup your configuration to suit yourself.
 
-### Whenever
+### Maintenance
 
-If you use the whenever gem to manage application crontabs, automatically include the capistrano
-hooks to run whenever each deploy via:
+This includes a generator to create a maintenance mode configuration (generator is run by itself as `rails generate easy:maintenace`)
+
+This will generate:
+
+    config/initializers/maintenace.rb
+    public/maintenance.html
+    public/maintenance.json
+
+Customise the site configuration within `config/initializers/maintenace.rb` to change the maintenance message, response status etc.
+Customise the maintenance page within `public/maintenance.html`
+All these settings are configurable, to read more see the documentation for the turnout gem https://github.com/biola/turnout and setup your configuration to suit yourself.
 
-    require "easy/deployment/whenever"
 
 ## Contributing
 

data/easy-deployment.gemspec

@@ -2,8 +2,8 @@
 require File.expand_path('../lib/easy-deployment/version', __FILE__)
 
 Gem::Specification.new do |gem|
-  gem.authors       = ["Jeremy Olliver", "Nigel Ramsay", "Shevaun Coker", "Cameron Fowler"]
-  gem.email         = ["jeremy.olliver@abletech.co.nz", "nigel.ramsay@abletech.co.nz", "shevaun.coker@abletech.co.nz", "cameron.fowler@abletech.co.nz"]
+  gem.authors       = ["Jeremy Olliver", "Nigel Ramsay", "Shevaun Coker", "Cameron Fowler", "Joseph Leniston"]
+  gem.email         = ["jeremy.olliver@abletech.co.nz", "nigel.ramsay@abletech.co.nz", "shevaun.coker@abletech.co.nz", "cameron.fowler@abletech.co.nz", "joseph.leniston@abletech.co.nz"]
   gem.description   = %q{Easy deployment: includes a generator, and capistrano configuration}
   gem.summary       = %q{Gem for encapsulating Abletech's deployment practices}
   gem.homepage      = "https://github.com/AbleTech/easy-deployment"
@@ -17,7 +17,7 @@ Gem::Specification.new do |gem|
   gem.license       = "GPLv3"
 
   gem.add_runtime_dependency 'rails', '>= 3.0.0'
-  gem.add_runtime_dependency 'capistrano', '~> 2.13.5'
+  gem.add_runtime_dependency 'capistrano', '>= 2.15'
 
   gem.add_development_dependency 'bundler'
   gem.add_development_dependency 'rspec', '~> 2.0'

data/lib/easy-deployment.rb

@@ -1,5 +1,6 @@
 require "easy-deployment/version"
-require "easy/generators/generator_helpers"
+require 'easy/generators/backup_generator'
 require 'easy/generators/deployment_generator'
+require "easy/generators/generator_helpers"
+require 'easy/generators/maintenance_generator'
 require 'easy/generators/stage_generator'
-require 'easy/generators/backup_generator'

data/lib/easy-deployment/version.rb

@@ -1,5 +1,5 @@
 module Easy
   module Deployment
-    VERSION = "0.6.1"
+    VERSION = "0.6.2"
   end
 end

data/lib/easy/deployment/maintenance.rb

@@ -0,0 +1,19 @@
+# Define a capistrano task for putting the site into maintenance mode using
+# turnout rack middleware.
+# To load this capistrano configuration, require 'easy/deployment/maintenance' from deploy.rb
+#
+Capistrano::Configuration.instance(:must_exist).load do
+
+  namespace :maintenance do
+    desc "Put the application into maintenance mode"
+    task :start, :roles => :app do
+      run "cd #{current_path} && RAILS_ENV=#{rails_env} bundle exec rake maintenance:start"
+    end
+
+    desc "Take the application out of maintenance mode"
+    task :end, :roles => :app do
+      run "cd #{current_path} && RAILS_ENV=#{rails_env} bundle exec rake maintenance:end"
+    end
+  end
+
+end

data/lib/easy/generators/backup_generator.rb

@@ -1,4 +1,5 @@
 require 'rails/generators'
+require "easy/generators/generator_helpers"
 
 module Easy
   class BackupGenerator < Rails::Generators::Base

data/lib/easy/generators/deployment_generator.rb

@@ -1,4 +1,5 @@
 require 'rails/generators'
+require "easy/generators/generator_helpers"
 
 module Easy
   class DeploymentGenerator < Rails::Generators::Base

data/lib/easy/generators/maintenance_generator.rb

@@ -0,0 +1,26 @@
+require 'rails/generators'
+
+module Easy
+  class MaintenanceGenerator < Rails::Generators::Base
+    source_root File.join(File.dirname(__FILE__), "templates") # Where templates are copied from
+
+    desc %{Generates a maintenance config to allow you to put your application into maintenance mode}
+
+    def create_maintenance_files
+      gem 'turnout', '~> 2.2'
+
+      template("maintenance.rb.tt",   "config/initializers/maintenance.rb")
+      template("maintenance.html.tt", "public/maintenance.html")
+      template("maintenance.json.tt", "public/maintenance.json")
+
+      run("bundle install")
+
+      say("Maintenance configuration generated", :green)
+      say("  - TODO: edit config/maintenance.rb setting default_maintenance_page, default_reason and other configuration options", :green)
+      say("  - TODO: edit public/maintenance.html to match site styles", :green)
+
+      true
+    end
+
+  end
+end

data/lib/easy/generators/templates/maintenance.html.tt

@@ -0,0 +1,69 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="UTF-8">
+    <title>Down for Maintenance</title>
+
+    <style type="text/css">
+
+      *{
+        font-family: Arial, Helvetica, sans-serif;
+      }
+
+      body{
+        margin: 0;
+        background-color: #fff;
+      }
+
+      #page{
+        position: relative;
+        width: 550px;
+        margin: 200px auto;
+        padding: 75px 0;
+        text-align: center;
+        background-color: #eaeaea;
+        border: solid 1px #ccc;
+        border-top: solid 10px #666;
+        -moz-box-shadow: inset 0 2px 10px #ccc;
+        -webkit-box-shadow: inset 0 2px 10px #ccc;
+        box-shadow: inset 0 2px 10px #ccc;
+      }
+
+      header, #body{
+        width: 400px;
+        margin: 0 auto;
+      }
+
+      h1{
+        margin: 0;
+        color: #CC3601;
+        font-size: 26pt;
+        border-bottom: solid 4px #666;
+      }
+
+      #reason{
+        margin: 10px 0;
+        color: #333;
+      }
+
+    </style>
+
+  </head>
+  <body>
+
+    <section id="page">
+
+      <header>
+        <h1>Down for Maintenance</h1>
+      </header>
+
+      <section id="body">
+        <div>
+          {{ reason }}
+        </div>
+      </section>
+
+    </section>
+
+  </body>
+</html>

data/lib/easy/generators/templates/maintenance.json.tt

@@ -0,0 +1 @@
+{"error":"Service Unavailable","message":{{ reason }}}

data/lib/easy/generators/templates/maintenance.rb.tt

@@ -0,0 +1,18 @@
+# Use this file to easily configure your app in maintenance mode. e.g. Override
+# the default maintenance.html file with your own.
+#
+# See: https://github.com/biola/turnout#configuration for details on customization
+
+# This is the rails root location, given this file is located at in Rails.root/config/maintenance.rb
+rails_root = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+
+Turnout.configure do |config|
+  config.app_root = rails_root
+  config.named_maintenance_file_paths = {default: config.app_root.join('tmp', 'maintenance.yml').to_s}
+  config.default_maintenance_page = Turnout::MaintenancePage::HTML
+  config.default_reason = "The site is temporarily down for maintenance.\nPlease check back soon."
+  config.default_allowed_paths = ['/admin','/assets']
+  config.default_response_code = 503
+  config.default_retry_after = 3600
+end

metadata

@@ -1,86 +1,88 @@
 --- !ruby/object:Gem::Specification
 name: easy-deployment
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.6.2
 platform: ruby
 authors:
 - Jeremy Olliver
 - Nigel Ramsay
 - Shevaun Coker
 - Cameron Fowler
+- Joseph Leniston
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2014-05-22 00:00:00.000000000 Z
+date: 2015-11-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 3.0.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: 3.0.0
 - !ruby/object:Gem::Dependency
   name: capistrano
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 2.13.5
+        version: '2.15'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 2.13.5
+        version: '2.15'
 - !ruby/object:Gem::Dependency
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ! '>='
+    - - ">="
       - !ruby/object:Gem::Version
         version: '0'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ~>
+    - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
-description: ! 'Easy deployment: includes a generator, and capistrano configuration'
+description: 'Easy deployment: includes a generator, and capistrano configuration'
 email:
 - jeremy.olliver@abletech.co.nz
 - nigel.ramsay@abletech.co.nz
 - shevaun.coker@abletech.co.nz
 - cameron.fowler@abletech.co.nz
+- joseph.leniston@abletech.co.nz
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- .gitignore
-- .rspec
+- ".gitignore"
+- ".rspec"
 - CHANGELOG.md
 - Gemfile
 - LICENSE
@@ -94,6 +96,7 @@ files:
 - lib/easy/deployment/capistrano.rb
 - lib/easy/deployment/dbreference.rb
 - lib/easy/deployment/logrotate.rb
+- lib/easy/deployment/maintenance.rb
 - lib/easy/deployment/nfs.rb
 - lib/easy/deployment/nginx.rb
 - lib/easy/deployment/niet.rb
@@ -102,10 +105,14 @@ files:
 - lib/easy/generators/backup_generator.rb
 - lib/easy/generators/deployment_generator.rb
 - lib/easy/generators/generator_helpers.rb
+- lib/easy/generators/maintenance_generator.rb
 - lib/easy/generators/stage_generator.rb
 - lib/easy/generators/templates/Capfile
 - lib/easy/generators/templates/backup.rb.tt
 - lib/easy/generators/templates/deploy.rb.tt
+- lib/easy/generators/templates/maintenance.html.tt
+- lib/easy/generators/templates/maintenance.json.tt
+- lib/easy/generators/templates/maintenance.rb.tt
 - lib/easy/generators/templates/s3.yml
 - lib/easy/generators/templates/schedule.rb.tt
 - lib/easy/generators/templates/stage.rb.tt
@@ -124,12 +131,12 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>='
+  - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []