require_relative "helper" require "puma/cli" require "puma/control_cli" # These don't run on travis because they're too fragile class TestIntegration < Minitest::Test def setup @state_path = "test/test_puma.state" @bind_path = "test/test_server.sock" @control_path = "test/test_control.sock" @token = "xxyyzz" @tcp_port = 9998 @server = nil @wait, @ready = IO.pipe @events = Puma::Events.strings @events.on_booted { @ready << "!" } end def teardown File.unlink @state_path rescue nil File.unlink @bind_path rescue nil File.unlink @control_path rescue nil @wait.close @ready.close if @server Process.kill "INT", @server.pid begin Process.wait @server.pid rescue Errno::ECHILD end @server.close end end def server(argv) # when we were started with bundler all load-paths and bin-paths are setup correctly # this is what 9X% of users run, so it is what we should test # the other case is solely for package builders or testing 1-off cases where the system puma is used base = (defined?(Bundler) ? "bundle exec puma" : "#{Gem.ruby} -Ilib bin/puma") cmd = "#{base} -b tcp://127.0.0.1:#{@tcp_port} #{argv}" @server = IO.popen(cmd, "r") wait_for_server_to_boot @server end def start_forked_server(argv) pid = fork do exec "#{Gem.ruby} -I lib/ bin/puma -b tcp://127.0.0.1:#{@tcp_port} #{argv}" end sleep 5 pid end def stop_forked_server(pid) Process.kill(:TERM, pid) sleep 1 Process.wait2(pid) end def restart_server_and_listen(argv) skip_on_appveyor server(argv) s = connect initial_reply = read_body(s) restart_server(s) [initial_reply, read_body(connect)] end def signal(which) Process.kill which, @server.pid end def wait_booted @wait.sysread 1 end # reuses an existing connection to make sure that works def restart_server(connection) signal :USR2 connection.write "GET / HTTP/1.1\r\n\r\n" # trigger it to start by sending a new request wait_for_server_to_boot end def connect s = TCPSocket.new "localhost", @tcp_port s << "GET / HTTP/1.1\r\n\r\n" true until s.gets == "\r\n" s end def wait_for_server_to_boot true while @server.gets !~ /Ctrl-C/ # wait for server to say it booted end def read_body(connection) Timeout.timeout(10) do loop do response = connection.readpartial(1024) body = response.split("\r\n\r\n", 2).last return body if body && !body.empty? sleep 0.01 end end end def test_stop_via_pumactl skip if Puma.jruby? || Puma.windows? conf = Puma::Configuration.new do |c| c.quiet c.state_path @state_path c.bind "unix://#{@bind_path}" c.activate_control_app "unix://#{@control_path}", :auth_token => @token c.rackup "test/rackup/hello.ru" end l = Puma::Launcher.new conf, :events => @events t = Thread.new do Thread.current.abort_on_exception = true l.run end wait_booted s = UNIXSocket.new @bind_path s << "GET / HTTP/1.0\r\n\r\n" assert_equal "Hello World", read_body(s) sout = StringIO.new ccli = Puma::ControlCLI.new %W!-S #{@state_path} stop!, sout ccli.run assert_kind_of Thread, t.join, "server didn't stop" end def test_phased_restart_via_pumactl skip if Puma.jruby? || Puma.windows? || ENV['CI'] conf = Puma::Configuration.new do |c| c.quiet c.state_path @state_path c.bind "unix://#{@bind_path}" c.activate_control_app "unix://#{@control_path}", :auth_token => @token c.workers 2 c.worker_shutdown_timeout 1 c.rackup "test/rackup/hello-stuck.ru" end l = Puma::Launcher.new conf, :events => @events t = Thread.new do Thread.current.abort_on_exception = true l.run end wait_booted s = UNIXSocket.new @bind_path s << "GET / HTTP/1.0\r\n\r\n" sout = StringIO.new # Phased restart ccli = Puma::ControlCLI.new ["-S", @state_path, "phased-restart"], sout ccli.run done = false until done @events.stdout.rewind log = @events.stdout.readlines.join("") if log.match(/- Worker \d \(pid: \d+\) booted, phase: 1/) assert_match(/TERM sent/, log) assert_match(/- Worker \d \(pid: \d+\) booted, phase: 1/, log) done = true end end # Stop ccli = Puma::ControlCLI.new ["-S", @state_path, "stop"], sout ccli.run assert_kind_of Thread, t.join, "server didn't stop" end def test_kill_unknown_via_pumactl skip if Puma.jruby? || Puma.windows? # we run ls to get a 'safe' pid to pass off as puma in cli stop # do not want to accidently kill a valid other process io = IO.popen("ls") safe_pid = io.pid Process.wait safe_pid sout = StringIO.new e = assert_raises SystemExit do ccli = Puma::ControlCLI.new %W!-p #{safe_pid} stop!, sout ccli.run end sout.rewind assert_match(/No pid '\d+' found/, sout.readlines.join("")) assert_equal(1, e.status) end def test_restart_closes_keepalive_sockets _, new_reply = restart_server_and_listen("-q test/rackup/hello.ru") assert_equal "Hello World", new_reply end def test_restart_closes_keepalive_sockets_workers skip_on_jruby _, new_reply = restart_server_and_listen("-q -w 2 test/rackup/hello.ru") assert_equal "Hello World", new_reply end # It does not share environments between multiple generations, which would break Dotenv def test_restart_restores_environment # jruby has a bug where setting `nil` into the ENV or `delete` do not change the # next workers ENV skip_on_jruby initial_reply, new_reply = restart_server_and_listen("-q test/rackup/hello-env.ru") assert_includes initial_reply, "Hello RAND" assert_includes new_reply, "Hello RAND" refute_equal initial_reply, new_reply end def test_term_signal_exit_code_in_single_mode skip if Puma.jruby? || Puma.windows? pid = start_forked_server("test/rackup/hello.ru") _, status = stop_forked_server(pid) assert_equal 15, status end def test_term_signal_exit_code_in_clustered_mode skip if Puma.jruby? || Puma.windows? pid = start_forked_server("-w 2 test/rackup/hello.ru") _, status = stop_forked_server(pid) assert_equal 15, status end end