rainbows 5.2.0 → 5.2.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/.olddoc.yml +13 -9
- data/Documentation/.gitignore +1 -3
- data/Documentation/comparison.haml +1 -1
- data/FAQ +1 -1
- data/GIT-VERSION-GEN +1 -1
- data/GNUmakefile +13 -14
- data/HACKING +2 -2
- data/README +10 -8
- data/Sandbox +1 -1
- data/TUNING +2 -2
- data/archive/slrnpull.conf +1 -1
- data/examples/reverse_proxy.ru +1 -1
- data/lib/rainbows.rb +1 -1
- data/lib/rainbows/configurator.rb +2 -2
- data/lib/rainbows/epoll.rb +1 -1
- data/lib/rainbows/reverse_proxy.rb +1 -1
- data/pkg.mk +1 -1
- data/rainbows.gemspec +8 -8
- data/vs_Unicorn +1 -1
- metadata +11 -14
- data/Documentation/GNUmakefile +0 -33
- data/Documentation/rainbows.1.txt +0 -161
- data/archive/rfmig.rb +0 -32
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 686e8152cb58bfa7c4aa6050458ae6a782e54ff2fe9738dbc256c4d14a81b866
|
4
|
+
data.tar.gz: c0ba45e51c8bf1533bdbe77d9ef420f1727356c64b8f89c0a57ac06059f6a574
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: ee48de227caf9ed66af41c41ba9a61d838c29ea44944464f63cc9cecaa2f2a2ea6c66aff4960484dc49f781fe08973372b8d20dbb4ef8a19a571f56931a54b4e
|
7
|
+
data.tar.gz: 3af8a3af2c85c3e03e093742627fc93f783f3dc5ebdd3d52cae1673b5f3b3f54a5c821a29f8177a7f9783206da21af321585a376b48864a65fd355f33a90c825
|
data/.olddoc.yml
CHANGED
@@ -1,12 +1,10 @@
|
|
1
1
|
---
|
2
|
-
cgit_url: https://
|
3
|
-
|
4
|
-
rdoc_url: https://bogomips.org/rainbows/
|
2
|
+
cgit_url: https://yhbt.net/rainbows.git/
|
3
|
+
rdoc_url: https://yhbt.net/rainbows/
|
5
4
|
merge_html:
|
6
|
-
rainbows_1:
|
5
|
+
rainbows_1: man/man1/rainbows.1.html
|
7
6
|
Summary: Documentation/comparison.html
|
8
|
-
public_email: rainbows-public@
|
9
|
-
private_email: rainbows@bogomips.org
|
7
|
+
public_email: rainbows-public@yhbt.net
|
10
8
|
noindex:
|
11
9
|
- TODO
|
12
10
|
- LATEST
|
@@ -15,7 +13,13 @@ noindex:
|
|
15
13
|
- Unicorn::SocketHelper
|
16
14
|
- EM
|
17
15
|
- Revactor
|
18
|
-
ml_url:
|
16
|
+
ml_url:
|
17
|
+
- https://yhbt.net/rainbows-public/
|
18
|
+
- http://ou63pmih66umazou.onion/rainbows-public/
|
19
|
+
source_code:
|
20
|
+
- git clone https://yhbt.net/rainbows.git
|
21
|
+
- torsocks git clone http://ou63pmih66umazou.onion/rainbows.git
|
19
22
|
nntp_url:
|
20
|
-
|
21
|
-
|
23
|
+
- nntp://news.public-inbox.org/inbox.comp.lang.ruby.rainbows
|
24
|
+
- nntp://ou63pmih66umazou.onion/inbox.comp.lang.ruby.rainbows
|
25
|
+
- nntp://news.gmane.io/gmane.comp.lang.ruby.rainbows.general
|
data/Documentation/.gitignore
CHANGED
@@ -153,7 +153,7 @@
|
|
153
153
|
CoolioThread* and CoolioThread* requires Ruby 1.9 reasonable performance
|
154
154
|
%li
|
155
155
|
rack.input streaming is what makes
|
156
|
-
%a(href="http://
|
156
|
+
%a(href="http://yhbt.net/upr/") upload progress,
|
157
157
|
and BOSH possible
|
158
158
|
%li
|
159
159
|
rack.input streaming is NOT compatible with current versions of nginx
|
data/FAQ
CHANGED
@@ -64,7 +64,7 @@ requires a extra {patch}[http://haproxy.1wt.eu/download/patches/].
|
|
64
64
|
If you don't need streaming "rack.input", then nginx is a great HTTPS
|
65
65
|
reverse proxy.
|
66
66
|
|
67
|
-
Refer to the {unicorn FAQ}[https://
|
67
|
+
Refer to the {unicorn FAQ}[https://yhbt.net/unicorn/FAQ.html] on how
|
68
68
|
to ensure redirects go to "https://" URLs.
|
69
69
|
|
70
70
|
|
data/GIT-VERSION-GEN
CHANGED
data/GNUmakefile
CHANGED
@@ -1,31 +1,30 @@
|
|
1
1
|
# use GNU Make to run tests in parallel, and without depending on RubyGems
|
2
2
|
all::
|
3
|
-
RSYNC_DEST :=
|
3
|
+
RSYNC_DEST := yhbt.net:/srv/yhbt/rainbows
|
4
4
|
rfpackage := rainbows
|
5
5
|
PLACEHOLDERS := rainbows_1 Summary
|
6
6
|
|
7
|
-
|
8
|
-
|
9
|
-
|
10
|
-
|
7
|
+
Documentation/comparison.html: Documentation/comparison.haml
|
8
|
+
haml < $< >$@+ && mv $@+ $@
|
9
|
+
|
10
|
+
# only for the website
|
11
|
+
doc :: Documentation/comparison.html
|
12
|
+
doc :: man/man1/rainbows.1.html
|
11
13
|
|
12
|
-
|
13
|
-
|
14
|
-
man1_bins := $(addsuffix .1, $(base_bins))
|
15
|
-
man1_paths := $(addprefix man/man1/, $(man1_bins))
|
14
|
+
include pkg.mk
|
15
|
+
man1 := man/man1/rainbows.1
|
16
16
|
|
17
17
|
clean:
|
18
18
|
-$(MAKE) -C Documentation clean
|
19
|
+
$(RM) $(man1) $(html1)
|
19
20
|
|
20
|
-
|
21
|
-
$(MAKE) -C Documentation install-$@
|
21
|
+
pkg_extra += $(man1) lib/rainbows/version.rb
|
22
22
|
|
23
|
-
|
23
|
+
%.1.html: %.1
|
24
|
+
$(OLDDOC) man2html -o $@ $<
|
24
25
|
|
25
26
|
lib/rainbows/version.rb: GIT-VERSION-FILE
|
26
27
|
|
27
28
|
all:: test
|
28
29
|
test: lib/rainbows/version.rb
|
29
30
|
$(MAKE) -C t
|
30
|
-
|
31
|
-
.PHONY: man html
|
data/HACKING
CHANGED
@@ -13,7 +13,7 @@ Please wrap documentation at 72 characters-per-line or less (long URLs
|
|
13
13
|
are exempt) so it is comfortably readable from terminals.
|
14
14
|
|
15
15
|
When referencing mailing list posts, use
|
16
|
-
"https://
|
16
|
+
"https://yhbt.net/rainbows-public/<Message-ID>/" if possible since
|
17
17
|
the Message-ID remains searchable even if the website becomes unavailable.
|
18
18
|
|
19
19
|
== Contributing
|
@@ -38,7 +38,7 @@ distributed with git on on patch submission guidelines to follow. Just
|
|
38
38
|
don't email the git mailing list or maintainer with Rainbows! patches :)
|
39
39
|
|
40
40
|
No subscription is required to post to the mailing list at
|
41
|
-
rainbows-public@
|
41
|
+
rainbows-public@yhbt.net
|
42
42
|
|
43
43
|
Please Cc: everyone on replies, as not everyone is subscribed.
|
44
44
|
|
data/README
CHANGED
@@ -51,7 +51,7 @@ network concurrency.
|
|
51
51
|
* Designed for {Rack}[http://rack.github.io/], the standard for
|
52
52
|
modern Ruby HTTP applications.
|
53
53
|
|
54
|
-
* Built on {unicorn}[https://
|
54
|
+
* Built on {unicorn}[https://yhbt.net/unicorn/], inheriting its
|
55
55
|
process/socket management features such as transparent upgrades and
|
56
56
|
Ruby configuration DSL.
|
57
57
|
|
@@ -116,7 +116,7 @@ In APP_ROOT (where config.ru is located), run:
|
|
116
116
|
For deployments, it can use a config file for Unicorn and
|
117
117
|
\Rainbows!-specific options specified by the +--config-file/-c+
|
118
118
|
command-line switch. \Rainbows! accepts all options found in
|
119
|
-
{Unicorn::Configurator}[https://
|
119
|
+
{Unicorn::Configurator}[https://yhbt.net/unicorn/Unicorn/Configurator.html]
|
120
120
|
as well as the "\Rainbows!" block, so you can have the following in your
|
121
121
|
config file:
|
122
122
|
|
@@ -135,13 +135,13 @@ for more details.
|
|
135
135
|
You can get the latest source via git from the following locations
|
136
136
|
(these versions may not be stable):
|
137
137
|
|
138
|
-
https://
|
138
|
+
https://yhbt.net/rainbows.git
|
139
139
|
https://repo.or.cz/rainbows.git (mirror)
|
140
140
|
|
141
141
|
You may browse the code from the web and download the latest snapshot
|
142
142
|
tarballs here:
|
143
143
|
|
144
|
-
* https://
|
144
|
+
* https://yhbt.net/rainbows.git
|
145
145
|
* https://repo.or.cz/rainbows.git (gitweb)
|
146
146
|
|
147
147
|
Inline patches (from "git format-patch") to the mailing list are
|
@@ -175,8 +175,10 @@ requests) go to the mailing list. Patches must be sent inline
|
|
175
175
|
(git format-patch -M + git send-email). No subscription is necessary
|
176
176
|
to post on the mailing list. No top posting.
|
177
177
|
|
178
|
-
* email: mailto:rainbows-public@
|
179
|
-
* subscribe: mailto:rainbows-public+subscribe@
|
180
|
-
* archives: https://
|
178
|
+
* email: mailto:rainbows-public@yhbt.net
|
179
|
+
* subscribe: mailto:rainbows-public+subscribe@yhbt.net
|
180
|
+
* archives: https://yhbt.net/rainbows-public/
|
181
|
+
http://ou63pmih66umazou.onion/rainbows-public/
|
181
182
|
nntp://news.public-inbox.org/inbox.comp.lang.ruby.rainbows
|
182
|
-
nntp://
|
183
|
+
nntp://ou63pmih66umazou.onion/inbox.comp.lang.ruby.rainbows
|
184
|
+
nntp://news.gmane.io/gmane.comp.lang.ruby.rainbows.general
|
data/Sandbox
CHANGED
@@ -1,6 +1,6 @@
|
|
1
1
|
= Tips for using \Rainbows! with Sandbox installation tools
|
2
2
|
|
3
|
-
Most {tips for unicorn}[https://
|
3
|
+
Most {tips for unicorn}[https://yhbt.net/unicorn/Sandbox.html]
|
4
4
|
for Bundler and Isolate apply to \Rainbows! as well.
|
5
5
|
|
6
6
|
== TLDR (Bundler)
|
data/TUNING
CHANGED
@@ -1,6 +1,6 @@
|
|
1
1
|
= Tuning \Rainbows!
|
2
2
|
|
3
|
-
Most of the {tuning notes}[https://
|
3
|
+
Most of the {tuning notes}[https://yhbt.net/unicorn/TUNING.html]
|
4
4
|
apply to \Rainbows! as well. \Rainbows! is not particularly optimized
|
5
5
|
at the moment and is designed for applications that spend large amounts
|
6
6
|
of the time waiting on network activity. Thus memory usage and memory
|
@@ -26,7 +26,7 @@ never be the primary goal of the project.
|
|
26
26
|
the kernel.
|
27
27
|
|
28
28
|
* If your workers do not seem to be releasing memory to the OS after
|
29
|
-
traffic spikes, consider the {mall}[https://
|
29
|
+
traffic spikes, consider the {mall}[https://yhbt.net/mall/] library
|
30
30
|
which allows access to the mallopt(3) function from Ruby. As of
|
31
31
|
October 2009 tcmalloc (the default allocator for Ruby Enterprise
|
32
32
|
Edition) does not release memory back to the kernel, the best it can
|
data/archive/slrnpull.conf
CHANGED
data/examples/reverse_proxy.ru
CHANGED
data/lib/rainbows.rb
CHANGED
@@ -4,7 +4,7 @@
|
|
4
4
|
# the value passed to TCP_DEFER_ACCEPT actually matters in Linux 2.6.32+
|
5
5
|
Unicorn::SocketHelper::DEFAULTS[:tcp_defer_accept] = 60
|
6
6
|
|
7
|
-
# See https://
|
7
|
+
# See https://yhbt.net/rainbows/ for documentation
|
8
8
|
module Rainbows
|
9
9
|
# :stopdoc:
|
10
10
|
O = {}
|
@@ -1,7 +1,7 @@
|
|
1
1
|
# -*- encoding: binary -*-
|
2
2
|
|
3
3
|
# This module adds \Rainbows! to the
|
4
|
-
# {Unicorn::Configurator}[https://
|
4
|
+
# {Unicorn::Configurator}[https://yhbt.net/unicorn/Unicorn/Configurator.html]
|
5
5
|
# \Rainbows!-specific configuration options must be inside a the Rainbows!
|
6
6
|
# block, otherwise Unicorn::Configurator directives may be used anywhere
|
7
7
|
# in the file.
|
@@ -9,7 +9,7 @@
|
|
9
9
|
# Warning: The "timeout" directive in unicorn is far more dangerous
|
10
10
|
# in Rainbows!, since ALL requests running on a process will be lost
|
11
11
|
# on worker death, not just one. Instead, handle application-level
|
12
|
-
# timeouts yourself: https://
|
12
|
+
# timeouts yourself: https://yhbt.net/unicorn/Application_Timeouts.html
|
13
13
|
#
|
14
14
|
# Rainbows! do
|
15
15
|
# use :ThreadSpawn # concurrency model to use
|
data/lib/rainbows/epoll.rb
CHANGED
@@ -3,7 +3,7 @@
|
|
3
3
|
require 'sendfile'
|
4
4
|
|
5
5
|
# Edge-triggered epoll concurrency model using
|
6
|
-
# {sleepy_penguin}[https://
|
6
|
+
# {sleepy_penguin}[https://yhbt.net/sleepy_penguin/] for epoll.
|
7
7
|
#
|
8
8
|
# Unlike more portable options like Coolio and EventMachine, this
|
9
9
|
# is Linux-only, but uses edge-triggering instead of level-triggering,
|
@@ -3,7 +3,7 @@
|
|
3
3
|
require 'socket'
|
4
4
|
require 'thread'
|
5
5
|
require 'uri'
|
6
|
-
require 'kcar' # https://
|
6
|
+
require 'kcar' # https://yhbt.net/kcar/ -- gem install kcar
|
7
7
|
|
8
8
|
# This is lightly tested and has an unstable configuration interface.
|
9
9
|
# ***** Do not rely on anything under the ReverseProxy namespace! *****
|
data/pkg.mk
CHANGED
@@ -68,7 +68,7 @@ doc:: .document .olddoc.yml $(pkg_extra) $(PLACEHOLDERS)
|
|
68
68
|
-find lib -type f -name '*.rbc' -exec rm -f '{}' ';'
|
69
69
|
-find ext -type f -name '*.rbc' -exec rm -f '{}' ';'
|
70
70
|
$(RM) -r doc
|
71
|
-
$(RDOC) -f
|
71
|
+
$(RDOC) -f dark216
|
72
72
|
$(OLDDOC) merge
|
73
73
|
install -m644 COPYING doc/COPYING
|
74
74
|
install -m644 NEWS doc/NEWS
|
data/rainbows.gemspec
CHANGED
@@ -8,13 +8,13 @@
|
|
8
8
|
|
9
9
|
s.authors = ['Rainbows! hackers']
|
10
10
|
s.description = File.read('README').split("\n\n")[1]
|
11
|
-
s.email = %q{rainbows-public@
|
11
|
+
s.email = %q{rainbows-public@yhbt.net}
|
12
12
|
s.executables = %w(rainbows)
|
13
13
|
s.extra_rdoc_files = IO.readlines('.document').map!(&:chomp!).keep_if do |f|
|
14
14
|
File.exist?(f)
|
15
15
|
end
|
16
16
|
s.files = manifest
|
17
|
-
s.homepage = 'https://
|
17
|
+
s.homepage = 'https://yhbt.net/rainbows/'
|
18
18
|
s.summary = 'Rack app server for sleepy apps and slow clients'
|
19
19
|
|
20
20
|
# we want a newer Rack for a valid HeaderHash#each
|
@@ -59,11 +59,11 @@
|
|
59
59
|
ruby_1_8 = 'Nonstandard'
|
60
60
|
s.licenses = [ 'GPL-2.0+', ruby_1_8 ]
|
61
61
|
s.metadata = {
|
62
|
-
'bug_tracker_uri' => 'https://
|
63
|
-
'changelog_uri' => 'https://
|
64
|
-
'documentation_uri' => 'https://
|
65
|
-
'homepage_uri' => 'https://
|
66
|
-
'mailing_list_uri' => 'https://
|
67
|
-
'source_code_uri' => 'https://
|
62
|
+
'bug_tracker_uri' => 'https://yhbt.net/rainbows/#label-Contact',
|
63
|
+
'changelog_uri' => 'https://yhbt.net/rainbows/NEWS.html',
|
64
|
+
'documentation_uri' => 'https://yhbt.net/rainbows/',
|
65
|
+
'homepage_uri' => 'https://yhbt.net/rainbows/',
|
66
|
+
'mailing_list_uri' => 'https://yhbt.net/rainbows-public/',
|
67
|
+
'source_code_uri' => 'https://yhbt.net/rainbows.git',
|
68
68
|
}
|
69
69
|
end
|
data/vs_Unicorn
CHANGED
@@ -82,7 +82,7 @@ unicorn code), some things are not:
|
|
82
82
|
to different worker processes, and if your listen() +:backlog+ is
|
83
83
|
overflowing: to other machines in your cluster.
|
84
84
|
|
85
|
-
* Accepts the same {signals}[https://
|
85
|
+
* Accepts the same {signals}[https://yhbt.net/unicorn/SIGNALS.html]
|
86
86
|
for process management, so you can share scripts to manage them (and
|
87
87
|
nginx, too).
|
88
88
|
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: rainbows
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 5.2.
|
4
|
+
version: 5.2.1
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Rainbows! hackers
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date:
|
11
|
+
date: 2020-01-29 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: rack
|
@@ -76,7 +76,7 @@ description: |-
|
|
76
76
|
\Rainbows! is an HTTP server for sleepy Rack applications. It is based on
|
77
77
|
unicorn, but designed to handle applications that expect long
|
78
78
|
request/response times and/or slow clients.
|
79
|
-
email: rainbows-public@
|
79
|
+
email: rainbows-public@yhbt.net
|
80
80
|
executables:
|
81
81
|
- rainbows
|
82
82
|
extensions: []
|
@@ -138,9 +138,7 @@ files:
|
|
138
138
|
- COPYING
|
139
139
|
- DEPLOY
|
140
140
|
- Documentation/.gitignore
|
141
|
-
- Documentation/GNUmakefile
|
142
141
|
- Documentation/comparison.haml
|
143
|
-
- Documentation/rainbows.1.txt
|
144
142
|
- FAQ
|
145
143
|
- GIT-VERSION-FILE
|
146
144
|
- GIT-VERSION-GEN
|
@@ -158,7 +156,6 @@ files:
|
|
158
156
|
- TUNING
|
159
157
|
- Test_Suite
|
160
158
|
- archive/.gitignore
|
161
|
-
- archive/rfmig.rb
|
162
159
|
- archive/slrnpull.conf
|
163
160
|
- bin/rainbows
|
164
161
|
- examples/reverse_proxy.ru
|
@@ -418,17 +415,17 @@ files:
|
|
418
415
|
- t/worker-follows-master-to-death.ru
|
419
416
|
- t/write-on-close.ru
|
420
417
|
- vs_Unicorn
|
421
|
-
homepage: https://
|
418
|
+
homepage: https://yhbt.net/rainbows/
|
422
419
|
licenses:
|
423
420
|
- GPL-2.0+
|
424
421
|
- Nonstandard
|
425
422
|
metadata:
|
426
|
-
bug_tracker_uri: https://
|
427
|
-
changelog_uri: https://
|
428
|
-
documentation_uri: https://
|
429
|
-
homepage_uri: https://
|
430
|
-
mailing_list_uri: https://
|
431
|
-
source_code_uri: https://
|
423
|
+
bug_tracker_uri: https://yhbt.net/rainbows/#label-Contact
|
424
|
+
changelog_uri: https://yhbt.net/rainbows/NEWS.html
|
425
|
+
documentation_uri: https://yhbt.net/rainbows/
|
426
|
+
homepage_uri: https://yhbt.net/rainbows/
|
427
|
+
mailing_list_uri: https://yhbt.net/rainbows-public/
|
428
|
+
source_code_uri: https://yhbt.net/rainbows.git
|
432
429
|
post_install_message:
|
433
430
|
rdoc_options: []
|
434
431
|
require_paths:
|
@@ -444,7 +441,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
|
|
444
441
|
- !ruby/object:Gem::Version
|
445
442
|
version: '0'
|
446
443
|
requirements: []
|
447
|
-
rubygems_version: 3.0.
|
444
|
+
rubygems_version: 3.0.2
|
448
445
|
signing_key:
|
449
446
|
specification_version: 4
|
450
447
|
summary: Rack app server for sleepy apps and slow clients
|
data/Documentation/GNUmakefile
DELETED
@@ -1,33 +0,0 @@
|
|
1
|
-
all::
|
2
|
-
|
3
|
-
PANDOC = pandoc
|
4
|
-
PANDOC_OPTS = -f markdown --email-obfuscation=none
|
5
|
-
pandoc = $(PANDOC) $(PANDOC_OPTS)
|
6
|
-
pandoc_html = $(pandoc) --toc -t html --no-wrap
|
7
|
-
|
8
|
-
man1 := $(addsuffix .1,rainbows)
|
9
|
-
html1 := $(addsuffix .html,$(man1))
|
10
|
-
|
11
|
-
all:: html man
|
12
|
-
|
13
|
-
html: $(html1)
|
14
|
-
man: $(man1)
|
15
|
-
|
16
|
-
install-html: html
|
17
|
-
mkdir -p ../doc/man1
|
18
|
-
install -m 644 $(html1) ../doc/man1
|
19
|
-
|
20
|
-
install-man: man
|
21
|
-
mkdir -p ../man/man1
|
22
|
-
install -m 644 $(man1) ../man/man1
|
23
|
-
|
24
|
-
%.1: %.1.txt
|
25
|
-
$(pandoc) -s -t man < $< > $@+ && mv $@+ $@
|
26
|
-
%.1.html: %.1.txt
|
27
|
-
$(pandoc_html) < $< > $@+ && mv $@+ $@
|
28
|
-
|
29
|
-
comparison.html: comparison.haml
|
30
|
-
haml -t ugly < $< > $@+ && mv $@+ $@
|
31
|
-
|
32
|
-
clean::
|
33
|
-
$(RM) $(man1) $(html1) comparison.html
|
@@ -1,161 +0,0 @@
|
|
1
|
-
% rainbows(1) Rainbows! User Manual
|
2
|
-
% Rainbows! Hackers <rainbows-public@bogomips.org>
|
3
|
-
% December 3, 2009
|
4
|
-
|
5
|
-
# NAME
|
6
|
-
|
7
|
-
rainbows - rackup-like command to launch Rainbows!
|
8
|
-
|
9
|
-
# SYNOPSIS
|
10
|
-
|
11
|
-
rainbows [-c CONFIG_FILE] [-E RACK_ENV] [-D] [RACKUP_FILE]
|
12
|
-
|
13
|
-
# DESCRIPTION
|
14
|
-
|
15
|
-
A rackup(1)-like command to launch Rack applications using Rainbows!.
|
16
|
-
It is expected to be started in your application root (APP_ROOT),
|
17
|
-
but the "working_directory" directive may be used in the CONFIG_FILE.
|
18
|
-
|
19
|
-
While Rainbows! takes a myriad of command-line options for
|
20
|
-
compatibility with ruby(1) and rackup(1), it is recommended to stick
|
21
|
-
to the few command-line options specified in the SYNOPSIS and use
|
22
|
-
the CONFIG_FILE as much as possible.
|
23
|
-
|
24
|
-
# RACKUP FILE
|
25
|
-
|
26
|
-
This defaults to \"config.ru\" in APP_ROOT. It should be the same
|
27
|
-
file used by rackup(1) and other Rack launchers, it uses the
|
28
|
-
*Rack::Builder* DSL.
|
29
|
-
|
30
|
-
Embedded command-line options are mostly parsed for compatibility
|
31
|
-
with rackup(1) but strongly discouraged.
|
32
|
-
|
33
|
-
# UNICORN OPTIONS
|
34
|
-
-c, \--config-file CONFIG_FILE
|
35
|
-
: Path to the Unicorn-specific config file. The config file is
|
36
|
-
implemented as a Ruby DSL, so Ruby code may executed.
|
37
|
-
See the RDoc/ri for the *Unicorn::Configurator* class for the full
|
38
|
-
list of directives available from the DSL.
|
39
|
-
|
40
|
-
-D, \--daemonize
|
41
|
-
: Run daemonized in the background. The process is detached from
|
42
|
-
the controlling terminal and stdin is redirected to "/dev/null".
|
43
|
-
Unlike many common UNIX daemons, we do not chdir to \"/\"
|
44
|
-
upon daemonization to allow more control over the startup/upgrade
|
45
|
-
process.
|
46
|
-
Unless specified in the CONFIG_FILE, stderr and stdout will
|
47
|
-
also be redirected to "/dev/null".
|
48
|
-
|
49
|
-
-E, \--env RACK_ENV
|
50
|
-
: Run under the given RACK_ENV. See the RACK ENVIRONMENT section
|
51
|
-
for more details.
|
52
|
-
|
53
|
-
-l, \--listen ADDRESS
|
54
|
-
: Listens on a given ADDRESS. ADDRESS may be in the form of
|
55
|
-
HOST:PORT or PATH, HOST:PORT is taken to mean a TCP socket
|
56
|
-
and PATH is meant to be a path to a UNIX domain socket.
|
57
|
-
Defaults to "0.0.0.0:8080" (all addresses on TCP port 8080)
|
58
|
-
For production deployments, specifying the "listen" directive in
|
59
|
-
CONFIG_FILE is recommended as it allows fine-tuning of socket
|
60
|
-
options.
|
61
|
-
-N, \--no-default-middleware
|
62
|
-
: Disables loading middleware implied by RACK_ENV. This bypasses the
|
63
|
-
configuration documented in the RACK ENVIRONMENT section, but still
|
64
|
-
allows RACK_ENV to be used for application/framework-specific purposes.
|
65
|
-
|
66
|
-
# RACKUP COMPATIBILITY OPTIONS
|
67
|
-
-o, \--host HOST
|
68
|
-
: Listen on a TCP socket belonging to HOST, default is
|
69
|
-
"0.0.0.0" (all addresses).
|
70
|
-
If specified multiple times on the command-line, only the
|
71
|
-
last-specified value takes effect.
|
72
|
-
This option only exists for compatibility with the rackup(1) command,
|
73
|
-
use of "-l"/"\--listen" switch is recommended instead.
|
74
|
-
|
75
|
-
-p, \--port PORT
|
76
|
-
: Listen on the specified TCP PORT, default is 8080.
|
77
|
-
If specified multiple times on the command-line, only the last-specified
|
78
|
-
value takes effect.
|
79
|
-
This option only exists for compatibility with the rackup(1) command,
|
80
|
-
use of "-l"/"\--listen" switch is recommended instead.
|
81
|
-
|
82
|
-
-s, \--server SERVER
|
83
|
-
: No-op, this exists only for compatibility with rackup(1).
|
84
|
-
|
85
|
-
# RUBY OPTIONS
|
86
|
-
-e, \--eval LINE
|
87
|
-
: Evaluate a LINE of Ruby code. This evaluation happens
|
88
|
-
immediately as the command-line is being parsed.
|
89
|
-
|
90
|
-
-d, \--debug
|
91
|
-
: Turn on debug mode, the $DEBUG variable is set to true.
|
92
|
-
|
93
|
-
-w, \--warn
|
94
|
-
: Turn on verbose warnings, the $VERBOSE variable is set to true.
|
95
|
-
|
96
|
-
-I, \--include PATH
|
97
|
-
: specify $LOAD_PATH. PATH will be prepended to $LOAD_PATH.
|
98
|
-
The \':\' character may be used to delimit multiple directories.
|
99
|
-
This directive may be used more than once. Modifications to
|
100
|
-
$LOAD_PATH take place immediately and in the order they were
|
101
|
-
specified on the command-line.
|
102
|
-
|
103
|
-
-r, \--require LIBRARY
|
104
|
-
: require a specified LIBRARY before executing the application. The
|
105
|
-
\"require\" statement will be executed immediately and in the order
|
106
|
-
they were specified on the command-line.
|
107
|
-
|
108
|
-
# SIGNALS
|
109
|
-
|
110
|
-
The following UNIX signals may be sent to the master process:
|
111
|
-
|
112
|
-
* HUP - reload config file, app, and gracefully restart all workers
|
113
|
-
* INT/TERM - quick shutdown, kills all workers immediately
|
114
|
-
* QUIT - graceful shutdown, waits for workers to finish their
|
115
|
-
current request before finishing.
|
116
|
-
* USR1 - reopen all logs owned by the master and all workers
|
117
|
-
See Unicorn::Util.reopen_logs for what is considered a log.
|
118
|
-
* USR2 - reexecute the running binary. A separate QUIT
|
119
|
-
should be sent to the original process once the child is verified to
|
120
|
-
be up and running.
|
121
|
-
* WINCH - gracefully stops workers but keep the master running.
|
122
|
-
This will only work for daemonized processes.
|
123
|
-
* TTIN - increment the number of worker processes by one
|
124
|
-
* TTOU - decrement the number of worker processes by one
|
125
|
-
|
126
|
-
See the [SIGNALS][4] document for full description of all signals
|
127
|
-
used by Rainbows!.
|
128
|
-
|
129
|
-
# RACK ENVIRONMENT
|
130
|
-
|
131
|
-
Accepted values of RACK_ENV and the middleware they automatically load
|
132
|
-
(outside of RACKUP_FILE) are exactly as those in rackup(1):
|
133
|
-
|
134
|
-
* development - loads Rack::CommonLogger, Rack::ShowExceptions, and
|
135
|
-
Rack::Lint middleware
|
136
|
-
* deployment - loads Rack::CommonLogger middleware
|
137
|
-
* none - loads no middleware at all, relying
|
138
|
-
entirely on RACKUP_FILE
|
139
|
-
|
140
|
-
All unrecognized values for RACK_ENV are assumed to be
|
141
|
-
"none". Production deployments are strongly encouraged to use
|
142
|
-
"deployment" or "none" for maximum performance.
|
143
|
-
|
144
|
-
Note the Rack::ContentLength and Rack::Chunked middlewares are also
|
145
|
-
loaded by "deployment" and "development", but no other values of
|
146
|
-
RACK_ENV. If needed, they must be individually specified in the
|
147
|
-
RACKUP_FILE, some frameworks do not require them.
|
148
|
-
|
149
|
-
# SEE ALSO
|
150
|
-
|
151
|
-
* unicorn(1)
|
152
|
-
* *Rack::Builder* ri/RDoc
|
153
|
-
* *Unicorn::Configurator* ri/RDoc
|
154
|
-
* [Rainbows! RDoc][1]
|
155
|
-
* [Rack RDoc][2]
|
156
|
-
* [Rackup HowTo][3]
|
157
|
-
|
158
|
-
[1]: https://bogomips.org/rainbows/
|
159
|
-
[2]: http://rdoc.info/gems/r#/gems/rack/frames
|
160
|
-
[3]: http://wiki.github.com/rack/rack/tutorial-rackup-howto
|
161
|
-
[4]: https://bogomips.org/rainbows/SIGNALS.html
|
data/archive/rfmig.rb
DELETED
@@ -1,32 +0,0 @@
|
|
1
|
-
#!/usr/bin/env ruby
|
2
|
-
require 'find'
|
3
|
-
require 'fileutils'
|
4
|
-
rfdir = 'rubyforge.org:/var/www/gforge-projects/rainbows/'
|
5
|
-
newbase = 'https://bogomips.org/rainbows/'
|
6
|
-
refresh = '<meta http-equiv="refresh" content="0; url=%s" />'
|
7
|
-
old = 'rf.old'
|
8
|
-
new = 'rf.new'
|
9
|
-
cmd = %W(rsync -av #{rfdir} #{old}/)
|
10
|
-
unless File.directory?(old)
|
11
|
-
system(*cmd) or abort "#{cmd.inspect} failed: #$?"
|
12
|
-
end
|
13
|
-
|
14
|
-
Find.find(old) do |path|
|
15
|
-
path =~ /\.html\z/ or next
|
16
|
-
data = File.read(path)
|
17
|
-
tmp = path.split(%r{/})
|
18
|
-
tmp.shift == old or abort "BUG"
|
19
|
-
dst = "#{new}/#{tmp.join('/')}"
|
20
|
-
|
21
|
-
tmp[-1] = '' if tmp[-1] == "index.html"
|
22
|
-
url = "#{newbase}#{tmp.join('/')}"
|
23
|
-
meta = sprintf(refresh, url)
|
24
|
-
data.sub!(/(<head[^>]*>)/i, "#$1#{meta}")
|
25
|
-
data.sub!(/(<body[^>]*>)/i,
|
26
|
-
"#{$1}Redirecting to <a href=\"#{url}\">#{url}</a> ...<br/>")
|
27
|
-
FileUtils.mkdir_p(File.dirname(dst))
|
28
|
-
File.open(dst, "w") { |fp| fp.write(data) }
|
29
|
-
end
|
30
|
-
|
31
|
-
print "Verify results in #{new}/, then run:\n "
|
32
|
-
puts %W(rsync -av #{new}/ #{rfdir}).join(' ')
|