server-starter 0.3.0 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 1d53d56660d67da4edc311de419917bccb44f413
-  data.tar.gz: 15df36c0c0bcd646dcaa1f370ebc8fbe1c38d0c8
+  metadata.gz: 9d1306d9f95c35e64ad0e04bd294bee7ce9299ad
+  data.tar.gz: cb63d773356e83d97c79fe1db9473b9bda6e9706
 SHA512:
-  metadata.gz: d3111c0c60634c6f3f7ab2d9ad842f6d541ec76cdb2c1c93398c744afef2deb0ffd5bbeefebc1c46e1a33eb337a32a1081ba0e4444e6e03b58ea0dc9f82bceab
-  data.tar.gz: f70b10675013db13f9972902c35e8441317f681fe8b9b8521bd43e5fe58c13899b40ee6f7a9c666913f82abf5d46bc0db86f055c1fe5a29b0964a78a92ac4698
+  metadata.gz: 0423e31d4a72dad4759d7889e050e7d41a1317e85cf7b553869d28262e3fda52f2bc22ed865ccde2ea334741ccd477aafef05e0c46df65a621353e4287cdd520
+  data.tar.gz: 23f27dba0752d06bcf0b10b08a87f998bf8f667cdb54eaf02e9ff3cb65c61937a7303339a4883822b140b084161f48282b71049e52449f7777fc3093ae6c835e

data/CHANGELOG.md

@@ -1,3 +1,9 @@
+## 0.3.1 (2016/08/26)
+
+Enhancements:
+
+* Support [resque_starter](https://github.com/sonots/resque_starter)
+
 ## 0.3.0 (2016/04/03)
 
 Fixes:

data/README.md

@@ -24,8 +24,13 @@ Following is an example to run unicorn server under ```Server::Starter```.
 The command line example:
 
 ```
-bundle exec start_server.rb --port=10080 --signal-on-hup=CONT --dir=/path/to/app \
-  --status-file=/path/to/app/log/start_server.stat --pid-file=/path/to/app/log/start_server.pid -- \
+bundle exec start_server.rb \
+  --port=10080 \
+  --signal-on-hup=CONT \
+  --dir=/path/to/app \
+  --status-file=/path/to/app/log/start_server.stat \
+  --pid-file=/path/to/app/log/start_server.pid \
+  -- \
   bundle exec --keep-file-descriptors unicorn -c config/unicorn.conf.rb config.ru
 ```
 
@@ -71,6 +76,91 @@ after_fork do |server, worker|
 end
 ```
 
+# Puma
+
+Following is an example to run puma server under ```Server::Starter```.
+
+The command line example:
+
+```
+bundle exec start_server.rb \
+  --port=0.0.0.0:10080 \
+  --dir=/path/to/app \
+  --interval=1 \
+  --signal-on-hup=TERM \
+  --signal-on-TERM=TERM \
+  --pid-file=/path/to/app/log/start_server.pid \
+  --status-file=/path/to/app/log/start_server.stat \
+  --envdir=env \
+  --enable-auto-restart \
+  --auto-restart-interval=100 \
+  --kill-old-delay=10 \
+  --backlog=100 \
+  -- \
+  bundle exec --keep-file-descriptors start_puma.rb puma -C config/puma.rb config.ru
+```
+
+An example of config/puma.rb:
+
+```ruby
+
+require 'server/starter/puma_listener'
+listener = ::Server::Starter::PumaListener
+
+APP_ROOT = File.expand_path('../..', __FILE__)
+status_file = File.join(APP_ROOT, 'log/start_server.stat')
+
+pidfile File.join(APP_ROOT, 'log/puma.pid')
+state_path File.join(APP_ROOT, 'log/puma.state')
+
+# prune_bundler # need to tweak lib/puma/launher to add { close_others: false } opts to Kernel.exec
+preload_app!
+
+# Configure "min" to be the minimum number of threads to use to answer
+# requests and "max" the maximum.
+# The default is "0, 16".
+threads 0, 16
+
+# How many worker processes to run. The default is "0".
+workers 2
+
+# Run puma via start_puma.rb to configure PUMA_INHERIT_\d ENV from SERVER_STARTER_PORT ENV as
+# $ bundle exec --keep-file-descriptors start_puma.rb puma -C config/puma.conf.rb config.ru
+if ENV['SERVER_STARTER_PORT']
+  puma_inherits = listener.listen
+  puma_inherits.each do |puma_inherit|
+    bind puma_inherit[:url]
+  end
+else
+  puts '[WARN] Fallback to 0.0.0.0:10080 since not running under Server::Starter'
+  bind 'tcp://0.0.0.0:10080'
+end
+
+# Code to run before doing a restart. This code should
+# close log files, database connections, etc.
+# This can be called multiple times to add code each time.
+on_restart do
+  puts 'On restart...'
+end
+
+# Code to run when a worker boots to setup the process before booting
+# the app. This can be called multiple times to add hooks.
+on_worker_boot do
+  defined?(ActiveRecord::Base) and ActiveRecord::Base.connection.disconnect!
+end
+
+# Code to run when a worker boots to setup the process after booting
+# the app. This can be called multiple times to add hooks.
+after_worker_boot do
+  defined?(ActiveRecord::Base) and ActiveRecord::Base.establish_connection
+end
+
+# Code to run when a worker shutdown.
+on_worker_shutdown do
+  puts 'On worker shutdown...'
+end
+```
+
 ## See Also
 
 * [「Server::Starterに対応するとはどういうことか」の補足](http://blog.livedoor.jp/sonots/archives/40248661.html) (Japanese)

data/example/resque/Gemfile

@@ -0,0 +1,6 @@
+source "http://rubygems.org"
+
+gem 'server-starter', path: '../../'
+gem 'resque_starter', git: 'https://github.com/sonots/resque_starter'
+gem 'pry'
+gem 'pry-nav'

data/example/resque/config/resque.conf.rb

@@ -0,0 +1,30 @@
+require 'server/starter/resque_listener'
+listener = Server::Starter::ResqueListener
+APP_ROOT = File.expand_path('../..', __FILE__)
+
+concurrency 2
+queues ['test']
+pid_file File.join(APP_ROOT, 'log/start_resque.pid')
+status_file File.join(APP_ROOT, 'log/start_resque.stat')
+
+# preload rails app
+# require File.join(APP_ROOT, 'config/environment')
+# Rails.application.eager_load!
+
+start_server_status_file = File.join(APP_ROOT, 'log/start_server.stat')
+
+before_fork do |starter, worker, worker_nr|
+  defined?(ActiveRecord::Base) and ActiveRecord::Base.connection.disconnect!
+end
+
+after_fork do |starter, worker, worker_nr|
+  defined?(ActiveRecord::Base) and ActiveRecord::Base.establish_connection
+
+  # Graceful restart
+  #
+  # This allows a new master process to incrementally
+  # phase out the old master process with SIGTTOU.
+  # The last worker spawned # will then kill off the old master
+  # process with a SIGQUIT.
+  listener.graceful_restart(starter, worker, worker_nr, start_server_status_file)
+end

data/example/resque/env/TEST

@@ -0,0 +1 @@
+foo

data/example/resque/my_job.rb

@@ -0,0 +1,7 @@
+class MyJob
+  @queue = :test
+
+  def self.perform(params)
+    puts params
+  end
+end

data/example/resque/restart_server

@@ -0,0 +1,7 @@
+#!/bin/sh
+# sends SIGHUP
+bundle exec start_server.rb \
+  --restart \
+  --dir=$(pwd) \
+  --pid-file=$(pwd)/log/start_server.pid \
+  --status-file=$(pwd)/log/start_server.stat

data/example/resque/start_server

@@ -0,0 +1,14 @@
+#!/bin/sh
+bundle exec start_server.rb \
+  --dir=$(pwd) \
+  --interval=1 \
+  --signal-on-hup=CONT \
+  --signal-on-TERM=TERM \
+  --pid-file=$(pwd)/log/start_server.pid \
+  --status-file=$(pwd)/log/start_server.stat \
+  --envdir=env \
+  --enable-auto-restart \
+  --auto-restart-interval=100 \
+  --kill-old-delay=1 \
+  -- \
+  bundle exec --keep-file-descriptors start_resque.rb -c config/resque.conf.rb 2>&1

data/example/unicorn/start_server

@@ -13,4 +13,4 @@ bundle exec start_server.rb \
   --kill-old-delay=1 \
   --backlog=100 \
   -- \
-  bundle exec --keep-file-descriptors unicorn -c config/unicorn.conf config.ru 2>&1
+  bundle exec --keep-file-descriptors unicorn -c config/unicorn.conf.rb config.ru 2>&1

data/lib/server/starter/resque_listener.rb

@@ -0,0 +1,28 @@
+require 'server/starter/version'
+
+class Server::Starter
+  class ResqueListener
+    # This allows a new master process to incrementally
+    # phase out the old master process with SIGTTOU.
+    # The last worker spawned will then kill off the old master
+    # process with a SIGQUIT.
+    #
+    # @param starter [ResqueStarter]
+    # @param worker [Resque::Worker]
+    # @param worker_nr [Integer] worker number
+    # @param status_file [String] path to Server::Starter status file (--status-file)
+    def self.graceful_restart(starter, worker, worker_nr, status_file)
+      pids = File.readlines(status_file).map {|_| _.chomp.split(':') }.to_h
+      old_gen = ENV['SERVER_STARTER_GENERATION'].to_i - 1
+      if old_pid = pids[old_gen.to_s]
+        sig = (worker_nr + 1) >= starter.num_workers ? :QUIT : :TTOU
+        Process.kill(sig, old_pid.to_i)
+        while starter.old_workers.size > starter.num_workers
+          sleep 0.1
+        end
+      end
+    rescue Errno::ENOENT, Errno::ESRCH => e
+      $stderr.puts "#{e.class} #{e.message}"
+    end
+  end
+end

data/lib/server/starter/version.rb

@@ -1,5 +1,5 @@
 class Server
   class Starter
-    VERSION = '0.3.0'
+    VERSION = '0.3.1'
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: server-starter
 version: !ruby/object:Gem::Version
-  version: 0.3.0
+  version: 0.3.1
 platform: ruby
 authors:
 - Naotoshi Seo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2016-04-03 00:00:00.000000000 Z
+date: 2016-08-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake
@@ -48,9 +48,16 @@ files:
 - example/puma/log/.gitkeep
 - example/puma/restart_server
 - example/puma/start_server
+- example/resque/Gemfile
+- example/resque/config/resque.conf.rb
+- example/resque/env/TEST
+- example/resque/log/.gitkeep
+- example/resque/my_job.rb
+- example/resque/restart_server
+- example/resque/start_server
 - example/unicorn/Gemfile
 - example/unicorn/config.ru
-- example/unicorn/config/unicorn.conf
+- example/unicorn/config/unicorn.conf.rb
 - example/unicorn/env/TEST
 - example/unicorn/log/.gitkeep
 - example/unicorn/restart_server
@@ -58,6 +65,7 @@ files:
 - lib/server/starter.rb
 - lib/server/starter/helper.rb
 - lib/server/starter/puma_listener.rb
+- lib/server/starter/resque_listener.rb
 - lib/server/starter/unicorn_listener.rb
 - lib/server/starter/version.rb
 - server-starter.gemspec