puma 4.3.12 → 6.0.2

data/tools/jungle/README.md

@@ -1,19 +0,0 @@
-# Puma as a service
-
-## Upstart
-
-See `/tools/jungle/upstart` for Ubuntu's upstart scripts.
-
-## Systemd
-
-See [/docs/systemd](https://github.com/puma/puma/blob/master/docs/systemd.md).
-
-## Init.d
-
-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.
-
-See `/tools/jungle/init.d` for tools to use with init.d and start-stop-daemon.
-
-## rc.d
-
-See `/tools/jungle/rc.d` for FreeBSD's rc.d scripts

data/tools/jungle/init.d/README.md

@@ -1,61 +0,0 @@
-# Puma daemon service
-
-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. 
-
-Init script to manage multiple Puma servers on the same box using start-stop-daemon.
-
-## Installation 
-
-    # Copy the init script to services directory 
-    sudo cp puma /etc/init.d
-    sudo chmod +x /etc/init.d/puma
-    
-    # Make it start at boot time. 
-    sudo update-rc.d -f puma defaults
-
-    # Copy the Puma runner to an accessible location
-    sudo cp run-puma /usr/local/bin
-    sudo chmod +x /usr/local/bin/run-puma
-
-    # Create an empty configuration file
-    sudo touch /etc/puma.conf
-
-## Managing the jungle 
-
-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:
-
-    app-path,user,config-file-path,log-file-path,environment-variables
-
-You can add an instance by editing the file or running the following command:
-
-    sudo /etc/init.d/puma add /path/to/app user /path/to/app/config/puma.rb /path/to/app/log/puma.log
-
-The config and log paths, as well as the environment variables, are optional parameters and default to:
-
-* config: /path/to/app/*config/puma.rb*
-* log: /path/to/app/*log/puma.log*
-* environment: (empty)
-
-Multiple environment variables need to be separated by a semicolon, e.g.
-
-    FOO=1;BAR=2
-
-To remove an app, simply delete the line from the config file or run:
-
-    sudo /etc/init.d/puma remove /path/to/app
-
-The command will make sure the Puma instance stops before removing it from the jungle.
-
-## Assumptions 
-
-* The script expects a temporary folder named /path/to/app/*tmp/puma* to exist. Create it if it's not there by default.
-The pid and state files should live there and must be called: *tmp/puma/pid* and *tmp/puma/state*.
-You can change those if you want but you'll have to adapt the script for it to work.
-
-* Here's what a minimal app's config file should have:
-
-```
-pidfile "/path/to/app/tmp/puma/pid"
-state_path "/path/to/app/tmp/puma/state"
-activate_control_app
-```

data/tools/jungle/init.d/puma

@@ -1,421 +0,0 @@
-#! /bin/sh
-### BEGIN INIT INFO
-# Provides:          puma 
-# Required-Start:    $remote_fs $syslog
-# Required-Stop:     $remote_fs $syslog
-# Default-Start:     2 3 4 5
-# Default-Stop:      0 1 6
-# Short-Description: Puma web server
-# Description:       A ruby web server built for concurrency http://puma.io
-#                    initscript to be placed in /etc/init.d.
-### END INIT INFO
-
-# Author: Darío Javier Cravero <dario@exordo.com>
-#
-# Do NOT "set -e"
-
-# PATH should only include /usr/* if it runs after the mountnfs.sh script
-PATH=/usr/local/bin:/usr/local/sbin/:/sbin:/usr/sbin:/bin:/usr/bin
-DESC="Puma rack web server"
-NAME=puma
-DAEMON=$NAME
-SCRIPTNAME=/etc/init.d/$NAME
-CONFIG=/etc/puma.conf
-JUNGLE=`cat $CONFIG`
-RUNPUMA=/usr/local/bin/run-puma
-USE_LOCAL_BUNDLE=0
-
-# Load the VERBOSE setting and other rcS variables
-. /lib/init/vars.sh
-
-# Define LSB log_* functions.
-# Depend on lsb-base (>= 3.0-6) to ensure that this file is present.
-. /lib/lsb/init-functions
-
-#
-# Function that starts the jungle 
-#
-do_start() {
-  log_daemon_msg "=> Running the jungle..."
-  for i in $JUNGLE; do
-    dir=`echo $i | cut -d , -f 1`
-    do_start_one $dir
-  done
-}
-
-do_start_one() {
-  PIDFILE=$1/tmp/puma/pid
-  if [ -e $PIDFILE ]; then
-    PID=`cat $PIDFILE`
-    # If the puma is running, restart it, otherwise run it.
-    if ps -p $PID > /dev/null; then
-      do_restart_one $1
-    else
-      do_start_one_do $1
-    fi
-  else
-    do_start_one_do $1
-  fi
-}
-
-do_start_one_do() {
-  i=`grep $1 $CONFIG`
-  dir=`echo $i | cut -d , -f 1`
-  user=`echo $i | cut -d , -f 2`
-  config_file=`echo $i | cut -d , -f 3`
-  if [ "$config_file" = "" ]; then
-    config_file="$dir/config/puma.rb"
-  fi
-  log_file=`echo $i | cut -d , -f 4`
-  if [ "$log_file" = "" ]; then
-    log_file="$dir/log/puma.log"
-  fi
-  environment=`echo $i | cut -d , -f 5`
-
-  log_daemon_msg "--> Woke up puma $dir"
-  log_daemon_msg "user $user"
-  log_daemon_msg "log to $log_file"
-
-  if [ ! -z "$environment" ]; then
-    for e in $(echo "$environment" | tr ';' '\n'); do
-        log_daemon_msg "environment $e"
-        v=${e%%\=*} ;  eval "$e" ; export $v
-    done
-  fi
-
-  start-stop-daemon --verbose --start --chdir $dir --chuid $user --background --exec $RUNPUMA -- $dir $config_file $log_file
-}
-
-#
-# Function that stops the jungle
-#
-do_stop() {
-  log_daemon_msg "=> Putting all the beasts to bed..."
-  for i in $JUNGLE; do
-    dir=`echo $i | cut -d , -f 1`
-    do_stop_one $dir
-  done
-}
-#
-# Function that stops the daemon/service
-#
-do_stop_one() {
-  log_daemon_msg "--> Stopping $1"
-  PIDFILE=$1/tmp/puma/pid
-  STATEFILE=$1/tmp/puma/state
-  if [ -e $PIDFILE ]; then
-    PID=`cat $PIDFILE`
-    if ps -p $PID > /dev/null; then
-      log_daemon_msg "---> About to kill PID `cat $PIDFILE`"
-      if [ "$USE_LOCAL_BUNDLE" -eq 1 ]; then
-        cd $1 && bundle exec pumactl --state $STATEFILE stop
-      else
-        pumactl --state $STATEFILE stop
-      fi
-      # Many daemons don't delete their pidfiles when they exit.
-      rm -f $PIDFILE $STATEFILE
-    else
-      log_daemon_msg "---> Puma $1 isn't running."
-    fi
-  else
-    log_daemon_msg "---> No puma here..."
-  fi
-  return 0
-}
-
-#
-# Function that restarts the jungle 
-#
-do_restart() {
-  for i in $JUNGLE; do
-    dir=`echo $i | cut -d , -f 1`
-    do_restart_one $dir
-  done
-}
-
-#
-# Function that sends a SIGUSR2 to the daemon/service
-#
-do_restart_one() {
-  PIDFILE=$1/tmp/puma/pid
-
-  if [ -e $PIDFILE ]; then
-    log_daemon_msg "--> About to restart puma $1"
-    kill -s USR2 `cat $PIDFILE`
-    # TODO Check if process exist
-  else
-    log_daemon_msg "--> Your puma was never playing... Let's get it out there first"
-    do_start_one $1
-  fi
-	return 0
-}
-
-#
-# Function that phased restarts the jungle
-#
-do_phased_restart() {
-  for i in $JUNGLE; do
-    dir=`echo $i | cut -d , -f 1`
-    do_phased_restart_one $dir
-  done
-}
-
-#
-# Function that sends a SIGUSR1 to the daemon/service
-#
-do_phased_restart_one() {
-  PIDFILE=$1/tmp/puma/pid
-
-  if [ -e $PIDFILE ]; then
-    log_daemon_msg "--> About to restart puma $1"
-    kill -s USR1 `cat $PIDFILE`
-    # TODO Check if process exist
-  else
-    log_daemon_msg "--> Your puma was never playing... Let's get it out there first"
-    do_start_one $1
-  fi
-	return 0
-}
-
-#
-# Function that statuss the jungle 
-#
-do_status() {
-  for i in $JUNGLE; do
-    dir=`echo $i | cut -d , -f 1`
-    do_status_one $dir
-  done
-}
-
-#
-# Function that sends a SIGUSR2 to the daemon/service
-#
-do_status_one() {
-  PIDFILE=$1/tmp/puma/pid
-  i=`grep $1 $CONFIG`
-  dir=`echo $i | cut -d , -f 1`
-  
-  if [ -e $PIDFILE ]; then
-    log_daemon_msg "--> About to status puma $1"
-    if [ "$USE_LOCAL_BUNDLE" -eq 1 ]; then
-      cd $1 && bundle exec pumactl --state $dir/tmp/puma/state stats
-    else
-      pumactl --state $dir/tmp/puma/state stats
-    fi
-    # kill -s USR2 `cat $PIDFILE`
-    # TODO Check if process exist
-  else
-    log_daemon_msg "--> $1 isn't there :(..." 
-  fi
-	return 0
-}
-
-do_add() {
-  str=""
-  # App's directory
-  if [ -d "$1" ]; then
-    if [ "`grep -c "^$1" $CONFIG`" -eq 0 ]; then
-      str=$1
-    else
-      echo "The app is already being managed. Remove it if you want to update its config."
-      exit 1 
-    fi
-  else
-    echo "The directory $1 doesn't exist."
-    exit 1
-  fi
-  # User to run it as
-  if [ "`grep -c "^$2:" /etc/passwd`" -eq 0 ]; then
-    echo "The user $2 doesn't exist."
-    exit 1
-  else
-    str="$str,$2"
-  fi
-  # Config file
-  if [ "$3" != "" ]; then
-    if [ -e $3 ]; then
-      str="$str,$3"
-    else
-      echo "The config file $3 doesn't exist."
-      exit 1
-    fi
-  fi
-  # Log file
-  if [ "$4" != "" ]; then
-    str="$str,$4"
-  fi
-
-  # Environment variables
-  if [ "$5" != "" ]; then
-    str="$str,$5"
-  fi
-
-  # Add it to the jungle 
-  echo $str >> $CONFIG
-  log_daemon_msg "Added a Puma to the jungle: $str. You still have to start it though."
-}
-
-do_remove() {
-  if [ "`grep -c "^$1" $CONFIG`" -eq 0 ]; then
-    echo "There's no app $1 to remove."
-  else
-    # Stop it first.
-    do_stop_one $1
-    # Remove it from the config.
-    sed -i "\\:^$1:d" $CONFIG
-    log_daemon_msg "Removed a Puma from the jungle: $1."
-  fi
-}
-
-config_bundler() {
-  HOME="$(eval echo ~$(id -un))"
-
-  if [ -d "$1/.rbenv/bin" ]; then
-    PATH="$1/.rbenv/bin:$1/.rbenv/shims:$1"
-    eval "$(rbenv init -)"
-    USE_LOCAL_BUNDLE=1
-    return 0
-
-  elif [ -d "/usr/local/rbenv/bin" ]; then
-    PATH="/usr/local/rbenv/bin:/usr/local/rbenv/shims:$PATH"
-    eval "$(rbenv init -)"
-    USE_LOCAL_BUNDLE=1
-    return 0
-
-  elif [ -d "$HOME/.rbenv/bin" ]; then
-    PATH="$HOME/.rbenv/bin:$HOME/.rbenv/shims:$PATH"
-    eval "$(rbenv init -)"
-    USE_LOCAL_BUNDLE=1
-    return 0
-
-  # TODO: test rvm
-  # elif [ -f  /etc/profile.d/rvm.sh ]; then
-  #   source /etc/profile.d/rvm.sh
-  # elif [ -f /usr/local/rvm/scripts/rvm ]; then
-  #   source /etc/profile.d/rvm.sh
-  # elif [ -f "$HOME/.rvm/scripts/rvm" ]; then
-  #   source "$HOME/.rvm/scripts/rvm"
-  # TODO: don't know what to do with chruby
-  # elif [ -f /usr/local/share/chruby/chruby.sh ]; then
-  #   source /usr/local/share/chruby/chruby.sh
-  #   if [ -f /usr/local/share/chruby/auto.sh ]; then
-  #     source /usr/local/share/chruby/auto.sh
-  #   fi
-  # if you aren't using auto, set your version here
-  # chruby 2.0.0
-  fi
-
-  return 1
-}
-
-config_bundler
-
-case "$1" in
-  start)
-    [ "$VERBOSE" != no ] && log_daemon_msg "Starting $DESC" "$NAME"
-    if [ "$#" -eq 1 ]; then
-      do_start
-    else
-      i=`grep $2 $CONFIG`
-      dir=`echo $i | cut -d , -f 1`
-      do_start_one $dir
-    fi
-    case "$?" in
-      0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
-      2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
-    esac
-  ;;
-  stop)
-    [ "$VERBOSE" != no ] && log_daemon_msg "Stopping $DESC" "$NAME"
-    if [ "$#" -eq 1 ]; then
-      do_stop
-    else
-      i=`grep $2 $CONFIG`
-      dir=`echo $i | cut -d , -f 1`
-      do_stop_one $dir
-    fi
-    case "$?" in
-      0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
-      2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
-    esac
-  ;;
-  status)
-    # TODO Implement.
-    log_daemon_msg "Status $DESC" "$NAME"
-    if [ "$#" -eq 1 ]; then
-      do_status
-    else
-      i=`grep $2 $CONFIG`
-      dir=`echo $i | cut -d , -f 1`
-      do_status_one $dir
-    fi
-    case "$?" in
-      0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
-      2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
-    esac
-  ;;
-  restart)
-    log_daemon_msg "Restarting $DESC" "$NAME"
-    if [ "$#" -eq 1 ]; then
-      do_restart
-    else
-      i=`grep $2 $CONFIG`
-      dir=`echo $i | cut -d , -f 1`
-      do_restart_one $dir
-    fi
-    case "$?" in
-      0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
-      2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
-    esac
-  ;;
-  phased-restart)
-    log_daemon_msg "Restarting (phased) $DESC" "$NAME"
-    if [ "$#" -eq 1 ]; then
-      do_phased_restart
-    else
-      i=`grep $2 $CONFIG`
-      dir=`echo $i | cut -d , -f 1`
-      do_phased_restart_one $dir
-    fi
-    case "$?" in
-      0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
-      2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
-    esac
-  ;;
-  add)
-    if [ "$#" -lt 3 ]; then
-      echo "Please, specify the app's directory and the user that will run it at least."
-      echo "  Usage: $SCRIPTNAME add /path/to/app user /path/to/app/config/puma.rb /path/to/app/config/log/puma.log"
-      echo "    config and log are optionals."
-      exit 1
-    else
-      do_add $2 $3 $4 $5
-    fi
-    case "$?" in
-      0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
-      2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
-    esac
-  ;;
-  remove)
-    if [ "$#" -lt 2 ]; then
-      echo "Please, specify the app's directory to remove."
-      exit 1
-    else
-      do_remove $2
-    fi
-    case "$?" in
-      0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
-      2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
-    esac
-  ;;
-  *)
-    echo "Usage:" >&2
-    echo "  Run the jungle: $SCRIPTNAME {start|stop|status|restart|phased-restart}" >&2
-    echo "  Add a Puma: $SCRIPTNAME add /path/to/app user /path/to/app/config/puma.rb /path/to/app/config/log/puma.log"
-    echo "    config and log are optionals."
-    echo "  Remove a Puma: $SCRIPTNAME remove /path/to/app"
-    echo "  On a Puma: $SCRIPTNAME {start|stop|status|restart|phased-restart} PUMA-NAME" >&2
-    exit 3
-  ;;
-esac
-:

data/tools/jungle/init.d/run-puma

@@ -1,18 +0,0 @@
-#!/bin/bash
-
-# on system boot, and root have no rbenv installed,
-#   after start-stop-daemon switched to current user, we have to init rbenv
-if [ -d "$HOME/.rbenv/bin" ]; then
-  PATH="$HOME/.rbenv/bin:$HOME/.rbenv/shims:$PATH"
-  eval "$(rbenv init -)"
-elif [ -d "/usr/local/rbenv/bin" ]; then
-  PATH="/usr/local/rbenv/bin:/usr/local/rbenv/shims:$PATH"
-  eval "$(rbenv init -)"
-elif [ -f /usr/local/rvm/scripts/rvm ]; then
-  source /etc/profile.d/rvm.sh
-elif [ -f "$HOME/.rvm/scripts/rvm" ]; then
-  source "$HOME/.rvm/scripts/rvm"
-fi
-
-app=$1; config=$2; log=$3;
-cd $app && exec bundle exec puma -C $config >> $log 2>&1

data/tools/jungle/upstart/README.md

@@ -1,61 +0,0 @@
-# Puma as a service using Upstart
-
-Manage multiple Puma servers as services on the same box using Ubuntu upstart.
-
-## Installation 
-
-    # Copy the scripts to services directory 
-    sudo cp puma.conf puma-manager.conf /etc/init
-    
-    # Create an empty configuration file
-    sudo touch /etc/puma.conf
-
-## Managing the jungle 
-
-Puma apps are referenced in /etc/puma.conf by default. Add each app's path as a new line, e.g.:
-
-```
-/home/apps/my-cool-ruby-app
-/home/apps/another-app/current
-```
-
-Start the jungle running:
-
-`sudo start puma-manager`
-
-This script will run at boot time.
-
-Start a single puma like this:
-
-`sudo start puma app=/path/to/app`
-
-## Logs
-
-Everything is logged by upstart, defaulting to `/var/log/upstart`.
-
-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`.
-
-## Conventions 
-
-* The script expects:
-  * a config file to exist under `config/puma.rb` in your app. E.g.: `/home/apps/my-app/config/puma.rb`.
-  * 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.
-
-You can always change those defaults by editing the scripts.
-
-## Here's what a minimal app's config file should have
-
-```
-pidfile "/path/to/app/tmp/puma/pid"
-state_path "/path/to/app/tmp/puma/state"
-activate_control_app
-```
-
-## Before starting...
-
-You need to customise `puma.conf` to:
-
-* Set the right user your app should be running on unless you want root to execute it!
-  * Look for `setuid apps` and `setgid apps`, uncomment those lines and replace `apps` to whatever your deployment user is.
-  * Replace `apps` on the paths (or set the right paths to your user's home) everywhere else.
-* Uncomment the source lines for `rbenv` or `rvm` support unless you use a system wide installation of Ruby.

data/tools/jungle/upstart/puma-manager.conf

@@ -1,31 +0,0 @@
-# /etc/init/puma-manager.conf - manage a set of Pumas
-
-# This example config should work with Ubuntu 12.04+.  It
-# allows you to manage multiple Puma instances with
-# Upstart, Ubuntu's native service management tool.
-#
-# See puma.conf for how to manage a single Puma instance.
-#
-# Use "stop puma-manager" to stop all Puma instances.
-# Use "start puma-manager" to start all instances.
-# Use "restart puma-manager" to restart all instances.
-# Crazy, right?
-#
-
-description "Manages the set of puma processes"
-
-# This starts upon bootup and stops on shutdown
-start on runlevel [2345]
-stop on runlevel [06]
-
-# Set this to the number of Puma processes you want
-# to run on this machine
-env PUMA_CONF="/etc/puma.conf"
-
-pre-start script
-  for i in `cat $PUMA_CONF`; do
-    app=`echo $i | cut -d , -f 1`
-    logger -t "puma-manager" "Starting $app"
-    start puma app=$app
-  done
-end script

data/tools/jungle/upstart/puma.conf

@@ -1,69 +0,0 @@
-# /etc/init/puma.conf - Puma config
-
-# This example config should work with Ubuntu 12.04+.  It
-# allows you to manage multiple Puma instances with
-# Upstart, Ubuntu's native service management tool.
-#
-# See puma-manager.conf for how to manage all Puma instances at once.
-#
-# Save this config as /etc/init/puma.conf then manage puma with:
-#   sudo start puma app=PATH_TO_APP
-#   sudo stop puma app=PATH_TO_APP
-#   sudo status puma app=PATH_TO_APP
-#
-# or use the service command:
-#   sudo service puma {start,stop,restart,status}
-#
-
-description "Puma Background Worker"
-
-# no "start on", we don't want to automatically start
-stop on (stopping puma-manager or runlevel [06])
-
-# change apps to match your deployment user if you want to use this as a less privileged user (recommended!)
-setuid apps
-setgid apps
-
-respawn
-respawn limit 3 30
-
-instance ${app}
-
-script
-# this script runs in /bin/sh by default
-# respawn as bash so we can source in rbenv/rvm
-# quoted heredoc to tell /bin/sh not to interpret
-# variables
-
-# source ENV variables manually as Upstart doesn't, eg:
-#. /etc/environment
-
-exec /bin/bash <<'EOT'
-  # set HOME to the setuid user's home, there doesn't seem to be a better, portable way
-  export HOME="$(eval echo ~$(id -un))"
-
-  if [ -d "/usr/local/rbenv/bin" ]; then
-    export PATH="/usr/local/rbenv/bin:/usr/local/rbenv/shims:$PATH"
-  elif [ -d "$HOME/.rbenv/bin" ]; then
-    export PATH="$HOME/.rbenv/bin:$HOME/.rbenv/shims:$PATH"
-  elif [ -f  /etc/profile.d/rvm.sh ]; then
-    source /etc/profile.d/rvm.sh
-  elif [ -f /usr/local/rvm/scripts/rvm ]; then
-    source /etc/profile.d/rvm.sh
-  elif [ -f "$HOME/.rvm/scripts/rvm" ]; then
-    source "$HOME/.rvm/scripts/rvm"
-  elif [ -f /usr/local/share/chruby/chruby.sh ]; then
-    source /usr/local/share/chruby/chruby.sh
-    if [ -f /usr/local/share/chruby/auto.sh ]; then
-      source /usr/local/share/chruby/auto.sh
-    fi
-    # if you aren't using auto, set your version here
-    # chruby 2.0.0
-  fi
-
-  cd $app
-  logger -t puma "Starting server: $app"
-
-  exec bundle exec puma -C config/puma.rb
-EOT
-end script