about summary refs log tree commit homepage
diff options
context:
space:
mode:
authorEric Wong <e@80x24.org>2016-07-31 14:25:38 +0000
committerEric Wong <e@80x24.org>2016-07-31 15:09:14 +0000
commit3c667865a959a077fe06c6c56057096e78f962ec (patch)
tree7c2ec4d1284b2e460958a17a52dc729ab1b4c7ac
parentd4b0198a877e65d04783c771ef55762730f3984f (diff)
downloadraindrops-3c667865a959a077fe06c6c56057096e78f962ec.tar.gz
Since zbatery is abandoned, point users towards yahns
instead since that is what I currently use.
-rw-r--r--examples/yahns.conf.rb30
-rw-r--r--examples/zbatery.conf.rb5
2 files changed, 34 insertions, 1 deletions
diff --git a/examples/yahns.conf.rb b/examples/yahns.conf.rb
new file mode 100644
index 0000000..f5b4f10
--- /dev/null
+++ b/examples/yahns.conf.rb
@@ -0,0 +1,30 @@
+# Inlined rack app using yahns server (git clone git://yhbt.net/yahns.git)
+# Usage: yahns -c /path/to/this/file.conf.rb
+# There is no separate config.ru file for this example,
+# but rack_app may also be a string pointing to the path of a
+# config.ru file
+
+require 'rack'
+rack_app = Rack::Builder.new do
+  use Rack::Head
+  addr = %w(0.0.0.0:9418 0.0.0.0:443 [::]:443 0.0.0.0:80 [::]:80
+            127.0.0.1:6081 127.0.0.1:280 0.0.0.0:119 [::]:119)
+  use Raindrops::Middleware, listeners: addr
+  run Raindrops::Watcher.new(listeners: addr)
+end.to_app
+# rack_app = '/path/to/config.ru' # a more standard config
+
+app(:rack, rack_app) do
+  # I keep IPv4 and IPv6 on separate sockets to avoid ugly
+  # IPv4-mapped-IPv6 addresses:
+  listen 8080
+  listen '[::]:8080', ipv6only: true
+  client_max_body_size 0 # no POST or any uploads
+  client_timeout 5
+  output_buffering false # needed for /tail/ endpoint to avoid ENOSPC
+  queue { worker_threads 30 }
+end
+
+# logging is optional, but recommended for diagnosing problems
+# stderr_path '/var/log/yahns/stderr-raindrops.log'
+# stdout_path '/var/log/yahns/stdout-raindrops.log'
diff --git a/examples/zbatery.conf.rb b/examples/zbatery.conf.rb
index 3f67c7a..5f94c0e 100644
--- a/examples/zbatery.conf.rb
+++ b/examples/zbatery.conf.rb
@@ -1,6 +1,9 @@
 # Used for running Raindrops::Watcher, which requires a multi-threaded
 # Rack server capable of streaming a response.  Threads must be used,
-# so Zbatery is recommended: http://zbatery.bogomip.org/
+# so any multi-threaded Rack server may be used.
+# zbatery was recommended in the past, but it is abandoned
+# <http://zbatery.bogomip.org/>.
+# yahns may work as an alternative (see yahns.conf.rb in this dir)
 Rainbows! do
   use :ThreadSpawn
 end