elocal_capistrano 1.0.3 → 1.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: be2003f03560d849d9d4f84e3698e5c227b5e4a6
-  data.tar.gz: b29182c1a9f101a59a4f1a15d097ef3a4e0d5c28
+  metadata.gz: 0e44da0b53e39e4b71de89c31353baef876cfaaa
+  data.tar.gz: c3c47bdc6646f5cbf68da93cfc55e716552ab33b
 SHA512:
-  metadata.gz: 9ac04cc0219359128a371e430d02aba236ee889a790c0215681527cb8022e7fbc67ca521e4c1bfcda806d8de4ec0f41118c91000bf4e1d9848806faafc634cca
-  data.tar.gz: dd1d6be78d7f8ff3ac9c47584bf0e0790ab8f4eff5229779daf8f9dde14803b5cb584f70cd228000a6919fe6d9c30e3740e600a9a4a56e06ce0c08ec67cf9ff8
+  metadata.gz: 60dd8df02036200500b7fff78fe5b61d7c6d44bbed1dfa0063f0101768f34357d56c8166ee5e19ac2e1cbc81bb7dc2a148e5ff7ba8ff290d7f63e1f1c8e2072b
+  data.tar.gz: fe3c939f67f33e61c4c8f325030a35241627d59adecb7b02156f1efddc8c7cb6d29616175b624e776376fb7a0dec7f5072a38243ccbee289bd7b9c94f44c2f5f

data/README.md

@@ -1,6 +1,97 @@
-# ElocalCapistrano
+# Elocal Capistrano
 
-A bunch of handly capistrano tasks.
+A bunch of handy [Capistrano 2.0](https://github.com/capistrano/capistrano/wiki) tasks.
+
+## Usage
+
+### Chef
+
+    cap chef
+
+Runs chef-client on all servers.
+
+### Delayed Job
+
+    cap delayed_job:upstart:start
+    cap delayed_job:upstart:restart
+    cap delayed_job:upstart:stop
+
+Start/stop/restart a delayed job process using upstart.  You can change the name of the task with the **delayed\_job\_application_name** variable.
+
+    set(:delayed_job_application_name, 'foobar')
+
+By default the **#{application}\_delayed\_job** is used.
+
+
+Generally, this will be hooked in like:
+
+    %w(start stop restart).each do |st|
+      after "deploy:#{st}", "delayed_job:upstart:#{st}"
+    end
+
+### Deployment Utilities
+
+    cap deploy:symlink_shared_configuration
+
+This will find files in the directory #{deploy_to}/shared/config and link them in to the release path using the basic logic.
+
+    ln -nfs #{deploy_to}/shared/config/$f #{release_path}/config/$f
+
+Generally, this will be hooked in with an after callback.
+
+    after "bundle:install", "deploy:symlink_shared_configuration"
+
+### God
+
+    cap god:start
+    cap god:restart
+    cap god:stop
+
+Start/stop/restart a god process using.  You can change the name of the task with the **god\_application_name** variable.
+
+    set(:god_application_name, 'foobar')
+
+By default, the application name is used.
+
+Generally, this will be hooked in like:
+
+    %w(start stop restart).each do |st|
+      after "deploy:#{st}", "god:#{st}"
+    end
+
+### Maintenance
+
+    cap maintenance:begin
+    cap maintenance:end
+
+Creates a HTML page at **public/system/503.html**.  We rely on Nginx to check for that file and display it for all requests if present.
+
+### Puma
+
+    cap puma:upstart:start
+    cap puma:upstart:restart
+    cap puma:upstart:stop
+
+Start/stop/restart a puma process using upstart.  You can change the name of the task with the **puma\_application_name** variable.
+
+    set(:puma_application_name, 'foobar')
+
+By default the **#{application}\_puma** is used.
+
+Generally, this will be hooked in like:
+
+    %w(start stop restart).each do |st|
+      after "deploy:#{st}", "puma:upstart:#{st}"
+    end
+
+### Syslog
+
+    cap syslog:grep -s pattern=abc -s all_logs=true
+
+Utility to grep syslog for a specific pattern.
+
+* **pattern** - The pattern to match on.  Regular expressions are used.  This is required.
+* **all_logs** - If true, all syslogs will be search.  If false or unset, only the current log is searched.
 
 ## Installation
 
@@ -10,15 +101,12 @@ Add this line to your application's Gemfile:
 
 And then execute:
 
-    $ bundle
+    $ bundle install
 
-Or install it yourself as:
+In your Capfile add
 
-    $ gem install elocal_capistrano
-
-## Usage
+    require 'elocal_capistrano'
 
-TODO: Write usage instructions here
 
 ## Contributing
 

data/lib/elocal_capistrano/puma.rb

@@ -11,14 +11,11 @@ Capistrano::Configuration.instance.load do
 
       desc 'Perform a restart of the application puma service'
       task :restart, roles: :app, except: { no_release: true } do
-        run <<-CMD
-          pid=`status #{puma_application_name} | grep -o -E '[0-9]+'`;
-          if [ -z $pid ]; then
-            sudo start #{puma_application_name};
-          else
-            sudo reload #{puma_application_name};
-          fi
-        CMD
+        Array(puma_application_name).each do |app_name|
+          run <<-CMD.strip
+            pid=`status #{app_name} | grep -o -E '[0-9]+'`; if [ -z $pid ]; then sudo start #{app_name}; else sudo reload #{app_name}; fi
+          CMD
+        end
       end
     end
   end

data/lib/elocal_capistrano/version.rb

@@ -1,3 +1,3 @@
 module ElocalCapistrano
-  VERSION = "1.0.3"
+  VERSION = "1.0.4"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: elocal_capistrano
 version: !ruby/object:Gem::Version
-  version: 1.0.3
+  version: 1.0.4
 platform: ruby
 authors:
 - Rob Di Marco
@@ -14,28 +14,28 @@ dependencies:
   name: bundler
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.6'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ~>
       - !ruby/object:Gem::Version
         version: '1.6'
 - !ruby/object:Gem::Dependency
   name: rake
   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'
 description: Common eLocal Capistrano tasks.  Supports Capistrano 2.0
@@ -45,7 +45,7 @@ executables: []
 extensions: []
 extra_rdoc_files: []
 files:
-- ".gitignore"
+- .gitignore
 - Gemfile
 - LICENSE.txt
 - README.md
@@ -70,12 +70,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: []