supervisor 從安裝到使用

一、安裝

• 源碼安裝

先下載最新的supervisor安裝包：https://pypi.python.org/pypi/supervisor ， 如：

cd /usr/local/src
wget https://pypi.python.org/packages/7b/17/88adf8cb25f80e2bc0d18e094fcd7ab300632ea00b601cbbbb84c2419eae/supervisor-3.3.2.tar.gz
tar -zxvf supervisor-3.3.2.tar.gz
cd supervisor-3.3.2
python setup.py install #本地python版本爲python2.7
# python2.7 setup.py install #本地python版本爲python3以上

二、配置

1.生成配置文件

echo_supervisord_conf > /etc/supervisord.conf

2.啓動

supervisord -c /etc/supervisord.conf

查看 supervisord 是否在運行：

ps aux | grep supervisord

3.配置

打開配置文件

vim /etc/supervisord.conf

在配置文件底部，配置include

[include]
files=/etc/supervisor/*.conf #若你本地無/etc/supervisor目錄，請自建

用supervisor管理進程，配置如下：

cd /etc/supervisor
vim ossfs.conf # 這裏的文件名稱自定義

加入以下內容：

; 設置進程的名稱，使用 supervisorctl 來管理進程時需要使用該進程名
[program:your_program_name] 
command=python server.py --port=9000
;numprocs=1                 ; 默認爲1
;process_name=%(program_name)s   ; 默認爲 %(program_name)s，即 [program:x] 中的 x
directory=/home/python/tornado_server ; 執行 command 之前，先切換到工作目錄
user=oxygen                 ; 使用 oxygen 用戶來啓動該進程
; 程序崩潰時自動重啓，重啓次數是有限制的，默認爲3次
autorestart=true            
redirect_stderr=true        ; 重定向輸出的日誌
stdout_logfile = /var/log/supervisord/tornado_server.log
loglevel=info

這裏是啓動要配置的參數，請根據自己的項目自定義添加

更改了supervisor配置文件，需要重啓,運行以下指令：

supervisorctl reload

4.supervisorctl的用法

supervisord : 啓動supervisor
supervisorctl reload :修改完配置文件後重新啓動supervisor
supervisorctl status :查看supervisor監管的進程狀態
supervisorctl start 進程名 ：啓動XXX進程
supervisorctl stop 進程名 ：停止XXX進程
supervisorctl stop all：停止全部進程，注：start、restart、stop都不會載入最新的配置文件。
supervisorctl update：根據最新的配置文件，啓動新配置或有改動的進程，配置沒有改動的進程不會受影響而重啓

5.若不使用控制檯來管理進程，用瀏覽器來管理，該如何配置？

打開配置文件

vim /etc/supervisord.conf

配置 inet_http_server

[inet_http_server]       
port=127.0.0.1:9001     ; 服務器ip
username=xxx        ;自定義
password=xxx        ;自定義

三、設置開機啓動

vim /etc/init.d/supervisord

添加以下腳本

#! /bin/sh
### BEGIN INIT INFO
# Provides:          supervisord
# Required-Start:    $remote_fs
# Required-Stop:     $remote_fs
# Default-Start:     2 3 4 5
# Default-Stop:      0 1 6
# Short-Description: Example initscript
# Description:       This file should be used to construct scripts to be
#                    placed in /etc/init.d.
### END INIT INFO

# Author: Dan MacKinlay <[email protected]>
# Based on instructions by Bertrand Mathieu
# http://zebert.blogspot.com/2009/05/installing-django-solr-varnish-and.html

# Do NOT "set -e"

# PATH should only include /usr/* if it runs after the mountnfs.sh script
PATH=/usr/local/sbin:/usr/local/bin:/sbin:/usr/sbin:/bin:/usr/bin
DESC="Description of the service"
NAME=supervisord
DAEMON=/usr/local/bin/supervisord
DAEMON_ARGS=" -c /etc/supervisord.conf"
#PIDFILE=/var/run/$NAME.pid
PIDFILE=/tmp/$NAME.pid
SCRIPTNAME=/etc/init.d/$NAME

# Exit if the package is not installed
[ -x "$DAEMON" ] || exit 0

# Read configuration variable file if it is present
[ -r /etc/default/$NAME ] && . /etc/default/$NAME

# 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 daemon/service
#
do_start()
{
    # Return
    #   0 if daemon has been started
    #   1 if daemon was already running
    #   2 if daemon could not be started
    start-stop-daemon --start --quiet --pidfile $PIDFILE --exec $DAEMON --test > /dev/null \
        || return 1
    start-stop-daemon --start --quiet --pidfile $PIDFILE --exec $DAEMON -- \
        $DAEMON_ARGS \
        || return 2
    # Add code here, if necessary, that waits for the process to be ready
    # to handle requests from services started subsequently which depend
    # on this one.  As a last resort, sleep for some time.
}

#
# Function that stops the daemon/service
#
do_stop()
{
    # Return
    #   0 if daemon has been stopped
    #   1 if daemon was already stopped
    #   2 if daemon could not be stopped
    #   other if a failure occurred
    start-stop-daemon --stop --quiet --retry=TERM/30/KILL/5 --pidfile $PIDFILE --name $NAME
    RETVAL="$?"
    [ "$RETVAL" = 2 ] && return 2
    # Wait for children to finish too if this is a daemon that forks
    # and if the daemon is only ever run from this initscript.
    # If the above conditions are not satisfied then add some other code
    # that waits for the process to drop all resources that could be
    # needed by services started subsequently.  A last resort is to
    # sleep for some time.
    start-stop-daemon --stop --quiet --oknodo --retry=0/30/KILL/5 --exec $DAEMON
    [ "$?" = 2 ] && return 2
    # Many daemons don't delete their pidfiles when they exit.
    rm -f $PIDFILE
    return "$RETVAL"
}

#
# Function that sends a SIGHUP to the daemon/service
#
do_reload() {
    #
    # If the daemon can reload its configuration without
    # restarting (for example, when it is sent a SIGHUP),
    # then implement that here.
    #
    start-stop-daemon --stop --signal 1 --quiet --pidfile $PIDFILE --name $NAME
    return 0
}

case "$1" in
  start)
    [ "$VERBOSE" != no ] && log_daemon_msg "Starting $DESC" "$NAME"
    do_start
    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"
    do_stop
    case "$?" in
        0|1) [ "$VERBOSE" != no ] && log_end_msg 0 ;;
        2) [ "$VERBOSE" != no ] && log_end_msg 1 ;;
    esac
    ;;
  #reload|force-reload)
    #
    # If do_reload() is not implemented then leave this commented out
    # and leave 'force-reload' as an alias for 'restart'.
    #
    #log_daemon_msg "Reloading $DESC" "$NAME"
    #do_reload
    #log_end_msg $?
    #;;
  restart|force-reload)
    #
    # If the "reload" option is implemented then remove the
    # 'force-reload' alias
    #
    log_daemon_msg "Restarting $DESC" "$NAME"
    do_stop
    case "$?" in
      0|1)
        do_start
        case "$?" in
            0) log_end_msg 0 ;;
            1) log_end_msg 1 ;; # Old process is still running
            *) log_end_msg 1 ;; # Failed to start
        esac
        ;;
      *)
        # Failed to stop
        log_end_msg 1
        ;;
    esac
    ;;
  *)
    #echo "Usage: $SCRIPTNAME {start|stop|restart|reload|force-reload}" >&2
    echo "Usage: $SCRIPTNAME {start|stop|restart|force-reload}" >&2
    exit 3
    ;;
esac

:

# 設置該腳本爲可以執行
sudo chmod +x /etc/init.d/supervisord
# 設置爲開機自動運行
sudo update-rc.d supervisord defaults
# 試一下，是否工作正常
service supervisord stop
service supervisord start

若報錯：insserv: warning: script 'service' missing LSB tags and overrides，請執行:

sudo apt-get remove insserv