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.

Files changed (94) hide show
  1. checksums.yaml +4 -4
  2. data/History.md +1620 -439
  3. data/LICENSE +23 -20
  4. data/README.md +175 -63
  5. data/bin/puma-wild +3 -9
  6. data/docs/architecture.md +59 -21
  7. data/docs/compile_options.md +21 -0
  8. data/docs/deployment.md +69 -58
  9. data/docs/fork_worker.md +33 -0
  10. data/docs/jungle/README.md +9 -0
  11. data/{tools → docs}/jungle/rc.d/README.md +1 -1
  12. data/{tools → docs}/jungle/rc.d/puma +2 -2
  13. data/docs/kubernetes.md +66 -0
  14. data/docs/nginx.md +1 -1
  15. data/docs/plugins.md +22 -12
  16. data/docs/rails_dev_mode.md +28 -0
  17. data/docs/restart.md +47 -22
  18. data/docs/signals.md +13 -11
  19. data/docs/stats.md +142 -0
  20. data/docs/systemd.md +95 -120
  21. data/ext/puma_http11/PumaHttp11Service.java +2 -2
  22. data/ext/puma_http11/ext_help.h +1 -1
  23. data/ext/puma_http11/extconf.rb +57 -2
  24. data/ext/puma_http11/http11_parser.c +105 -117
  25. data/ext/puma_http11/http11_parser.h +1 -1
  26. data/ext/puma_http11/http11_parser.java.rl +22 -38
  27. data/ext/puma_http11/http11_parser.rl +4 -2
  28. data/ext/puma_http11/http11_parser_common.rl +4 -4
  29. data/ext/puma_http11/mini_ssl.c +347 -94
  30. data/ext/puma_http11/no_ssl/PumaHttp11Service.java +15 -0
  31. data/ext/puma_http11/org/jruby/puma/Http11.java +108 -116
  32. data/ext/puma_http11/org/jruby/puma/Http11Parser.java +84 -99
  33. data/ext/puma_http11/org/jruby/puma/MiniSSL.java +124 -71
  34. data/ext/puma_http11/puma_http11.c +35 -51
  35. data/lib/puma/app/status.rb +71 -49
  36. data/lib/puma/binder.rb +241 -143
  37. data/lib/puma/cli.rb +30 -18
  38. data/lib/puma/client.rb +379 -229
  39. data/lib/puma/cluster/worker.rb +173 -0
  40. data/lib/puma/cluster/worker_handle.rb +94 -0
  41. data/lib/puma/cluster.rb +249 -232
  42. data/lib/puma/commonlogger.rb +4 -2
  43. data/lib/puma/configuration.rb +63 -51
  44. data/lib/puma/const.rb +44 -21
  45. data/lib/puma/control_cli.rb +123 -73
  46. data/lib/puma/detect.rb +31 -2
  47. data/lib/puma/dsl.rb +631 -125
  48. data/lib/puma/error_logger.rb +104 -0
  49. data/lib/puma/events.rb +57 -31
  50. data/lib/puma/io_buffer.rb +9 -5
  51. data/lib/puma/jruby_restart.rb +2 -58
  52. data/lib/puma/json_serialization.rb +96 -0
  53. data/lib/puma/launcher.rb +196 -70
  54. data/lib/puma/minissl/context_builder.rb +81 -0
  55. data/lib/puma/minissl.rb +172 -65
  56. data/lib/puma/null_io.rb +20 -1
  57. data/lib/puma/plugin/tmp_restart.rb +2 -0
  58. data/lib/puma/plugin.rb +9 -13
  59. data/lib/puma/queue_close.rb +26 -0
  60. data/lib/puma/rack/builder.rb +5 -6
  61. data/lib/puma/rack/urlmap.rb +2 -0
  62. data/lib/puma/rack_default.rb +2 -0
  63. data/lib/puma/reactor.rb +87 -316
  64. data/lib/puma/request.rb +476 -0
  65. data/lib/puma/runner.rb +50 -55
  66. data/lib/puma/server.rb +307 -695
  67. data/lib/puma/single.rb +13 -67
  68. data/lib/puma/state_file.rb +49 -7
  69. data/lib/puma/systemd.rb +46 -0
  70. data/lib/puma/thread_pool.rb +134 -82
  71. data/lib/puma/util.rb +34 -10
  72. data/lib/puma.rb +56 -0
  73. data/lib/rack/handler/puma.rb +8 -6
  74. data/lib/rack/version_restriction.rb +15 -0
  75. data/tools/Dockerfile +16 -0
  76. data/tools/trickletest.rb +0 -1
  77. metadata +49 -32
  78. data/ext/puma_http11/io_buffer.c +0 -155
  79. data/lib/puma/accept_nonblock.rb +0 -23
  80. data/lib/puma/compat.rb +0 -14
  81. data/lib/puma/convenient.rb +0 -23
  82. data/lib/puma/daemon_ext.rb +0 -31
  83. data/lib/puma/delegation.rb +0 -11
  84. data/lib/puma/java_io_buffer.rb +0 -45
  85. data/lib/puma/rack/backports/uri/common_193.rb +0 -33
  86. data/lib/puma/tcp_logger.rb +0 -39
  87. data/tools/jungle/README.md +0 -19
  88. data/tools/jungle/init.d/README.md +0 -61
  89. data/tools/jungle/init.d/puma +0 -421
  90. data/tools/jungle/init.d/run-puma +0 -18
  91. data/tools/jungle/upstart/README.md +0 -61
  92. data/tools/jungle/upstart/puma-manager.conf +0 -31
  93. data/tools/jungle/upstart/puma.conf +0 -69
  94. /data/{tools → docs}/jungle/rc.d/puma.conf +0 -0
@@ -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:
@@ -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
@@ -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
- ```
@@ -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.