upstart-unicorn-launcher 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d109d9f24ae93e72009230eb434e0a9abcafa2b6
+  data.tar.gz: 981df7c77180b3896c5bca99157843939b888fff
+SHA512:
+  metadata.gz: df7459fba6ab6f0f2c03a54ed0356c47a1116f7d3f21299abbe5b39655f6a48e171c3eafeb1d10b3cd768e7cc32fccb57eefbba5cc9dbd4c615318ff45aaae31
+  data.tar.gz: 62a444ff416ca8334264e026c333d3454081e01381be722e4ad11b9bebc9a757687f8d1df501563f9f313dbf17983780bc11d58651199a795d452a14cf6b64e6

data/.gitignore

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

data/Gemfile

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

data/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2012 Tom Ward
+
+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 @@
+A simple unicorn launcher for use with upstart, in the same manner as https://github.com/alphagov/unicornherder

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/bin/upstart-unicorn-launcher

@@ -0,0 +1,22 @@
+#!/usr/bin/env ruby
+
+require 'upstart_unicorn_launcher'
+require 'optparse'
+
+options = {}
+
+command_index = ARGV.index("--")
+command = ARGV[command_index + 1..-1].join(" ")
+
+OptionParser.new do |opts|
+  opts.on("-p", "--pidfile PIDFILE", "Path to the main unicorn PIDFILE") do |pidfile|
+    options[:pidfile] = pidfile
+  end
+
+  opts.on("-s", "--startup-time STARTUP", "Time to wait for server to start") do |time|
+    options[:startup] = time.to_i
+  end
+end.parse!(ARGV[0...command_index])
+
+launcher = UpstartUnicornLauncher.new command, options
+launcher.start

data/lib/upstart-unicorn-launcher.rb

@@ -0,0 +1 @@
+require "upstart_unicorn_launcher"

data/lib/upstart_unicorn_launcher/version.rb

@@ -0,0 +1,3 @@
+class UpstartUnicornLauncher
+  VERSION = "0.0.1"
+end

data/lib/upstart_unicorn_launcher.rb

@@ -0,0 +1,104 @@
+require "upstart_unicorn_launcher/version"
+
+class UpstartUnicornLauncher
+  attr_accessor :command, :pidfile, :startup_period, :tick_period, :restarting
+
+  def initialize(command, options = {})
+    self.command = command
+    self.pidfile = File.expand_path(options[:pidfile] || 'unicorn.pid')
+    self.startup_period = options[:startup] || 60
+    self.tick_period = options[:tick] || 1
+  end
+
+  def start
+    debug "Starting server"
+    restart_server_on :HUP
+    quit_server_on :QUIT, :INT, :TERM
+    forward_to_server :USR1, :USR2, :WINCH, :TTIN, :TTOU
+    start_server
+    wait_until_server_quits
+  end
+
+  private
+
+  def start_server
+    abort "The unicorn pidfile '#{pidfile}' already exists.  Is the server running already?" if File.exist?(pidfile)
+    spawned_pid = Process.spawn command
+    sleep 0.5
+    unless File.exist?(pidfile)
+      Process.kill "QUIT", spawned_pid
+      abort "Unable to find server running with pidfile #{pidfile}.  Exiting"
+    end
+  end
+
+  def restart_server_on(*signals)
+    signals.each do |signal|
+      trap(signal.to_s) { restart_server }
+    end
+  end
+
+  def quit_server_on(*signals)
+    signals.each do |signal|
+      trap(signal.to_s) do
+        Process.kill signal.to_s, pid
+        exit
+      end
+    end
+  end
+
+  def forward_to_server(*signals)
+    signals.each do |signal|
+      trap(signal.to_s) do
+        debug "Forwarding #{signal} to #{pid}"
+        Process.kill signal.to_s, pid
+      end
+    end
+  end
+
+  def wait_until_server_quits
+    while running?
+      sleep tick_period
+    end
+  end
+
+  def restart_server
+    reexecute_running_binary
+    wait_for_server_to_start
+    quit_old_master
+  end
+
+  def reexecute_running_binary
+    Process.kill "USR2", pid
+  end
+
+  def wait_for_server_to_start
+    sleep startup_period
+  end
+
+  def quit_old_master
+    if old_pid
+      Process.kill "QUIT", old_pid
+    end
+  end
+
+  def pid
+    File.exist?(pidfile) && File.read(pidfile).to_i
+  end
+
+  def old_pid
+    old_pidfile = pidfile + ".oldbin"
+    File.exist?(old_pidfile) && File.read(old_pidfile).to_i
+  end
+
+  def running?
+    pid && Process.getpgid(pid)
+  rescue Errno::ESRCH
+    false
+  end
+
+  private
+
+  def debug(message)
+    puts message
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,24 @@
+module ProjectSupport
+  def perform_request
+    response = Curl::Easy.perform('http://localhost:7516')
+  end
+
+  def start_launcher
+    @launcher_pid = Process.spawn "upstart-unicorn-launcher -s 1 -p spec/templates/test/unicorn.pid -- unicorn -p 7516 -c spec/templates/test/unicorn.rb spec/templates/test/config.ru"
+    sleep 1
+    puts "Launched upstart-unicorn-launcher with PID #{@launcher_pid}"
+  end
+
+  def send_to_launcher(signal)
+    Process.kill signal, @launcher_pid
+  end
+
+  def kill_launcher
+    puts "Killing #{@launcher_pid}"
+    Process.kill "QUIT", @launcher_pid
+  end
+end
+
+RSpec.configure do |config|
+  config.include ProjectSupport
+end

data/spec/templates/test/Gemfile

@@ -0,0 +1,3 @@
+source :rubygems
+
+gem 'unicorn'

data/spec/templates/test/config.ru

@@ -0,0 +1,4 @@
+# A very simple server that always responds with the time it was started.  This
+# is used in tests to check whether the server has started or restarted
+time = Time.now.to_f
+run lambda { |env| [200, {"Content-Type" => "text/plain"}, ["#{time}"]] }

data/spec/templates/test/unicorn.rb

@@ -0,0 +1 @@
+pid "/Users/tomw/Projects/tools/upstart-unicorn-launcher/spec/templates/test/unicorn.pid"

data/spec/upstart_integration_spec.rb

@@ -0,0 +1,53 @@
+require 'spec_helper'
+require 'curl'
+
+describe 'Upstart integration' do
+  after :each do
+    kill_launcher
+  end
+
+  it 'starts server' do
+    start_launcher
+    expect {perform_request}.to_not raise_error
+  end
+
+  it 'stops server when sent QUIT' do
+    start_launcher
+    send_to_launcher 'QUIT'
+    sleep 1
+    expect {perform_request}.to raise_error
+  end
+
+  it 'stops server when sent INT' do
+    start_launcher
+    send_to_launcher 'INT'
+    sleep 1
+    expect {perform_request}.to raise_error
+  end
+
+  it 'stops server when sent TERM' do
+    start_launcher
+    send_to_launcher 'INT'
+    sleep 1
+    expect {perform_request}.to raise_error
+  end
+
+  it 'restarts server when sent HUP' do
+    start_launcher
+    original_response = perform_request.body_str
+    send_to_launcher 'HUP'
+    sleep 1
+    expect(perform_request.body_str).to_not eql(original_response)
+  end
+
+  it 'continues to serve requests during restart' do
+    start_launcher
+    start = Time.now
+    send_to_launcher 'HUP'
+    responses = []
+    while Time.now < (start + 2)
+      expect {responses << perform_request.body_str}.to_not raise_error
+    end
+    expect(responses.uniq.size).to eql(2)
+  end
+end

data/upstart-unicorn-launcher.gemspec

@@ -0,0 +1,22 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/upstart_unicorn_launcher/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors       = ["Tom Ward"]
+  gem.email         = ["tom@popdog.net"]
+  gem.description   = %q{Launch unicorn with upstart}
+  gem.summary       = %q{Helps launch unicorn using upstart process management}
+  gem.homepage      = ""
+
+  gem.files         = `git ls-files`.split($\)
+  gem.executables   = gem.files.grep(%r{^bin/}).map{ |f| File.basename(f) }
+  gem.test_files    = gem.files.grep(%r{^(test|spec|features)/})
+  gem.name          = "upstart-unicorn-launcher"
+  gem.require_paths = ["lib"]
+  gem.version       = UpstartUnicornLauncher::VERSION
+
+  gem.add_dependency 'unicorn'
+
+  gem.add_development_dependency 'rspec'
+  gem.add_development_dependency 'curb'
+end

metadata

@@ -0,0 +1,106 @@
+--- !ruby/object:Gem::Specification
+name: upstart-unicorn-launcher
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Tom Ward
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-06-11 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: unicorn
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  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: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: curb
+  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: Launch unicorn with upstart
+email:
+- tom@popdog.net
+executables:
+- upstart-unicorn-launcher
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- LICENSE
+- README.md
+- Rakefile
+- bin/upstart-unicorn-launcher
+- lib/upstart-unicorn-launcher.rb
+- lib/upstart_unicorn_launcher.rb
+- lib/upstart_unicorn_launcher/version.rb
+- spec/spec_helper.rb
+- spec/templates/test/Gemfile
+- spec/templates/test/config.ru
+- spec/templates/test/unicorn.rb
+- spec/upstart_integration_spec.rb
+- upstart-unicorn-launcher.gemspec
+homepage: ''
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+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: []
+rubyforge_project: 
+rubygems_version: 2.0.2
+signing_key: 
+specification_version: 4
+summary: Helps launch unicorn using upstart process management
+test_files:
+- spec/spec_helper.rb
+- spec/templates/test/Gemfile
+- spec/templates/test/config.ru
+- spec/templates/test/unicorn.rb
+- spec/upstart_integration_spec.rb