supervisor 管理进程简明教程

时间 2019-11-18

标签 supervisor 管理进程简明教程繁體版

原文原文链接

supervisor 管理进程简明教程

一、Introduction

(1) 基于python编写，安装方便
(2) 进程管理工具，能够很方便的对用户定义的进程进行启动，关闭，重启，而且对意外关闭的进程进行重启 ，只须要简单的配置一下便可，且有web端，状态、日志查看清晰明了。
(3) 组成部分 supervisord[服务端，因此要经过这个来启动它]
            supervisorctl[客户端，能够来执行stop等命令]
(4) 官方文档地址：http://supervisord.org/

二、安装

python 第三方包的安装方法，此处不详细描述html

pip install supervisor

三、使用说明

使用supervisor很简单，只须要修改一些配置文件，就可使用了。python

3.1 查看默认配置

运行linux

echo_supervisord_conf

便可看到默认配置状况，可是通常状况下，咱们都不要去修改默认的配置，而是将默认配置重定向到另外的文件中，不一样的进程运用不一样的配置文件去对默认文件进行复写便可。ios

echo_supervisord_conf > /etc/supervisord.conf

3.1 默认配置说明

默认的配置文件是下面这样的，可是这里有个坑须要注意，supervisord.pid 以及 supervisor.sock 是放在 /tmp 目录下，可是 /tmp 目录是存放临时文件，里面的文件是会被 Linux 系统删除的，一旦这些文件丢失，就没法再经过 supervisorctl 来执行 restart 和 stop 命令了，将只会获得 unix:///tmp/supervisor.sock 不存在的错误。git

[unix_http_server]
;file=/tmp/supervisor.sock   ; (the path to the socket file)
;建议修改成 /var/run 目录，避免被系统删除
file=/var/run/supervisor.sock   ; (the path to the socket file)
;chmod=0700                 ; socket file mode (default 0700)
;chown=nobody:nogroup       ; socket file uid:gid owner
;username=user              ; (default is no username (open server))
;password=123               ; (default is no password (open server))

;[inet_http_server]         ; inet (TCP) server disabled by default
;port=127.0.0.1:9001        ; (ip_address:port specifier, *:port for ;all iface)
;username=user              ; (default is no username (open server))
;password=123               ; (default is no password (open server))
...

[supervisord]
;logfile=/tmp/supervisord.log ; 日志文件(main log file;default $CWD/supervisord.log)
;建议修改成 /var/log 目录，避免被系统删除
logfile=/var/log/supervisor/supervisord.log ; (main log file;default $CWD/supervisord.log)
logfile_maxbytes=50MB        ; 日志文件大小(max main logfile bytes b4 rotation;default 50MB)
logfile_backups=10           ; 日志文件保留备份数量(num of main logfile rotation backups;default 10)
loglevel=info                ; 日志级别(log level;default info; others: debug,warn,trace)
;pidfile=/tmp/supervisord.pid ; (supervisord pidfile;default supervisord.pid)
;建议修改成 /var/run 目录，避免被系统删除
pidfile=/var/run/supervisord.pid ; (supervisord pidfile;default supervisord.pid)
;设置启动supervisord的用户，通常状况下不要轻易用root用户来启动，除非你真的肯定要这么作
;user=chrism                 ; (default is current user, required if root)
nodaemon=false               ; (start in foreground if true;default false)
minfds=1024                  ; (min. avail startup file descriptors;default 1024)
minprocs=200                 ; (min. avail process descriptors;default 200)
;umask=022                   ; (process file creation umask;default 022)
;identifier=supervisor       ; (supervisord identifier, default is 'supervisor')
;directory=/tmp              ; (default is not to cd during start)
;nocleanup=true              ; (don't clean up tempfiles at start;default false)
;childlogdir=/tmp            ; ('AUTO' child log dir, default $TEMP)
;environment=KEY="value"     ; (key value pairs to add to environment)
;strip_ansi=false            ; (strip ansi escape codes in logs; def. false)

[unix_http_server]
file=/tmp/supervisor.sock   ; (the path to the socket file)
;chmod=0700                 ; socket file mode (default 0700)
;chown=nobody:nogroup       ; socket file uid:gid owner
;username=user              ; (default is no username (open server))
;password=123               ; (default is no password (open server))


[supervisorctl]
; 必须和'unix_http_server'里面的设定匹配
;serverurl=unix:///tmp/supervisor.sock ; use a unix:// URL  for a unix socket
;建议修改成 /var/run 目录，避免被系统删除
serverurl=unix:///var/run/supervisor.sock ; use a unix:// URL  for a unix socket
;serverurl=http://127.0.0.1:9001 ; use an http:// url to specify an inet socket
;username=chris              ; should be same as http_username if set
;password=123                ; should be same as http_password if set

;[program:theprogramname]
;command=/bin/cat              ; the program (relative uses PATH, can take args)
;process_name=%(program_name)s ; process_name expr (default %(program_name)s)
;numprocs=1                    ; number of processes copies to start (def 1)
;directory=/tmp                ; directory to cwd to before exec (def no cwd)
;umask=022                     ; umask for process (default None)
;priority=999                  ; the relative start priority (default 999)
;autostart=true                ; start at supervisord start (default: true)
;startsecs=1                   ; # of secs prog must stay up to be running (def. 1)
;startretries=3                ; max # of serial start failures when starting (default 3)
;autorestart=unexpected        ; when to restart if exited after running (def: unexpected)
;exitcodes=0,2                 ; 'expected' exit codes used with autorestart (default 0,2)
;stopsignal=QUIT               ; signal used to kill process (default TERM)
;stopwaitsecs=10               ; max num secs to wait b4 SIGKILL (default 10)
;stopasgroup=false             ; send stop signal to the UNIX process group (default false)
;killasgroup=false             ; SIGKILL the UNIX process group (def false)
;user=chrism                   ; setuid to this UNIX account to run the program
;redirect_stderr=true          ; redirect proc stderr to stdout (default false)
;stdout_logfile=/a/path        ; stdout log path, NONE for none; default AUTO
;stdout_logfile_maxbytes=1MB   ; max # logfile bytes b4 rotation (default 50MB)
;stdout_logfile_backups=10     ; # of stdout logfile backups (default 10)
;stdout_capture_maxbytes=1MB   ; number of bytes in 'capturemode' (default 0)
;stdout_events_enabled=false   ; emit events on stdout writes (default false)
;stderr_logfile=/a/path        ; stderr log path, NONE for none; default AUTO
;stderr_logfile_maxbytes=1MB   ; max # logfile bytes b4 rotation (default 50MB)
;stderr_logfile_backups=10     ; # of stderr logfile backups (default 10)
;stderr_capture_maxbytes=1MB   ; number of bytes in 'capturemode' (default 0)
;stderr_events_enabled=false   ; emit events on stderr writes (default false)
;environment=A="1",B="2"       ; process environment additions (def no adds)
;serverurl=AUTO                ; override serverurl computation (childutils)

;[group:thegroupname]
;programs=progname1,progname2  ; each refers to 'x' in [program:x] definitions
;priority=999                  ; the relative start priority (default 999)


[include]
files = /etc/supervisor/*.conf

配置文件都有说明，且很简单，就不作多的描述了，在上面有一些建议修改的目录，若作了修改，则应先建立这些文件，须要注意权限问题，不少错误都是没有权限形成的。github

3.2 启动服务端

如今，让咱们来启动supervisor服务。web

supervisord -c /etc/supervisord.confshell

查看supervisord 是否运行：ubuntu

ps aux|grep superviosrd浏览器

output:xxxx   82039      1  0 11:22 ?        00:00:00 /usr/local/bin/python /usr/local/bin/supervisord -c /etc/supervisord.conf

3.2 项目配置及运行

上面咱们已经把 supervisrod 运行起来了，如今能够添加咱们要管理的进程的配置文件。能够把全部配置项都写到 supervisord.conf 文件里，但并不推荐这样作，而是经过 include 的方式把不一样的程序（组）写到不一样的配置文件里，对，就是默认配置中的最后的那个include。下面来对项目进行简单的配置。
假设咱们把项目配置文件放在这个目录中:/etc/supervisor/
则咱们须要修改/etc/supervisord.conf 中的include为：
[include]
files = /etc/supervisor/*.conf

如下为本人的配置文件目录：

/etc/supervisor/update_ip.conf

[program:update_ip] ;项目名称
directory = /home/xxxx/works/ip_update/ip_update_on_server_no_1/ ; 程序的启动目录
command = python /home/xxxx/works/ip_update/ip_update_on_server_no_1/update_ip_internal.py  ; 启动命令，能够看出与手动在命令行启动的命令是同样
autostart = true     ; 在 supervisord 启动的时候也自动启动
startsecs = 5        ; 启动 5 秒后没有异常退出，就看成已经正常启动了
autorestart = true   ; 程序异常退出后自动重启
startretries = 3     ; 启动失败自动重试次数，默认是 3
user = shimeng          ; 用哪一个用户启动
redirect_stderr = true  ; 把 stderr 重定向到 stdout，默认 false
stdout_logfile_maxbytes = 50MB  ; stdout 日志文件大小，默认 50MB
stdout_logfile_backups = 20     ; stdout 日志文件备份数
; stdout 日志文件，须要注意当指定目录不存在时没法正常启动，因此须要手动建立目录（supervisord 会自动建立日志文件）
stdout_logfile = /home/xxxx/works/ip_update/ip_update_on_server_no_1/supervisor.log
loglevel=info

[supervisorctl]
serverurl=unix:///tmp/supervisor.sock ; use a unix:// URL  for a unix socket

[unix_http_server]
file=/tmp/supervisor.sock   ; (the path to the socket file)
chmod=0777                 ; socket file mode (default 0700)
;chown=nobody:nogroup       ; socket file uid:gid owner
;username=shimeng              ; (default is no username (open server))
;password=123               ; (default is no password (open server))

[inet_http_server]         ; inet (TCP) server disabled by default
port=127.0.0.1:9001        ; (ip_address:port specifier, *:port for all iface)
username=shimeng              ; (default is no username (open server))
password=123

配置详解：
a)  在supervisord.conf文件中，分号“；”后面的内容表示注释
b)  [group:组名]，设置一个服务分组，programs后面跟组内全部服务的名字，以分号分格。
c)  [program：服务名]，下面是这个服务的具体设置：
Command:启用Tornado服务文件的命令，也就是咱们手动启动的命令。
Directory:服务文件所在的目录
User:启用服务的用户
Autorestart:是否自动重启服务
stdout_logfile：服务的产生的日起文件
loglevel:日志级别

配置完成之后，便可运行：

supervisord -c /etc/supervisord.conf

查看运行状态

$ supervisorctl status

out:
update_ip         RUNNING   pid 62040, uptime 0:10:09

打开浏览器，输入127.0.0.9001,输入用户名与密码（若是配置文件中inet_http_server中做了设置），能够看到下面这个界面：

3.3 使用supervisorctl

在启动服务以后，运行：

supervisorctl -c /etc/supervisord.conf

out:
update_ip         RUNNING   pid 62040, uptime 0:10:09

若成功，则会进入supervisorctl的shell界面，有如下方法：

status    # 查看程序状态
stop update_ip   # 关闭 update_ip 程序
start update_ip  # 启动 update_ip 程序
restart update_ip    # 重启 update_ip 程序
reread    ＃ 读取有更新（增长）的配置文件，不会启动新添加的程序
update    ＃ 重启配置文件修改过的程序

执行相关操做后，能够在web端看到具体的变化状况，如stop 程序

stop update_ip

其实，也能够不使用supervisorctl shell界面，而在bash终端运行：

$ supervisorctl status
$ supervisorctl stop usercenter
$ supervisorctl start usercenter
$ supervisorctl restart usercenter
$ supervisorctl reread
$ supervisorctl update

3.4 多个进程管理

按照官方文档的定义，一个 [program:x] 其实是表示一组相同特征或同类的进程组，也就是说一个 [program:x] 能够启动多个进程。这组进程的成员是经过 numprocs 和 process_name 这两个参数来肯定的，这句话什么意思呢，咱们来看这个例子。

; 设置进程的名称，使用 supervisorctl 来管理进程时须要使用该进程名
[program:foo] 

; 能够在 command 这里用 python 表达式传递不一样的参数给每一个进程
command=python server.py --port=90%(process_num)02d

directory=/home/python/tornado_server ; 执行 command 以前，先切换到工做目录

; 若 numprocs 不为1，process_name 的表达式中必定要包含 process_num 来区分不一样的进程
numprocs=2                   
process_name=%(program_name)s_%(process_num)02d; 

user=oxygen                 ; 使用 oxygen 用户来启动该进程

autorestart=true  ; 程序崩溃时自动重启

redirect_stderr=true      ; 重定向输出的日志

stdout_logfile = /var/log/supervisord/
tornado_server.log
loglevel=info

上面这个例子会启动两个进程，process_name 分别为 foo:foo_01 和 foo:foo_02。经过这样一种方式，就能够用一个 [program:x] 配置项，来启动一组很是相似的进程。
更详细配置，点击这里

Supervisor 同时还提供了另一种进程组的管理方式，经过这种方式，可使用 supervisorctl 命令来管理一组进程。跟 [program:x] 的进程组不一样的是，这里的进程是一个个的 [program:x] 。

[group:thegroupname]
programs=progname1,progname2  ; each refers to 'x' in [program:x] definitions
priority=999                  ; the relative start priority (default 999)

当添加了上述配置后，progname1 和 progname2 的进程名就会变成 thegroupname:progname1 和 thegroupname:progname2 之后就要用这个名字来管理进程了，而不是以前的 progname1。

之后执行 supervisorctl stop thegroupname: 就能同时结束 progname1 和 progname2，执行 supervisorctl stop thegroupname:progname1 就能结束 progname1。

4. 结尾

实际上，默认状况下，supervisored 也是一个进程，最理想的的状况应该是将其安装为系统服务，安装方法能够参考这里,安装脚本参考这里,因为没有作具体的实验，此处不展开说明。

其实还有一个简单的方法，由于 Linux 在启动的时候会执行 /etc/rc.local 里面的脚本，因此只要在这里添加执行命令就能够

# 若是是 Ubuntu 添加如下内容
/usr/local/bin/supervisord -c /etc/supervisord.conf


# 若是是 Centos 添加如下内容
/usr/bin/supervisord -c /etc/supervisord.conf

以上内容须要添加在 exit 命令前，并且因为在执行 rc.local 脚本时，PATH 环境变量未所有初始化，所以命令须要使用绝对路径。

在添加前，先在终端测试一下命令是否能正常执行，若是找不到 supervisord，能够用以下命令找到

sudo find / -name supervisord

output:
/usr/local/bin/supervisord