This release finally drops Ruby 1.8 support and requires Ruby 1.9.3 or later. The horrible "Status:" header in our HTTP response is finally gone, saving at least 16 precious bytes in every single HTTP response. Under Ruby 2.1 and later, the monotonic clock is used for timeout handling for better accuracy. Several experimental, unused and undocumented features are removed. There's also tiny, minor performance and memory improvements from dropping 1.8 compatibility, but probably nothing noticeable on a typical real-life (bloated) app. The biggest performance improvement we made was to our website by switching to olddoc. Depending on connection speed, latency, and renderer performance, it typically loads two to four times faster. Finally, for the billionth time: unicorn must never be exposed to slow clients, as it will never ever use new-fangled things like non-blocking socket I/O, threads, epoll or kqueue. unicorn must be used with a fully-buffering reverse proxy such as nginx for slow clients. I'll tag 5.0.0 final in a week or so if all goes well = gem install --pre unicorn = git clone git://bogomips.org/unicorn.git = http://unicorn.bogomips.org/ * ISSUES: update with mailing list subscription * GIT-VERSION-GEN: start 5.0.0 development * http: remove xftrust options * FAQ: add entry for Rails autoflush_log * dev: remove isolate dependency * unicorn.gemspec: depend on test-unit 3.0 * http_response: remove Status: header * remove RubyForge and Freecode references * remove mongrel.rubyforge.org references * http: remove the keepalive requests limit * http: reduce parser from 72 to 56 bytes on 64-bit * examples: add run_once to before_fork hook example * worker: remove old tmp accessor * http_server: save 450+ bytes of memory on x86-64 * t/t0002-parser-error.sh: relax test for rack 1.6.0 * remove SSL support * tmpio: drop the "size" method * switch docs + website to olddoc * README: clarify/reduce references to unicorn_rails * gemspec: fixup olddoc migration * use the monotonic clock under Ruby 2.1+ * http: -Wshorten-64-to-32 warnings on clang * remove old inetd+git examples and exec_cgi * http: standalone require + reduction in binary size * GNUmakefile: fix clean gem build + reduce build cruft * socket_helper: reduce constant lookups and caching * remove 1.8, <= 1.9.1 fallback for missing IO#autoclose= * favor IO#close_on_exec= over fcntl in 1.9+ * use require_relative to reduce syscalls at startup * doc: update support status for Ruby versions * fix uninstalled testing and reduce require paths * test_socket_helper: do not depend on SO_REUSEPORT * favor "a.b(&:c)" form over "a.b { |x| x.c }" * ISSUES: add section for bugs in other projects * http_server: favor ivars over constants * explain 11 byte magic number for self-pipe * const: drop constants used by Rainbows! * reduce and localize constant string use * Links: mark Rainbows! as historical, reference yahns * save about 200 bytes of memory on x86-64 * http: remove deprecated reset method * http: remove experimental dechunk! method * socket_helper: update comments * doc: document UNICORN_FD in manpage * doc: document Etc.nprocessors for worker_processes * favor more string literals for cold call sites * tee_input: support for Rack::TempfileReaper middleware * support TempfileReaper in deployment and development envs * favor kgio_wait_readable for single FD over select * Merge tag 'v4.9.0' * http_request: support rack.hijack by default * avoid extra allocation for hijack proc creation * FAQ: add note about ECONNRESET errors from bodies * process SIGWINCH unless stdin is a TTY * ISSUES: discourage HTML mail strongly, welcome nyms * http: use rb_hash_clear in Ruby 2.0+ * http_response: avoid special-casing for Rack < 1.5 * www: install NEWS.atom.xml properly * http_server: remove a few more accessors and constants * http_response: simplify regular expression * move the socket into Rack env for hijacking * http: move response_start_sent into the C ext * FAQ: reorder bit on Rack 1.1.x and Rails 2.3.x * ensure body is closed during hijack -- EW
Unicorn is an HTTP server for Rack applications designed to only serve fast clients on low-latency, high-bandwidth connections and take advantage of features in Unix/Unix-like kernels. Slow clients should only be served by placing a reverse proxy capable of fully buffering both the the request and response in between unicorn and slow clients. * http://unicorn.bogomips.org/ * public list: unicorn-public@bogomips.org * mail archives: http://bogomips.org/unicorn-public/ * git clone git://bogomips.org/unicorn.git * http://unicorn.bogomips.org/NEWS.atom.xml Changes: unicorn 4.9.0 - TempfileReaper support in Rack 1.6 This release supports the Rack::TempfileReaper middleware found in rack 1.6 for cleaning up disk space used by temporary files. We also use Rack::TempfileReaper for cleaning up large temporary files buffered with TeeInput. Users on rack 1.5 and earlier will see no changes. There's also a bunch of documentation/build system improvements. This is likely to be the last Ruby 1.8-compatible release, unicorn 5.x will require 1.9.3 or later as well as dropping lots of cruft (the stupid "Status:" header in responses being the most notable). 21 changes backported from master: ISSUES: update with mailing list subscription FAQ: add entry for Rails autoflush_log dev: remove isolate dependency unicorn.gemspec: depend on test-unit 3.0 remove RubyForge and Freecode references remove mongrel.rubyforge.org references examples: add run_once to before_fork hook example t/t0002-parser-error.sh: relax test for rack 1.6.0 switch docs + website to olddoc README: clarify/reduce references to unicorn_rails gemspec: fixup olddoc migration GNUmakefile: fix clean gem build + reduce build cruft doc: update support status for Ruby versions fix uninstalled testing and reduce require paths test_socket_helper: do not depend on SO_REUSEPORT ISSUES: add section for bugs in other projects explain 11 byte magic number for self-pipe Links: mark Rainbows! as historical, reference yahns doc: document UNICORN_FD in manpage tee_input: support for Rack::TempfileReaper middleware support TempfileReaper in deployment and development envs -- EW
Only backporting documentation + build/test system fixes, but I'll probably apply and push the TeeInput patch in: http://bogomips.org/unicorn-public/m/20150422183808.GA5277@dcvr.yhbt.net.txt The following changes since commit 7087bb7ed5a1b9d9f24069cb92707d086668b6dc: unicorn 4.8.3 - the end of an era (2014-05-07 07:49:19 +0000) are available in the git repository at: git://bogomips.org/unicorn 4.8.x-stable for you to fetch changes up to 548e1e67d314f6ebd17df37ece0ee20632462f6f: doc: document UNICORN_FD in manpage (2015-04-22 18:57:39 +0000) ---------------------------------------------------------------- Eric Wong (19): ISSUES: update with mailing list subscription FAQ: add entry for Rails autoflush_log dev: remove isolate dependency unicorn.gemspec: depend on test-unit 3.0 remove RubyForge and Freecode references remove mongrel.rubyforge.org references examples: add run_once to before_fork hook example t/t0002-parser-error.sh: relax test for rack 1.6.0 switch docs + website to olddoc README: clarify/reduce references to unicorn_rails gemspec: fixup olddoc migration GNUmakefile: fix clean gem build + reduce build cruft doc: update support status for Ruby versions fix uninstalled testing and reduce require paths test_socket_helper: do not depend on SO_REUSEPORT ISSUES: add section for bugs in other projects explain 11 byte magic number for self-pipe Links: mark Rainbows! as historical, reference yahns doc: document UNICORN_FD in manpage .document | 1 - .gitignore | 4 +- .wrongdoc.yml => .olddoc.yml | 6 ++- Documentation/unicorn.1.txt | 7 ++++ FAQ | 10 ++++- GNUmakefile | 71 +++++++++++++---------------------- HACKING | 31 ++++----------- ISSUES | 46 +++++++++++++++++++++-- KNOWN_ISSUES | 20 +++++----- Links | 5 ++- README | 10 ++--- Rakefile | 44 ---------------------- Sandbox | 2 +- examples/unicorn.conf.rb | 11 ++++++ lib/unicorn/configurator.rb | 2 - lib/unicorn/http_server.rb | 6 ++- local.mk.sample | 59 ----------------------------- script/isolate_for_tests | 31 --------------- t/GNUmakefile | 6 +-- t/README | 2 +- t/t0002-parser-error.sh | 6 +-- test/exec/test_exec.rb | 2 +- test/test_helper.rb | 4 +- test/unit/test_http_parser.rb | 6 +-- test/unit/test_http_parser_ng.rb | 2 +- test/unit/test_http_parser_xftrust.rb | 2 +- test/unit/test_request.rb | 2 +- test/unit/test_response.rb | 6 +-- test/unit/test_server.rb | 6 +-- test/unit/test_signals.rb | 2 +- test/unit/test_socket_helper.rb | 8 ++-- test/unit/test_upload.rb | 2 +- test/unit/test_util.rb | 2 +- unicorn.gemspec | 13 +++---- 34 files changed, 167 insertions(+), 270 deletions(-) rename .wrongdoc.yml => .olddoc.yml (85%) delete mode 100644 local.mk.sample delete mode 100755 script/isolate_for_tests
unicorn 5 will not support Ruby 1.8 anymore. Drop mentions of Rubinius, too, it's too difficult to support due to the proprietary and registration-required nature of its bug tracker. The smaller memory footprint and CoW-friendly memory allocator in mainline Ruby is a better fit for unicorn, anyways. Since Ruby 1.9+ bundles RubyGems and gem startup is faster nowadays, we'll just depend on that instead of not loading RubyGems. Drop the local.mk.sample file, too, since it's way out-of-date and probably isn't useful (I have not used it in a while). --- HACKING | 23 +++------------- KNOWN_ISSUES | 20 +++++++------- README | 3 ++- Sandbox | 2 +- lib/unicorn/configurator.rb | 2 -- lib/unicorn/http_server.rb | 4 +-- local.mk.sample | 59 ----------------------------------------- t/README | 2 +- test/unit/test_socket_helper.rb | 4 +-- 9 files changed, 22 insertions(+), 97 deletions(-) delete mode 100644 local.mk.sample diff --git a/HACKING b/HACKING index 9b4da1b..6c5f897 100644 --- a/HACKING +++ b/HACKING @@ -19,13 +19,6 @@ RubyGems. Users of GNU-based systems (such as GNU/Linux) usually have GNU make installed as "make" instead of "gmake". -Since we don't load RubyGems by default, loading Rack properly requires -setting up RUBYLIB to point to where Rack is located. Not loading -RubyGems drastically lowers the time to run the full test suite. You -may setup a "local.mk" file in the top-level working directory to setup -your RUBYLIB and any other environment variables. A "local.mk.sample" -file is provided for reference. - Running the entire test suite with 4 tests in parallel: gmake -j4 check @@ -70,10 +63,9 @@ becomes unavailable. === Ruby/C Compatibility -We target Ruby 1.8.6+, 1.9 and will target Rubinius as it becomes -production-ready. We need the Ruby implementation to support fork, -exec, pipe, UNIX signals, access to integer file descriptors and -ability to use unlinked files. +We target mainline Ruby 1.9.3 and later. We need the Ruby +implementation to support fork, exec, pipe, UNIX signals, access to +integer file descriptors and ability to use unlinked files. All of our C code is OS-independent and should run on compilers supported by the versions of Ruby we target. @@ -123,13 +115,6 @@ You can build the Unicorn gem with the following command: It is easy to install the contents of your git working directory: -Via RubyGems (RubyGems 1.3.5+ recommended for prerelease versions): +Via RubyGems gmake install-gem - -Without RubyGems (via setup.rb): - - gmake install - -It is not at all recommended to mix a RubyGems installation with an -installation done without RubyGems, however. diff --git a/KNOWN_ISSUES b/KNOWN_ISSUES index 38263e7..69e4f57 100644 --- a/KNOWN_ISSUES +++ b/KNOWN_ISSUES @@ -17,16 +17,6 @@ acceptable solution. Those issues are documented here. have builtin workarounds for Kernel#rand and OpenSSL::Random users, but applications may use other PRNGs. -* Under some versions of Ruby 1.8, it is necessary to call +srand+ in an - after_fork hook to get correct random number generation. We have a builtin - workaround for this starting with \Unicorn 3.6.1 - - See http://redmine.ruby-lang.org/issues/show/4338 - -* On Ruby 1.8 prior to Ruby 1.8.7-p248, *BSD platforms have a broken - stdio that causes failure for file uploads larger than 112K. Upgrade - your version of Ruby or continue using Unicorn 1.x/3.4.x. - * For notes on sandboxing tools such as Bundler or Isolate, see the {Sandbox}[link:Sandbox.html] page. @@ -44,6 +34,16 @@ acceptable solution. Those issues are documented here. == Known Issues (Old) +* Under some versions of Ruby 1.8, it is necessary to call +srand+ in an + after_fork hook to get correct random number generation. We have a builtin + workaround for this starting with \Unicorn 3.6.1 + + See http://redmine.ruby-lang.org/issues/show/4338 + +* On Ruby 1.8 prior to Ruby 1.8.7-p248, *BSD platforms have a broken + stdio that causes failure for file uploads larger than 112K. Upgrade + your version of Ruby or continue using Unicorn 1.x/3.4.x. + * Under Ruby 1.9.1, methods like Array#shuffle and Array#sample will segfault if called after forking. Upgrade to Ruby 1.9.2 or call "Kernel.rand" in your after_fork hook to reinitialize the random diff --git a/README b/README index 02d01e1..f084d0c 100644 --- a/README +++ b/README @@ -12,7 +12,8 @@ both the the request and response in between \Unicorn and slow clients. cut out everything that is better supported by the operating system, {nginx}[http://nginx.net/] or {Rack}[http://rack.github.io/]. -* Compatible with Ruby 1.8 and later. Rubinius support is in-progress. +* Compatible with Ruby 1.9.3 and later. + unicorn 4.8.x will remain supported for Ruby 1.8 users. * Process management: \Unicorn will reap and restart workers that die from broken apps. There is no need to manage multiple processes diff --git a/Sandbox b/Sandbox index 3c7f226..f662b27 100644 --- a/Sandbox +++ b/Sandbox @@ -86,7 +86,7 @@ For now workarounds include doing one of the following: 3. Explicitly setting RUBYLIB or $LOAD_PATH to include any gem path where the unicorn gem is installed - (e.g. /usr/lib/ruby/gems/1.9.1/gems/unicorn-VERSION/lib) + (e.g. /usr/lib/ruby/gems/1.9.3/gems/unicorn-VERSION/lib) === RUBYOPT pollution from SIGUSR2 upgrades diff --git a/lib/unicorn/configurator.rb b/lib/unicorn/configurator.rb index d14e608..69b4644 100644 --- a/lib/unicorn/configurator.rb +++ b/lib/unicorn/configurator.rb @@ -306,8 +306,6 @@ class Unicorn::Configurator # to receive IPv4 queries on dual-stack systems. A separate IPv4-only # listener is required if this is true. # - # This option is only available for Ruby 1.9.2 and later. - # # Enabling this option for the IPv6-only listener and having a # separate IPv4 listener is recommended if you wish to support IPv6 # on the same TCP port. Otherwise, the value of \env[\"REMOTE_ADDR\"] diff --git a/lib/unicorn/http_server.rb b/lib/unicorn/http_server.rb index 95a8ffe..895f56d 100644 --- a/lib/unicorn/http_server.rb +++ b/lib/unicorn/http_server.rb @@ -67,7 +67,7 @@ class Unicorn::HttpServer # you can set the following in your Unicorn config file, HUP and then # continue with the traditional USR2 + QUIT upgrade steps: # - # Unicorn::HttpServer::START_CTX[0] = "/home/bofh/1.9.2/bin/unicorn" + # Unicorn::HttpServer::START_CTX[0] = "/home/bofh/2.2.0/bin/unicorn" START_CTX = { :argv => ARGV.map { |arg| arg.dup }, 0 => $0.dup, @@ -453,7 +453,7 @@ class Unicorn::HttpServer # exec(command, hash) works in at least 1.9.1+, but will only be # required in 1.9.4/2.0.0 at earliest. - cmd << listener_fds if RUBY_VERSION >= "1.9.1" + cmd << listener_fds logger.info "executing #{cmd.inspect} (in #{Dir.pwd})" before_exec.call(self) exec(*cmd) diff --git a/local.mk.sample b/local.mk.sample deleted file mode 100644 index 25bca5d..0000000 diff --git a/t/README b/t/README index 095f106..bcaf3ce 100644 --- a/t/README +++ b/t/README @@ -10,7 +10,7 @@ comfortable writing integration tests with. == Requirements -* {Ruby 1.8 or 1.9}[http://www.ruby-lang.org/] (duh!) +* {Ruby 1.9.3+}[https://www.ruby-lang.org/] (duh!) * {GNU make}[http://www.gnu.org/software/make/] * {socat}[http://www.dest-unreach.org/socat/] * {curl}[http://curl.haxx.se/] diff --git a/test/unit/test_socket_helper.rb b/test/unit/test_socket_helper.rb index dd6881c..994b990 100644 --- a/test/unit/test_socket_helper.rb +++ b/test/unit/test_socket_helper.rb @@ -182,8 +182,8 @@ class TestSocketHelper < Test::Unit::TestCase sock = bind_listen "[#@test6_addr]:#{port}", :ipv6only => true cur = sock.getsockopt(:IPPROTO_IPV6, :IPV6_V6ONLY).unpack('i')[0] assert_equal 1, cur - rescue Errno::EAFNOSUPPORT - end if RUBY_VERSION >= "1.9.2" + rescue Errno::EAFNOSUPPORT + end def test_reuseport port = unused_port @test_addr -- EW