capistrano-puma-a 2.0.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 1a88362a8db972f708d5fb507140a5a6c4a0c214
+  data.tar.gz: 07574feef309763f8376affb71e4dd35ae437e29
+SHA512:
+  metadata.gz: 05306a6bfa0e12e4e8a5c1352a404e7c707c37971dd30aef61131949691977eb5cae33041aee5f32763e4e9df3198addb7d044887d52a35bb711a422fb267776
+  data.tar.gz: 9b3094c815ed1d850fda379c2a209398ad2e164a2f56e4fba5d3ac0b0e1cacf3af0b711ca9287c0e733daf5d5da7ff835f4316f5ae4c22fe0fc71afd1962629d

data/.gitignore

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

data/CHANGELOG.md

@@ -0,0 +1,40 @@
+## Changelog
+- 2.0.0: 
+ - Require puma 3.4+
+ - Require Capistrano 3.5+
+ - Require capistrano-bundler
+ 
+- 1.2.0: add support for puma user for puma user @mcb & @seuros
+- 1.1.0: Set :puma_preload_app to false; Reload Monit after uploading any monit configuration; Always refresh Gemfile @rafaelgoulart @suhailpatel @sime
+- 1.0.0: Add activate control app @askagirl
+- 0.8.5: Fix smart_restart task to check if puma preloads app
+- 0.8.4: Allow patch method (Nginx template) @lonre
+- 0.8.2: Start task creates a conf file if none exists @stevemadere
+- 0.8.1: Fixed nginx task @hnatt, support for prune_bundler @behe
+- 0.8.0: Some changes
+- 0.7.0: added Nginx template generator  @dfang
+- 0.6.1: added :puma_default_hooks, you can turn off the automatic hooks by setting it false
+- 0.6.0: Remove `daemonize true` from default puma.rb file. Explicitly pass `--daemon` flag when needed.
+- 0.5.1: Added worker_timeout option
+- 0.5.0: Bugs fixes
+- 0.4.2: Fix monit template to support chruby
+- 0.4.1: Fix puma jungle (debian)
+- 0.4.0: Multi-bind support
+- 0.3.7: Dependency bug fix
+- 0.3.5: Fixed a prehistoric bug
+- 0.3.4: I don't remember what i did here
+- 0.3.3: Puma jungle start fix
+- 0.3.2: Tag option support (require puma  2.8.2+)
+- 0.3.1: Typo fix
+- 0.3.0: Initial support for puma signals
+- 0.2.2: Application pre-loading is optional now (set puma_preload_app to false to turn it off)
+- 0.2.1: Tasks are run within rack context
+- 0.2.0: Support for puma `ActiveRecord::Base.establish_connection` on
+  boot
+- 0.1.3: Capistrano 3.1 support
+- 0.1.2: Gemfile are refreshed between deploys now
+- 0.1.1: Initial support for Monit and configuration override added.
+- 0.1.0: Phased restart will be used if puma is in cluster mode
+- 0.0.9: puma.rb location changed to shared_path root. puma:check moved to after deploy:check
+- 0.0.8: puma.rb is automatically generated if not present. Fixed RVM issue.
+- 0.0.7: Gem pushed to rubygems as capistrano3-puma. Support of Redhat based OS for Jungle init script.

data/CONTRIBUTORS.md

@@ -0,0 +1,45 @@
+## Contributors
+
+Abdelkader Boudih
+André Arko
+Ariel Zerahia
+ayaya
+Bin Huang
+Bryan Liles
+Claudio Poli
+Cyril Rohr
+dfang
+Fritz Lee
+Hnat Kubov
+Ivan Schneider
+James-Hendrickson
+Jens Hausherr
+Jeremy Rottman
+Jesse Cooke
+Johan Lind
+Jordan Hollinger
+Jun Lin
+Kamil Giszczak
+Kevin Collignon
+Konstantin Papkovskiy
+Kyle Decot
+Lisa Hagemann
+Lonre Wang
+marshall-lee
+Matias De Santi
+Michael C. Beck
+Molfar
+msbrigna
+Neil Bartley
+Peter
+Ponomarev Nikolay
+Rafael Goulart
+RavWar
+ruohan.chen
+Ruslan
+Sergey Ponomarev
+Shane O'Grady
+Simon Males
+Steve Madere
+Suhail Patel
+Suraj Shirvankar

data/Gemfile

@@ -0,0 +1,4 @@
+source 'https://rubygems.org'
+
+# Specify your gem's dependencies in capistrano-puma.gemspec
+gemspec

data/LICENSE.txt

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2013-2016 Abdelkader Boudih
+
+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,128 @@
+# Capistrano::Puma
+
+A clone of [https://github.com/seuros/capistrano-puma]. If you don't know what
+this does, please use that version instead.
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'capistrano3-puma', github: "seuros/capistrano-puma"
+
+or:
+
+    gem 'capistrano3-puma' , group: :development
+
+And then execute:
+
+    $ bundle
+
+## Usage
+```ruby
+    # Capfile
+
+    require 'capistrano/puma'
+    require 'capistrano/puma/workers' # if you want to control the workers (in cluster mode)
+    require 'capistrano/puma/jungle'  # if you need the jungle tasks
+    require 'capistrano/puma/monit'   # if you need the monit tasks
+    require 'capistrano/puma/nginx'   # if you want to upload a nginx site template
+```
+
+### Config
+
+To list available tasks use `cap -T`
+
+To upload puma config use:
+```ruby
+cap puma:config
+```
+By default the file located in  `shared/puma.config`
+
+
+Ensure that `tmp/pids` and ` tmp/sockets log` are shared (via `linked_dirs`):
+
+`This step is mandatory before deploying, otherwise puma server won't start`
+
+### Nginx
+
+To upload a nginx site config (eg. /etc/nginx/sites-enabled/) use:
+```ruby
+cap puma:nginx_config
+```
+
+To customize these two templates locally before uploading use:
+```
+rails g capistrano:nginx_puma:config
+```
+
+if your nginx server configuration is not located in `/etc/nginx`, you may need to customize:
+```ruby
+set :nginx_sites_available_path, "/etc/nginx/sites-available"
+set :nginx_sites_enabled_path, "/etc/nginx/sites-enabled"
+```
+
+By default, `nginx_config` will be executed with `:web` role. But you can assign it to a different role:
+```ruby
+set :puma_nginx, :foo
+```
+or define a standalone one:
+```ruby
+role :puma_nginx, %w{root@example.com}
+```
+
+### Jungle
+
+For Jungle tasks (beta), these options exist:
+```ruby
+    set :puma_jungle_conf, '/etc/puma.conf'
+    set :puma_run_path, '/usr/local/bin/run-puma'
+```
+
+### Multi bind
+
+Multi-bind can be set with an array in the puma_bind variable
+```ruby
+  set :puma_bind, %w(tcp://0.0.0.0:9292 unix:///tmp/puma.sock)
+```
+    * Listening on tcp://0.0.0.0:9220
+    * Listening on unix:///tmp/puma.sock
+
+### Active Record
+
+For ActiveRecord the following line to your deploy.rb
+```ruby
+    set :puma_init_active_record, true
+```
+
+### Other configs
+
+Configurable options, shown here with defaults: Please note the configuration options below are not required unless you are trying to override a default setting, for instance if you are deploying on a host on which you do not have sudo or root privileges and you need to restrict the path. These settings go in the deploy.rb file.
+
+```ruby
+    set :puma_user, fetch(:user)
+    set :puma_rackup, -> { File.join(current_path, 'config.ru') }
+    set :puma_state, "#{shared_path}/tmp/pids/puma.state"
+    set :puma_pid, "#{shared_path}/tmp/pids/puma.pid"
+    set :puma_bind, "unix://#{shared_path}/tmp/sockets/puma.sock"    #accept array for multi-bind
+    set :puma_default_control_app, "unix://#{shared_path}/tmp/sockets/pumactl.sock"
+    set :puma_conf, "#{shared_path}/puma.rb"
+    set :puma_access_log, "#{shared_path}/log/puma_access.log"
+    set :puma_error_log, "#{shared_path}/log/puma_error.log"
+    set :puma_role, :app
+    set :puma_env, fetch(:rack_env, fetch(:rails_env, 'production'))
+    set :puma_threads, [0, 16]
+    set :puma_workers, 0
+    set :puma_worker_timeout, nil
+    set :puma_init_active_record, false
+    set :puma_preload_app, false
+    set :puma_plugins, []  #accept array of plugins
+    set :nginx_use_ssl, false
+```
+
+## Contributing
+
+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

data/Rakefile

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

data/capistrano-puma-a.gemspec

@@ -0,0 +1,24 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'capistrano/puma/version'
+
+Gem::Specification.new do |spec|
+  spec.name = 'capistrano-puma-a'
+  spec.version = Capistrano::Puma::VERSION
+  spec.authors = ['Abdelkader Boudih']
+  spec.email = ['Terminale@gmail.com']
+  spec.description = %q{A clone of seuros/capistrano-puma used here for version bump}
+  spec.summary = %q{Puma integration for Capistrano}
+  spec.homepage = 'https://github.com/seuros/capistrano-puma'
+  spec.license = 'MIT'
+
+  spec.required_ruby_version     = '>= 1.9.3'
+
+  spec.files = `git ls-files`.split($/)
+  spec.require_paths = ['lib']
+
+  spec.add_dependency 'capistrano', '~> 3.5'
+  spec.add_dependency 'capistrano-bundler', '~> 1.1'
+  spec.add_dependency 'puma' , '~> 3.4'
+end

data/lib/capistrano/puma.rb

@@ -0,0 +1,2 @@
+require 'capistrano/bundler'
+load File.expand_path('../tasks/puma.rake', __FILE__)

data/lib/capistrano/puma/jungle.rb

@@ -0,0 +1,2 @@
+# Load jungle tasks
+load File.expand_path('../../tasks/jungle.rake', __FILE__)

data/lib/capistrano/puma/monit.rb

@@ -0,0 +1,2 @@
+# Load monit tasks
+load File.expand_path('../../tasks/monit.rake', __FILE__)

data/lib/capistrano/puma/nginx.rb

@@ -0,0 +1 @@
+load File.expand_path('../../tasks/nginx.rake', __FILE__)

data/lib/capistrano/puma/version.rb

@@ -0,0 +1,5 @@
+module Capistrano
+  module Puma
+    VERSION = '2.0.0'
+  end
+end

data/lib/capistrano/puma/workers.rb

@@ -0,0 +1,2 @@
+# Load monit tasks
+load File.expand_path('../../tasks/workers.rake', __FILE__)

data/lib/capistrano/tasks/jungle.rake

@@ -0,0 +1,81 @@
+namespace :load do
+  task :defaults do
+    set :puma_jungle_conf, '/etc/puma.conf'
+    set :puma_run_path, '/usr/local/bin/run-puma'
+  end
+end
+
+
+namespace :puma do
+  namespace :jungle do
+
+    desc 'Install Puma jungle'
+    task :install do
+      on roles(fetch(:puma_role)) do |role|
+        @role = role
+        template_puma 'run-puma', "#{fetch(:tmp_dir)}/run-puma", role
+        execute "chmod +x #{fetch(:tmp_dir)}/run-puma"
+        sudo "mv #{fetch(:tmp_dir)}/run-puma #{fetch(:puma_run_path)}"
+        if test '[ -f /etc/redhat-release ]'
+          #RHEL flavor OS
+          rhel_install
+        elsif test '[ -f /etc/lsb-release ]'
+          #Debian flavor OS
+          debian_install
+        else
+          #Some other OS
+          error 'This task is not supported for your OS'
+        end
+        sudo "touch #{fetch(:puma_jungle_conf)}"
+      end
+    end
+
+
+    def debian_install
+      template_puma 'puma-deb', "#{fetch(:tmp_dir)}/puma", @role
+      execute "chmod +x #{fetch(:tmp_dir)}/puma"
+      sudo "mv #{fetch(:tmp_dir)}/puma /etc/init.d/puma"
+      sudo 'update-rc.d -f puma defaults'
+
+    end
+
+    def rhel_install
+      template_puma 'puma-rpm', "#{fetch(:tmp_dir)}/puma" , @role
+      execute "chmod +x #{fetch(:tmp_dir)}/puma"
+      sudo "mv #{fetch(:tmp_dir)}/puma /etc/init.d/puma"
+      sudo 'chkconfig --add puma'
+    end
+
+
+    desc 'Setup Puma config and install jungle script'
+    task :setup do
+      invoke 'puma:config'
+      invoke 'puma:jungle:install'
+      invoke 'puma:jungle:add'
+    end
+
+    desc 'Add current project to the jungle'
+    task :add do
+      on roles(fetch(:puma_role)) do|role|
+        sudo "/etc/init.d/puma add '#{current_path}' #{fetch(:puma_user, role.user)}"
+      end
+    end
+
+    desc 'Remove current project from the jungle'
+    task :remove do
+      on roles(fetch(:puma_role)) do
+        sudo "/etc/init.d/puma remove '#{current_path}'"
+      end
+    end
+
+    %w[start stop restart status].each do |command|
+      desc "#{command} puma"
+      task command do
+        on roles(fetch(:puma_role)) do
+          sudo "service puma #{command} #{current_path}"
+        end
+      end
+    end
+
+  end
+end

data/lib/capistrano/tasks/monit.rake

@@ -0,0 +1,72 @@
+namespace :load do
+  task :defaults do
+    set :puma_monit_conf_dir, -> { "/etc/monit/conf.d/#{puma_monit_service_name}.conf" }
+    set :puma_monit_use_sudo, true
+    set :puma_monit_bin, '/usr/bin/monit'
+  end
+end
+
+namespace :puma do
+  namespace :monit do
+    desc 'Config Puma monit-service'
+    task :config do
+      on roles(fetch(:puma_role)) do |role|
+        @role = role
+        template_puma 'puma_monit.conf', "#{fetch(:tmp_dir)}/monit.conf", @role
+        sudo_if_needed "mv #{fetch(:tmp_dir)}/monit.conf #{fetch(:puma_monit_conf_dir)}"
+        sudo_if_needed "#{fetch(:puma_monit_bin)} reload"
+      end
+    end
+
+    desc 'Monitor Puma monit-service'
+    task :monitor do
+      on roles(fetch(:puma_role)) do
+        sudo_if_needed "#{fetch(:puma_monit_bin)} monitor #{puma_monit_service_name}"
+      end
+    end
+
+    desc 'Unmonitor Puma monit-service'
+    task :unmonitor do
+      on roles(fetch(:puma_role)) do
+        sudo_if_needed "#{fetch(:puma_monit_bin)} unmonitor #{puma_monit_service_name}"
+      end
+    end
+
+    desc 'Start Puma monit-service'
+    task :start do
+      on roles(fetch(:puma_role)) do
+        sudo_if_needed "#{fetch(:puma_monit_bin)} start #{puma_monit_service_name}"
+      end
+    end
+
+    desc 'Stop Puma monit-service'
+    task :stop do
+      on roles(fetch(:puma_role)) do
+        sudo_if_needed "#{fetch(:puma_monit_bin)}  stop #{puma_monit_service_name}"
+      end
+    end
+
+    desc 'Restart Puma monit-service'
+    task :restart do
+      on roles(fetch(:puma_role)) do
+        sudo_if_needed "#{fetch(:puma_monit_bin)} restart #{puma_monit_service_name}"
+      end
+    end
+
+    before 'deploy:updating', 'puma:monit:unmonitor'
+    after 'deploy:published', 'puma:monit:monitor'
+
+    def puma_monit_service_name
+      fetch(:puma_monit_service_name, "puma_#{fetch(:application)}_#{fetch(:stage)}")
+    end
+
+    def sudo_if_needed(command)
+      if fetch(:puma_monit_use_sudo)
+        sudo command
+      else
+        execute command
+      end
+    end
+
+  end
+end