puma 3.12.0 → 5.6.8
Sign up to get free protection for your applications and to get access to all the features.
Potentially problematic release.
This version of puma might be problematic. Click here for more details.
- checksums.yaml +4 -4
- data/History.md +1620 -439
- data/LICENSE +23 -20
- data/README.md +175 -63
- data/bin/puma-wild +3 -9
- data/docs/architecture.md +59 -21
- data/docs/compile_options.md +21 -0
- data/docs/deployment.md +69 -58
- data/docs/fork_worker.md +33 -0
- data/docs/jungle/README.md +9 -0
- data/{tools → docs}/jungle/rc.d/README.md +1 -1
- data/{tools → docs}/jungle/rc.d/puma +2 -2
- data/docs/kubernetes.md +66 -0
- data/docs/nginx.md +1 -1
- data/docs/plugins.md +22 -12
- data/docs/rails_dev_mode.md +28 -0
- data/docs/restart.md +47 -22
- data/docs/signals.md +13 -11
- data/docs/stats.md +142 -0
- data/docs/systemd.md +95 -120
- data/ext/puma_http11/PumaHttp11Service.java +2 -2
- data/ext/puma_http11/ext_help.h +1 -1
- data/ext/puma_http11/extconf.rb +57 -2
- data/ext/puma_http11/http11_parser.c +105 -117
- data/ext/puma_http11/http11_parser.h +1 -1
- data/ext/puma_http11/http11_parser.java.rl +22 -38
- data/ext/puma_http11/http11_parser.rl +4 -2
- data/ext/puma_http11/http11_parser_common.rl +4 -4
- data/ext/puma_http11/mini_ssl.c +347 -94
- data/ext/puma_http11/no_ssl/PumaHttp11Service.java +15 -0
- data/ext/puma_http11/org/jruby/puma/Http11.java +108 -116
- data/ext/puma_http11/org/jruby/puma/Http11Parser.java +84 -99
- data/ext/puma_http11/org/jruby/puma/MiniSSL.java +124 -71
- data/ext/puma_http11/puma_http11.c +35 -51
- data/lib/puma/app/status.rb +71 -49
- data/lib/puma/binder.rb +241 -143
- data/lib/puma/cli.rb +30 -18
- data/lib/puma/client.rb +379 -229
- data/lib/puma/cluster/worker.rb +173 -0
- data/lib/puma/cluster/worker_handle.rb +94 -0
- data/lib/puma/cluster.rb +249 -232
- data/lib/puma/commonlogger.rb +4 -2
- data/lib/puma/configuration.rb +63 -51
- data/lib/puma/const.rb +44 -21
- data/lib/puma/control_cli.rb +123 -73
- data/lib/puma/detect.rb +31 -2
- data/lib/puma/dsl.rb +631 -125
- data/lib/puma/error_logger.rb +104 -0
- data/lib/puma/events.rb +57 -31
- data/lib/puma/io_buffer.rb +9 -5
- data/lib/puma/jruby_restart.rb +2 -58
- data/lib/puma/json_serialization.rb +96 -0
- data/lib/puma/launcher.rb +196 -70
- data/lib/puma/minissl/context_builder.rb +81 -0
- data/lib/puma/minissl.rb +172 -65
- data/lib/puma/null_io.rb +20 -1
- data/lib/puma/plugin/tmp_restart.rb +2 -0
- data/lib/puma/plugin.rb +9 -13
- data/lib/puma/queue_close.rb +26 -0
- data/lib/puma/rack/builder.rb +5 -6
- data/lib/puma/rack/urlmap.rb +2 -0
- data/lib/puma/rack_default.rb +2 -0
- data/lib/puma/reactor.rb +87 -316
- data/lib/puma/request.rb +476 -0
- data/lib/puma/runner.rb +50 -55
- data/lib/puma/server.rb +307 -695
- data/lib/puma/single.rb +13 -67
- data/lib/puma/state_file.rb +49 -7
- data/lib/puma/systemd.rb +46 -0
- data/lib/puma/thread_pool.rb +134 -82
- data/lib/puma/util.rb +34 -10
- data/lib/puma.rb +56 -0
- data/lib/rack/handler/puma.rb +8 -6
- data/lib/rack/version_restriction.rb +15 -0
- data/tools/Dockerfile +16 -0
- data/tools/trickletest.rb +0 -1
- metadata +49 -32
- data/ext/puma_http11/io_buffer.c +0 -155
- data/lib/puma/accept_nonblock.rb +0 -23
- data/lib/puma/compat.rb +0 -14
- data/lib/puma/convenient.rb +0 -23
- data/lib/puma/daemon_ext.rb +0 -31
- data/lib/puma/delegation.rb +0 -11
- data/lib/puma/java_io_buffer.rb +0 -45
- data/lib/puma/rack/backports/uri/common_193.rb +0 -33
- data/lib/puma/tcp_logger.rb +0 -39
- data/tools/jungle/README.md +0 -19
- data/tools/jungle/init.d/README.md +0 -61
- data/tools/jungle/init.d/puma +0 -421
- data/tools/jungle/init.d/run-puma +0 -18
- data/tools/jungle/upstart/README.md +0 -61
- data/tools/jungle/upstart/puma-manager.conf +0 -31
- data/tools/jungle/upstart/puma.conf +0 -69
- /data/{tools → docs}/jungle/rc.d/puma.conf +0 -0
data/lib/puma/java_io_buffer.rb
DELETED
@@ -1,45 +0,0 @@
|
|
1
|
-
require 'java'
|
2
|
-
|
3
|
-
# Conservative native JRuby/Java implementation of IOBuffer
|
4
|
-
# backed by a ByteArrayOutputStream and conversion between
|
5
|
-
# Ruby String and Java bytes
|
6
|
-
module Puma
|
7
|
-
class JavaIOBuffer < java.io.ByteArrayOutputStream
|
8
|
-
field_reader :buf
|
9
|
-
end
|
10
|
-
|
11
|
-
class IOBuffer
|
12
|
-
BUF_DEFAULT_SIZE = 4096
|
13
|
-
|
14
|
-
def initialize
|
15
|
-
@buf = JavaIOBuffer.new(BUF_DEFAULT_SIZE)
|
16
|
-
end
|
17
|
-
|
18
|
-
def reset
|
19
|
-
@buf.reset
|
20
|
-
end
|
21
|
-
|
22
|
-
def <<(str)
|
23
|
-
bytes = str.to_java_bytes
|
24
|
-
@buf.write(bytes, 0, bytes.length)
|
25
|
-
end
|
26
|
-
|
27
|
-
def append(*strs)
|
28
|
-
strs.each { |s| self << s; }
|
29
|
-
end
|
30
|
-
|
31
|
-
def to_s
|
32
|
-
String.from_java_bytes @buf.to_byte_array
|
33
|
-
end
|
34
|
-
|
35
|
-
alias_method :to_str, :to_s
|
36
|
-
|
37
|
-
def used
|
38
|
-
@buf.size
|
39
|
-
end
|
40
|
-
|
41
|
-
def capacity
|
42
|
-
@buf.buf.length
|
43
|
-
end
|
44
|
-
end
|
45
|
-
end
|
@@ -1,33 +0,0 @@
|
|
1
|
-
# :stopdoc:
|
2
|
-
|
3
|
-
require 'uri/common'
|
4
|
-
|
5
|
-
# Issue:
|
6
|
-
# http://bugs.ruby-lang.org/issues/5925
|
7
|
-
#
|
8
|
-
# Relevant commit:
|
9
|
-
# https://github.com/ruby/ruby/commit/edb7cdf1eabaff78dfa5ffedfbc2e91b29fa9ca1
|
10
|
-
|
11
|
-
|
12
|
-
module URI
|
13
|
-
begin
|
14
|
-
256.times do |i|
|
15
|
-
TBLENCWWWCOMP_[i.chr] = '%%%02X' % i
|
16
|
-
end
|
17
|
-
TBLENCWWWCOMP_[' '] = '+'
|
18
|
-
TBLENCWWWCOMP_.freeze
|
19
|
-
|
20
|
-
256.times do |i|
|
21
|
-
h, l = i>>4, i&15
|
22
|
-
TBLDECWWWCOMP_['%%%X%X' % [h, l]] = i.chr
|
23
|
-
TBLDECWWWCOMP_['%%%x%X' % [h, l]] = i.chr
|
24
|
-
TBLDECWWWCOMP_['%%%X%x' % [h, l]] = i.chr
|
25
|
-
TBLDECWWWCOMP_['%%%x%x' % [h, l]] = i.chr
|
26
|
-
end
|
27
|
-
TBLDECWWWCOMP_['+'] = ' '
|
28
|
-
TBLDECWWWCOMP_.freeze
|
29
|
-
rescue Exception
|
30
|
-
end
|
31
|
-
end
|
32
|
-
|
33
|
-
# :startdoc:
|
data/lib/puma/tcp_logger.rb
DELETED
@@ -1,39 +0,0 @@
|
|
1
|
-
module Puma
|
2
|
-
class TCPLogger
|
3
|
-
def initialize(logger, app, quiet=false)
|
4
|
-
@logger = logger
|
5
|
-
@app = app
|
6
|
-
@quiet = quiet
|
7
|
-
end
|
8
|
-
|
9
|
-
FORMAT = "%s - %s"
|
10
|
-
|
11
|
-
def log(who, str)
|
12
|
-
now = Time.now.strftime("%d/%b/%Y %H:%M:%S")
|
13
|
-
|
14
|
-
log_str = "#{now} - #{who} - #{str}"
|
15
|
-
|
16
|
-
case @logger
|
17
|
-
when IO
|
18
|
-
@logger.puts log_str
|
19
|
-
when Events
|
20
|
-
@logger.log log_str
|
21
|
-
end
|
22
|
-
end
|
23
|
-
|
24
|
-
def call(env, socket)
|
25
|
-
who = env[Const::REMOTE_ADDR]
|
26
|
-
log who, "connected" unless @quiet
|
27
|
-
|
28
|
-
env['log'] = lambda { |str| log(who, str) }
|
29
|
-
|
30
|
-
begin
|
31
|
-
@app.call env, socket
|
32
|
-
rescue Object => e
|
33
|
-
log who, "exception: #{e.message} (#{e.class})"
|
34
|
-
else
|
35
|
-
log who, "disconnected" unless @quiet
|
36
|
-
end
|
37
|
-
end
|
38
|
-
end
|
39
|
-
end
|
data/tools/jungle/README.md
DELETED
@@ -1,19 +0,0 @@
|
|
1
|
-
# Puma as a service
|
2
|
-
|
3
|
-
## Upstart
|
4
|
-
|
5
|
-
See `/tools/jungle/upstart` for Ubuntu's upstart scripts.
|
6
|
-
|
7
|
-
## Systemd
|
8
|
-
|
9
|
-
See [/docs/systemd](https://github.com/puma/puma/blob/master/docs/systemd.md).
|
10
|
-
|
11
|
-
## Init.d
|
12
|
-
|
13
|
-
Deprecatation Warning : `init.d` was replaced by `systemd` since Debian 8 and Ubuntu 16.04, you should look into [/docs/systemd](https://github.com/puma/puma/blob/master/docs/systemd.md) unless you are on an older OS.
|
14
|
-
|
15
|
-
See `/tools/jungle/init.d` for tools to use with init.d and start-stop-daemon.
|
16
|
-
|
17
|
-
## rc.d
|
18
|
-
|
19
|
-
See `/tools/jungle/rc.d` for FreeBSD's rc.d scripts
|
@@ -1,61 +0,0 @@
|
|
1
|
-
# Puma daemon service
|
2
|
-
|
3
|
-
Deprecatation Warning : `init.d` was replaced by `systemd` since Debian 8 and Ubuntu 16.04, you should look into [/docs/systemd](https://github.com/puma/puma/blob/master/docs/systemd.md) unless you are on an older OS.
|
4
|
-
|
5
|
-
Init script to manage multiple Puma servers on the same box using start-stop-daemon.
|
6
|
-
|
7
|
-
## Installation
|
8
|
-
|
9
|
-
# Copy the init script to services directory
|
10
|
-
sudo cp puma /etc/init.d
|
11
|
-
sudo chmod +x /etc/init.d/puma
|
12
|
-
|
13
|
-
# Make it start at boot time.
|
14
|
-
sudo update-rc.d -f puma defaults
|
15
|
-
|
16
|
-
# Copy the Puma runner to an accessible location
|
17
|
-
sudo cp run-puma /usr/local/bin
|
18
|
-
sudo chmod +x /usr/local/bin/run-puma
|
19
|
-
|
20
|
-
# Create an empty configuration file
|
21
|
-
sudo touch /etc/puma.conf
|
22
|
-
|
23
|
-
## Managing the jungle
|
24
|
-
|
25
|
-
Puma apps are held in /etc/puma.conf by default. It's mainly a CSV file and every line represents one app. Here's the syntax:
|
26
|
-
|
27
|
-
app-path,user,config-file-path,log-file-path,environment-variables
|
28
|
-
|
29
|
-
You can add an instance by editing the file or running the following command:
|
30
|
-
|
31
|
-
sudo /etc/init.d/puma add /path/to/app user /path/to/app/config/puma.rb /path/to/app/log/puma.log
|
32
|
-
|
33
|
-
The config and log paths, as well as the environment variables, are optional parameters and default to:
|
34
|
-
|
35
|
-
* config: /path/to/app/*config/puma.rb*
|
36
|
-
* log: /path/to/app/*log/puma.log*
|
37
|
-
* environment: (empty)
|
38
|
-
|
39
|
-
Multiple environment variables need to be separated by a semicolon, e.g.
|
40
|
-
|
41
|
-
FOO=1;BAR=2
|
42
|
-
|
43
|
-
To remove an app, simply delete the line from the config file or run:
|
44
|
-
|
45
|
-
sudo /etc/init.d/puma remove /path/to/app
|
46
|
-
|
47
|
-
The command will make sure the Puma instance stops before removing it from the jungle.
|
48
|
-
|
49
|
-
## Assumptions
|
50
|
-
|
51
|
-
* The script expects a temporary folder named /path/to/app/*tmp/puma* to exist. Create it if it's not there by default.
|
52
|
-
The pid and state files should live there and must be called: *tmp/puma/pid* and *tmp/puma/state*.
|
53
|
-
You can change those if you want but you'll have to adapt the script for it to work.
|
54
|
-
|
55
|
-
* Here's what a minimal app's config file should have:
|
56
|
-
|
57
|
-
```
|
58
|
-
pidfile "/path/to/app/tmp/puma/pid"
|
59
|
-
state_path "/path/to/app/tmp/puma/state"
|
60
|
-
activate_control_app
|
61
|
-
```
|
data/tools/jungle/init.d/puma
DELETED
@@ -1,421 +0,0 @@
|
|
1
|
-
#! /bin/sh
|
2
|
-
### BEGIN INIT INFO
|
3
|
-
# Provides: puma
|
4
|
-
# Required-Start: $remote_fs $syslog
|
5
|
-
# Required-Stop: $remote_fs $syslog
|
6
|
-
# Default-Start: 2 3 4 5
|
7
|
-
# Default-Stop: 0 1 6
|
8
|
-
# Short-Description: Puma web server
|
9
|
-
# Description: A ruby web server built for concurrency http://puma.io
|
10
|
-
# initscript to be placed in /etc/init.d.
|
11
|
-
### END INIT INFO
|
12
|
-
|
13
|
-
# Author: Darío Javier Cravero <dario@exordo.com>
|
14
|
-
#
|
15
|
-
# Do NOT "set -e"
|
16
|
-
|
17
|
-
# PATH should only include /usr/* if it runs after the mountnfs.sh script
|
18
|
-
PATH=/usr/local/bin:/usr/local/sbin/:/sbin:/usr/sbin:/bin:/usr/bin
|
19
|
-
DESC="Puma rack web server"
|
20
|
-
NAME=puma
|
21
|
-
DAEMON=$NAME
|
22
|
-
SCRIPTNAME=/etc/init.d/$NAME
|
23
|
-
CONFIG=/etc/puma.conf
|
24
|
-
JUNGLE=`cat $CONFIG`
|
25
|
-
RUNPUMA=/usr/local/bin/run-puma
|
26
|
-
USE_LOCAL_BUNDLE=0
|
27
|
-
|
28
|
-
# Load the VERBOSE setting and other rcS variables
|
29
|
-
. /lib/init/vars.sh
|
30
|
-
|
31
|
-
# Define LSB log_* functions.
|
32
|
-
# Depend on lsb-base (>= 3.0-6) to ensure that this file is present.
|
33
|
-
. /lib/lsb/init-functions
|
34
|
-
|
35
|
-
#
|
36
|
-
# Function that starts the jungle
|
37
|
-
#
|
38
|
-
do_start() {
|
39
|
-
log_daemon_msg "=> Running the jungle..."
|
40
|
-
for i in $JUNGLE; do
|
41
|
-
dir=`echo $i | cut -d , -f 1`
|
42
|
-
do_start_one $dir
|
43
|
-
done
|
44
|
-
}
|
45
|
-
|
46
|
-
do_start_one() {
|
47
|
-
PIDFILE=$1/tmp/puma/pid
|
48
|
-
if [ -e $PIDFILE ]; then
|
49
|
-
PID=`cat $PIDFILE`
|
50
|
-
# If the puma isn't running, run it, otherwise restart it.
|
51
|
-
if ps -p $PID > /dev/null; then
|
52
|
-
do_start_one_do $1
|
53
|
-
else
|
54
|
-
do_restart_one $1
|
55
|
-
fi
|
56
|
-
else
|
57
|
-
do_start_one_do $1
|
58
|
-
fi
|
59
|
-
}
|
60
|
-
|
61
|
-
do_start_one_do() {
|
62
|
-
i=`grep $1 $CONFIG`
|
63
|
-
dir=`echo $i | cut -d , -f 1`
|
64
|
-
user=`echo $i | cut -d , -f 2`
|
65
|
-
config_file=`echo $i | cut -d , -f 3`
|
66
|
-
if [ "$config_file" = "" ]; then
|
67
|
-
config_file="$dir/config/puma.rb"
|
68
|
-
fi
|
69
|
-
log_file=`echo $i | cut -d , -f 4`
|
70
|
-
if [ "$log_file" = "" ]; then
|
71
|
-
log_file="$dir/log/puma.log"
|
72
|
-
fi
|
73
|
-
environment=`echo $i | cut -d , -f 5`
|
74
|
-
|
75
|
-
log_daemon_msg "--> Woke up puma $dir"
|
76
|
-
log_daemon_msg "user $user"
|
77
|
-
log_daemon_msg "log to $log_file"
|
78
|
-
|
79
|
-
if [ ! -z "$environment" ]; then
|
80
|
-
for e in $(echo "$environment" | tr ';' '\n'); do
|
81
|
-
log_daemon_msg "environment $e"
|
82
|
-
v=${e%%\=*} ; eval "$e" ; export $v
|
83
|
-
done
|
84
|
-
fi
|
85
|
-
|
86
|
-
start-stop-daemon --verbose --start --chdir $dir --chuid $user --background --exec $RUNPUMA -- $dir $config_file $log_file
|
87
|
-
}
|
88
|
-
|
89
|
-
#
|
90
|
-
# Function that stops the jungle
|
91
|
-
#
|
92
|
-
do_stop() {
|
93
|
-
log_daemon_msg "=> Putting all the beasts to bed..."
|
94
|
-
for i in $JUNGLE; do
|
95
|
-
dir=`echo $i | cut -d , -f 1`
|
96
|
-
do_stop_one $dir
|
97
|
-
done
|
98
|
-
}
|
99
|
-
#
|
100
|
-
# Function that stops the daemon/service
|
101
|
-
#
|
102
|
-
do_stop_one() {
|
103
|
-
log_daemon_msg "--> Stopping $1"
|
104
|
-
PIDFILE=$1/tmp/puma/pid
|
105
|
-
STATEFILE=$1/tmp/puma/state
|
106
|
-
if [ -e $PIDFILE ]; then
|
107
|
-
PID=`cat $PIDFILE`
|
108
|
-
if ps -p $PID > /dev/null; then
|
109
|
-
log_daemon_msg "---> Puma $1 isn't running."
|
110
|
-
else
|
111
|
-
log_daemon_msg "---> About to kill PID `cat $PIDFILE`"
|
112
|
-
if [ "$USE_LOCAL_BUNDLE" -eq 1 ]; then
|
113
|
-
cd $1 && bundle exec pumactl --state $STATEFILE stop
|
114
|
-
else
|
115
|
-
pumactl --state $STATEFILE stop
|
116
|
-
fi
|
117
|
-
# Many daemons don't delete their pidfiles when they exit.
|
118
|
-
rm -f $PIDFILE $STATEFILE
|
119
|
-
fi
|
120
|
-
else
|
121
|
-
log_daemon_msg "---> No puma here..."
|
122
|
-
fi
|
123
|
-
return 0
|
124
|
-
}
|
125
|
-
|
126
|
-
#
|
127
|
-
# Function that restarts the jungle
|
128
|
-
#
|
129
|
-
do_restart() {
|
130
|
-
for i in $JUNGLE; do
|
131
|
-
dir=`echo $i | cut -d , -f 1`
|
132
|
-
do_restart_one $dir
|
133
|
-
done
|
134
|
-
}
|
135
|
-
|
136
|
-
#
|
137
|
-
# Function that sends a SIGUSR2 to the daemon/service
|
138
|
-
#
|
139
|
-
do_restart_one() {
|
140
|
-
PIDFILE=$1/tmp/puma/pid
|
141
|
-
|
142
|
-
if [ -e $PIDFILE ]; then
|
143
|
-
log_daemon_msg "--> About to restart puma $1"
|
144
|
-
kill -s USR2 `cat $PIDFILE`
|
145
|
-
# TODO Check if process exist
|
146
|
-
else
|
147
|
-
log_daemon_msg "--> Your puma was never playing... Let's get it out there first"
|
148
|
-
do_start_one $1
|
149
|
-
fi
|
150
|
-
return 0
|
151
|
-
}
|
152
|
-
|
153
|
-
#
|
154
|
-
# Function that phased restarts the jungle
|
155
|
-
#
|
156
|
-
do_phased_restart() {
|
157
|
-
for i in $JUNGLE; do
|
158
|
-
dir=`echo $i | cut -d , -f 1`
|
159
|
-
do_phased_restart_one $dir
|
160
|
-
done
|
161
|
-
}
|
162
|
-
|
163
|
-
#
|
164
|
-
# Function that sends a SIGUSR1 to the daemon/service
|
165
|
-
#
|
166
|
-
do_phased_restart_one() {
|
167
|
-
PIDFILE=$1/tmp/puma/pid
|
168
|
-
|
169
|
-
if [ -e $PIDFILE ]; then
|
170
|
-
log_daemon_msg "--> About to restart puma $1"
|
171
|
-
kill -s USR1 `cat $PIDFILE`
|
172
|
-
# TODO Check if process exist
|
173
|
-
else
|
174
|
-
log_daemon_msg "--> Your puma was never playing... Let's get it out there first"
|
175
|
-
do_start_one $1
|
176
|
-
fi
|
177
|
-
return 0
|
178
|
-
}
|
179
|
-
|
180
|
-
#
|
181
|
-
# Function that statuss the jungle
|
182
|
-
#
|
183
|
-
do_status() {
|
184
|
-
for i in $JUNGLE; do
|
185
|
-
dir=`echo $i | cut -d , -f 1`
|
186
|
-
do_status_one $dir
|
187
|
-
done
|
188
|
-
}
|
189
|
-
|
190
|
-
#
|
191
|
-
# Function that sends a SIGUSR2 to the daemon/service
|
192
|
-
#
|
193
|
-
do_status_one() {
|
194
|
-
PIDFILE=$1/tmp/puma/pid
|
195
|
-
i=`grep $1 $CONFIG`
|
196
|
-
dir=`echo $i | cut -d , -f 1`
|
197
|
-
|
198
|
-
if [ -e $PIDFILE ]; then
|
199
|
-
log_daemon_msg "--> About to status puma $1"
|
200
|
-
if [ "$USE_LOCAL_BUNDLE" -eq 1 ]; then
|
201
|
-
cd $1 && bundle exec pumactl --state $dir/tmp/puma/state stats
|
202
|
-
else
|
203
|
-
pumactl --state $dir/tmp/puma/state stats
|
204
|
-
fi
|
205
|
-
# kill -s USR2 `cat $PIDFILE`
|
206
|
-
# TODO Check if process exist
|
207
|
-
else
|
208
|
-
log_daemon_msg "--> $1 isn't there :(..."
|
209
|
-
fi
|
210
|
-
return 0
|
211
|
-
}
|
212
|
-
|
213
|
-
do_add() {
|
214
|
-
str=""
|
215
|
-
# App's directory
|
216
|
-
if [ -d "$1" ]; then
|
217
|
-
if [ "`grep -c "^$1" $CONFIG`" -eq 0 ]; then
|
218
|
-
str=$1
|
219
|
-
else
|
220
|
-
echo "The app is already being managed. Remove it if you want to update its config."
|
221
|
-
exit 1
|
222
|
-
fi
|
223
|
-
else
|
224
|
-
echo "The directory $1 doesn't exist."
|
225
|
-
exit 1
|
226
|
-
fi
|
227
|
-
# User to run it as
|
228
|
-
if [ "`grep -c "^$2:" /etc/passwd`" -eq 0 ]; then
|
229
|
-
echo "The user $2 doesn't exist."
|
230
|
-
exit 1
|
231
|
-
else
|
232
|
-
str="$str,$2"
|
233
|
-
fi
|
234
|
-
# Config file
|
235
|
-
if [ "$3" != "" ]; then
|
236
|
-
if [ -e $3 ]; then
|
237
|
-
str="$str,$3"
|
238
|
-
else
|
239
|
-
echo "The config file $3 doesn't exist."
|
240
|
-
exit 1
|
241
|
-
fi
|
242
|
-
fi
|
243
|
-
# Log file
|
244
|
-
if [ "$4" != "" ]; then
|
245
|
-
str="$str,$4"
|
246
|
-
fi
|
247
|
-
|
248
|
-
# Environment variables
|
249
|
-
if [ "$5" != "" ]; then
|
250
|
-
str="$str,$5"
|
251
|
-
fi
|
252
|
-
|
253
|
-
# Add it to the jungle
|
254
|
-
echo $str >> $CONFIG
|
255
|
-
log_daemon_msg "Added a Puma to the jungle: $str. You still have to start it though."
|
256
|
-
}
|
257
|
-
|
258
|
-
do_remove() {
|
259
|
-
if [ "`grep -c "^$1" $CONFIG`" -eq 0 ]; then
|
260
|
-
echo "There's no app $1 to remove."
|
261
|
-
else
|
262
|
-
# Stop it first.
|
263
|
-
do_stop_one $1
|
264
|
-
# Remove it from the config.
|
265
|
-
sed -i "\\:^$1:d" $CONFIG
|
266
|
-
log_daemon_msg "Removed a Puma from the jungle: $1."
|
267
|
-
fi
|
268
|
-
}
|
269
|
-
|
270
|
-
config_bundler() {
|
271
|
-
HOME="$(eval echo ~$(id -un))"
|
272
|
-
|
273
|
-
if [ -d "$1/.rbenv/bin" ]; then
|
274
|
-
PATH="$1/.rbenv/bin:$1/.rbenv/shims:$1"
|
275
|
-
eval "$(rbenv init -)"
|
276
|
-
USE_LOCAL_BUNDLE=1
|
277
|
-
return 0
|
278
|
-
|
279
|
-
elif [ -d "/usr/local/rbenv/bin" ]; then
|
280
|
-
PATH="/usr/local/rbenv/bin:/usr/local/rbenv/shims:$PATH"
|
281
|
-
eval "$(rbenv init -)"
|
282
|
-
USE_LOCAL_BUNDLE=1
|
283
|
-
return 0
|
284
|
-
|
285
|
-
elif [ -d "$HOME/.rbenv/bin" ]; then
|
286
|
-
PATH="$HOME/.rbenv/bin:$HOME/.rbenv/shims:$PATH"
|
287
|
-
eval "$(rbenv init -)"
|
288
|
-
USE_LOCAL_BUNDLE=1
|
289
|
-
return 0
|
290
|
-
|
291
|
-
# TODO: test rvm
|
292
|
-
# elif [ -f /etc/profile.d/rvm.sh ]; then
|
293
|
-
# source /etc/profile.d/rvm.sh
|
294
|
-
# elif [ -f /usr/local/rvm/scripts/rvm ]; then
|
295
|
-
# source /etc/profile.d/rvm.sh
|
296
|
-
# elif [ -f "$HOME/.rvm/scripts/rvm" ]; then
|
297
|
-
# source "$HOME/.rvm/scripts/rvm"
|
298
|
-
# TODO: don't know what to do with chruby
|
299
|
-
# elif [ -f /usr/local/share/chruby/chruby.sh ]; then
|
300
|
-
# source /usr/local/share/chruby/chruby.sh
|
301
|
-
# if [ -f /usr/local/share/chruby/auto.sh ]; then
|
302
|
-
# source /usr/local/share/chruby/auto.sh
|
303
|
-
# fi
|
304
|
-
# if you aren't using auto, set your version here
|
305
|
-
# chruby 2.0.0
|
306
|
-
fi
|
307
|
-
|
308
|
-
return 1
|
309
|
-
}
|
310
|
-
|
311
|
-
config_bundler
|
312
|
-
|
313
|
-
case "$1" in
|
314
|
-
start)
|
315
|
-
[ "$VERBOSE" != no ] && log_daemon_msg "Starting $DESC" "$NAME"
|
316
|
-
if [ "$#" -eq 1 ]; then
|
317
|
-
do_start
|
318
|
-
else
|
319
|
-
i=`grep $2 $CONFIG`
|
320
|
-
dir=`echo $i | cut -d , -f 1`
|
321
|
-
do_start_one $dir
|
322
|
-
fi
|
323
|
-
case "$?" in
|
324
|
-
0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
|
325
|
-
2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
|
326
|
-
esac
|
327
|
-
;;
|
328
|
-
stop)
|
329
|
-
[ "$VERBOSE" != no ] && log_daemon_msg "Stopping $DESC" "$NAME"
|
330
|
-
if [ "$#" -eq 1 ]; then
|
331
|
-
do_stop
|
332
|
-
else
|
333
|
-
i=`grep $2 $CONFIG`
|
334
|
-
dir=`echo $i | cut -d , -f 1`
|
335
|
-
do_stop_one $dir
|
336
|
-
fi
|
337
|
-
case "$?" in
|
338
|
-
0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
|
339
|
-
2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
|
340
|
-
esac
|
341
|
-
;;
|
342
|
-
status)
|
343
|
-
# TODO Implement.
|
344
|
-
log_daemon_msg "Status $DESC" "$NAME"
|
345
|
-
if [ "$#" -eq 1 ]; then
|
346
|
-
do_status
|
347
|
-
else
|
348
|
-
i=`grep $2 $CONFIG`
|
349
|
-
dir=`echo $i | cut -d , -f 1`
|
350
|
-
do_status_one $dir
|
351
|
-
fi
|
352
|
-
case "$?" in
|
353
|
-
0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
|
354
|
-
2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
|
355
|
-
esac
|
356
|
-
;;
|
357
|
-
restart)
|
358
|
-
log_daemon_msg "Restarting $DESC" "$NAME"
|
359
|
-
if [ "$#" -eq 1 ]; then
|
360
|
-
do_restart
|
361
|
-
else
|
362
|
-
i=`grep $2 $CONFIG`
|
363
|
-
dir=`echo $i | cut -d , -f 1`
|
364
|
-
do_restart_one $dir
|
365
|
-
fi
|
366
|
-
case "$?" in
|
367
|
-
0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
|
368
|
-
2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
|
369
|
-
esac
|
370
|
-
;;
|
371
|
-
phased-restart)
|
372
|
-
log_daemon_msg "Restarting (phased) $DESC" "$NAME"
|
373
|
-
if [ "$#" -eq 1 ]; then
|
374
|
-
do_phased_restart
|
375
|
-
else
|
376
|
-
i=`grep $2 $CONFIG`
|
377
|
-
dir=`echo $i | cut -d , -f 1`
|
378
|
-
do_phased_restart_one $dir
|
379
|
-
fi
|
380
|
-
case "$?" in
|
381
|
-
0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
|
382
|
-
2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
|
383
|
-
esac
|
384
|
-
;;
|
385
|
-
add)
|
386
|
-
if [ "$#" -lt 3 ]; then
|
387
|
-
echo "Please, specify the app's directory and the user that will run it at least."
|
388
|
-
echo " Usage: $SCRIPTNAME add /path/to/app user /path/to/app/config/puma.rb /path/to/app/config/log/puma.log"
|
389
|
-
echo " config and log are optionals."
|
390
|
-
exit 1
|
391
|
-
else
|
392
|
-
do_add $2 $3 $4 $5
|
393
|
-
fi
|
394
|
-
case "$?" in
|
395
|
-
0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
|
396
|
-
2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
|
397
|
-
esac
|
398
|
-
;;
|
399
|
-
remove)
|
400
|
-
if [ "$#" -lt 2 ]; then
|
401
|
-
echo "Please, specifiy the app's directory to remove."
|
402
|
-
exit 1
|
403
|
-
else
|
404
|
-
do_remove $2
|
405
|
-
fi
|
406
|
-
case "$?" in
|
407
|
-
0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
|
408
|
-
2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
|
409
|
-
esac
|
410
|
-
;;
|
411
|
-
*)
|
412
|
-
echo "Usage:" >&2
|
413
|
-
echo " Run the jungle: $SCRIPTNAME {start|stop|status|restart|phased-restart}" >&2
|
414
|
-
echo " Add a Puma: $SCRIPTNAME add /path/to/app user /path/to/app/config/puma.rb /path/to/app/config/log/puma.log"
|
415
|
-
echo " config and log are optionals."
|
416
|
-
echo " Remove a Puma: $SCRIPTNAME remove /path/to/app"
|
417
|
-
echo " On a Puma: $SCRIPTNAME {start|stop|status|restart|phased-restart} PUMA-NAME" >&2
|
418
|
-
exit 3
|
419
|
-
;;
|
420
|
-
esac
|
421
|
-
:
|
@@ -1,18 +0,0 @@
|
|
1
|
-
#!/bin/bash
|
2
|
-
|
3
|
-
# on system boot, and root have no rbenv installed,
|
4
|
-
# after start-stop-daemon switched to current user, we have to init rbenv
|
5
|
-
if [ -d "$HOME/.rbenv/bin" ]; then
|
6
|
-
PATH="$HOME/.rbenv/bin:$HOME/.rbenv/shims:$PATH"
|
7
|
-
eval "$(rbenv init -)"
|
8
|
-
elif [ -d "/usr/local/rbenv/bin" ]; then
|
9
|
-
PATH="/usr/local/rbenv/bin:/usr/local/rbenv/shims:$PATH"
|
10
|
-
eval "$(rbenv init -)"
|
11
|
-
elif [ -f /usr/local/rvm/scripts/rvm ]; then
|
12
|
-
source /etc/profile.d/rvm.sh
|
13
|
-
elif [ -f "$HOME/.rvm/scripts/rvm" ]; then
|
14
|
-
source "$HOME/.rvm/scripts/rvm"
|
15
|
-
fi
|
16
|
-
|
17
|
-
app=$1; config=$2; log=$3;
|
18
|
-
cd $app && exec bundle exec puma -C $config >> $log 2>&1
|
@@ -1,61 +0,0 @@
|
|
1
|
-
# Puma as a service using Upstart
|
2
|
-
|
3
|
-
Manage multiple Puma servers as services on the same box using Ubuntu upstart.
|
4
|
-
|
5
|
-
## Installation
|
6
|
-
|
7
|
-
# Copy the scripts to services directory
|
8
|
-
sudo cp puma.conf puma-manager.conf /etc/init
|
9
|
-
|
10
|
-
# Create an empty configuration file
|
11
|
-
sudo touch /etc/puma.conf
|
12
|
-
|
13
|
-
## Managing the jungle
|
14
|
-
|
15
|
-
Puma apps are referenced in /etc/puma.conf by default. Add each app's path as a new line, e.g.:
|
16
|
-
|
17
|
-
```
|
18
|
-
/home/apps/my-cool-ruby-app
|
19
|
-
/home/apps/another-app/current
|
20
|
-
```
|
21
|
-
|
22
|
-
Start the jungle running:
|
23
|
-
|
24
|
-
`sudo start puma-manager`
|
25
|
-
|
26
|
-
This script will run at boot time.
|
27
|
-
|
28
|
-
Start a single puma like this:
|
29
|
-
|
30
|
-
`sudo start puma app=/path/to/app`
|
31
|
-
|
32
|
-
## Logs
|
33
|
-
|
34
|
-
Everything is logged by upstart, defaulting to `/var/log/upstart`.
|
35
|
-
|
36
|
-
Each puma instance is named after its directory, so for an app called `/home/apps/my-app` the log file would be `/var/log/upstart/puma-_home_apps_my-app.log`.
|
37
|
-
|
38
|
-
## Conventions
|
39
|
-
|
40
|
-
* The script expects:
|
41
|
-
* a config file to exist under `config/puma.rb` in your app. E.g.: `/home/apps/my-app/config/puma.rb`.
|
42
|
-
* a temporary folder to put the PID, socket and state files to exist called `tmp/puma`. E.g.: `/home/apps/my-app/tmp/puma`. Puma will take care of the files for you.
|
43
|
-
|
44
|
-
You can always change those defaults by editing the scripts.
|
45
|
-
|
46
|
-
## Here's what a minimal app's config file should have
|
47
|
-
|
48
|
-
```
|
49
|
-
pidfile "/path/to/app/tmp/puma/pid"
|
50
|
-
state_path "/path/to/app/tmp/puma/state"
|
51
|
-
activate_control_app
|
52
|
-
```
|
53
|
-
|
54
|
-
## Before starting...
|
55
|
-
|
56
|
-
You need to customise `puma.conf` to:
|
57
|
-
|
58
|
-
* Set the right user your app should be running on unless you want root to execute it!
|
59
|
-
* Look for `setuid apps` and `setgid apps`, uncomment those lines and replace `apps` to whatever your deployment user is.
|
60
|
-
* Replace `apps` on the paths (or set the right paths to your user's home) everywhere else.
|
61
|
-
* Uncomment the source lines for `rbenv` or `rvm` support unless you use a system wide installation of Ruby.
|