运维利器1-supervisor

supervisor用来管理进程服务很方便

优势：

1.重启方便，无抖动感

2.能够分组管理进程

3.加入系统自动启动后，能够开机自启，程序异常退出能自动启动

 

操做：

1.在python沙箱环境下操做supervisor，进去python 沙箱虚拟环境(virtualenv)

$source my_env/bin/activity

这个不会的自行谷歌下

2.安装supervisor

$pip install supervisor

3.生成默认配置文件

安装好supervisor以后，默认是没有生成配置文件的。能够经过如下命令生成配置文件

$echo_supervisord_conf > ocp_supervisord.conf

4.启动supervisor

$supervisord -c ocp_supervisord.conf

5.查看当前管理的进程

$supervisorctl -c ocp_supervisord.conf

$ exit

6.配置

a.配置 sock路径，log路径，log等级等，能够大体浏览一下配置文件，以为有须要修改的改下；

若是后面supervisor 启动失败，能够多琢磨下配置文件，好比看看log/socket 路径权限，或者开启debug模式，或者看看文件夹是否建立，supervisor能够自动建立文件，可是不能自动建立文件夹

 

b.配置进程，在supervisord.conf 最后加上下面配置，固然你也能够放到其余文件，经过include 引入

;进程组
[program:ocp_groupworker]
directory=/data/suyuan/ocp/ ;程序启动目录
command=/data/suyuan/ocp_env/bin/gunicorn ocp.wsgi:application -k gevent -b 0.0.0.0:349%(process_num)01d --reload ; bash -c /data/suyuan/ocp/run_gunicorn.sh ;程序启动命令，和手动在命令行启动同样，这里有坑
user = root ; 用哪一个用户启动
numprocs=4 ; 启动的数量4
process_name=%(program_name)s_349%(process_num)01d ; 每一个进程名称
autorestart = true ; 程序异常退出后，自动启动
autostart = true ; 程序随着supervisor一共启动
startsecs = 5 ; 程序启动5s后没有异常退出，就当作正常启动了
startretries = 3 ; 程序失败自动重启次数
stdout_logfile = /var/log/supervisor/ocp_349%(process_num)01d.log
redirect_stderr = true ; 把 stderr 重定向到 stdout，默认 false
stdout_logfile_maxbytes = 20MB ; stdout 日志文件大小，默认 50MB
stdout_logfile_backups = 20 ; stdout 日志文件备份数
; stdout 日志文件，须要注意当指定目录不存在时没法正常启动，因此须要手动建立目录（supervisord 会自动建立日志文件）
; 能够经过 environment 来添加须要的环境变量，一种常见的用法是修改 PYTHONPATH
; environment=PYTHONPATH=$PYTHONPATH:/path/to/somewhere

 

7.重载配置后自动会重启

$supervisorctl -c ocp_supervisord.conf
> reload

还有一些经常使用的命令：

restart ocp_groupworker:*

stop ocp_groupworker:*

start ocp_groupworker:*

status

 

完成了！

感兴趣能够研究下他的配置文件，有不少功能，如提供web查看管理服务等

 

 

8有个坑要说下，supervisor 的command 不是那么随意的

The command that will be run when this program is started. The command can be either absolute (e.g. /path/to/programname) or relative (e.g. programname). If it is relative, the supervisord’s environment $PATH will be searched for the executable. Programs can accept arguments, e.g. /path/to/program foo bar. The command line can use double quotes to group arguments with spaces in them to pass to the program, e.g. /path/to/program/name -p "foo bar". Note that the value of command may include Python string expressions, e.g. /path/to/programname --port=80%(process_num)02d might expand to /path/to/programname --port=8000at runtime. String expressions are evaluated against a dictionary containing the keys group_name, host_node_name, process_num, program_name, here (the directory of the supervisord config file), and all supervisord’s environment variables prefixed with ENV_. Controlled programs should themselves not be daemons, as supervisord assumes it is responsible for daemonizing its subprocesses (see Nondaemonizing of Subprocesses).

a.不能使守护进程，因此 nohup 不能用

b.好像sh 、bash 的使用会有讲究，我记不太清了，主要是使用不当，supervisor 没法stop或者restart 进程，遇到的时候能够关注下

 

9.supervisor组件

a.supervisord

supervisord是supervisor的服务端程序。

干的活：启动supervisor程序自身，启动supervisor管理的子进程，响应来自clients的请求，重启闪退或异常退出的子进程，把子进程的stderr或stdout记录到日志文件中，生成和处理Event

 

b.supervisorctl

这东西仍是有点用的，若是说supervisord是supervisor的服务端程序，那么supervisorctl就是client端程序了。supervisorctl有一个类型shell的命令行界面，咱们能够利用它来查看子进程状态，启动/中止/重启子进程，获取running子进程的列表等等。。。最牛逼的一点是，supervisorctl不只能够链接到本机上的supervisord，还能够链接到远程的supervisord，固然在本机上面是经过UNIX socket链接的，远程是经过TCP socket链接的。supervisorctl和supervisord之间的通讯，是经过xml_rpc完成的。    相应的配置在[supervisorctl]块里面

 

c.Web Server

Web Server主要能够在界面上管理进程，Web Server实际上是经过XML_RPC来实现的，能够向supervisor请求数据，也能够控制supervisor及子进程。配置在[inet_http_server]块里面

 

d.XML_RPC接口

这个就是远程调用的，上面的supervisorctl和Web Server就是它弄的

 

配置文件详解

[unix_http_server]            
file=/tmp/supervisor.sock   ; socket文件的路径，supervisorctl用XML_RPC和supervisord通讯就是经过它进行,的。若是不设置的话，supervisorctl也就不能用了 ,不设置的话，默认为none。 非必须设置        
;chmod=0700                 ; 这个简单，就是修改上面的那个socket文件的权限为0700,不设置的话，默认为0700。 非必须设置
;chown=nobody:nogroup       ; 这个同样，修改上面的那个socket文件的属组为user.group,不设置的话，默认为启动supervisord进程的用户及属组。非必须设置
;username=user              ; 使用supervisorctl链接的时候，认证的用户,不设置的话，默认为不须要用户。 非必须设置
;password=123               ; 和上面的用户名对应的密码，能够直接使用明码，也可使用SHA加密,如：{SHA}82ab876d1387bfafe46cc1c8a2ef074eae50cb1d,默认不设置。。。非必须设置
;[inet_http_server]         ; 侦听在TCP上的socket，Web Server和远程的supervisorctl都要用到他,不设置的话，默认为不开启。非必须设置
;port=127.0.0.1:9001        ; 这个是侦听的IP和端口，侦听全部IP用 :9001或*:9001。,这个必须设置，只要上面的[inet_http_server]开启了，就必须设置它
;username=user              ; 这个和上面的uinx_http_server一个样。非必须设置
;password=123               ; 这个也一个样。非必须设置
 
[supervisord]                ;这个主要是定义supervisord这个服务端进程的一些参数的,这个必须设置，不设置，supervisor就不用干活了
logfile=/tmp/supervisord.log ; 这个是supervisord这个主进程的日志路径，注意和子进程的日志不搭嘎。,默认路径$CWD/supervisord.log，$CWD是当前目录。。非必须设置
logfile_maxbytes=50MB        ; 这个是上面那个日志文件的最大的大小，当超过50M的时候，会生成一个新的日 ,志文件。当设置为0时，表示不限制文件大小,默认值是50M，非必须设置。              
logfile_backups=10           ; 日志文件保持的数量，supervisor在启动程序时，会自动建立10个buckup文件，用于log rotate,当设置为0时，表示不限制文件的数量。,默认状况下为10。。。非必须设置
loglevel=info                ; 日志级别，有critical, error, warn, info, debug, trace, or blather等, 默认为info。。。非必须设置项
pidfile=/tmp/supervisord.pid ; supervisord的pid文件路径。,默认为$CWD/supervisord.pid。。。非必须设置
nodaemon=false               ; 若是是true，supervisord进程将在前台运行,默认为false，也就是后台以守护进程运行。。。非必须设置
minfds=1024                  ; 这个是最少系统空闲的文件描述符，低于这个值supervisor将不会启动。系统的文件描述符在这里设置cat /proc/sys/fs/file-max,默认状况下为1024。。。非必须设置
minprocs=200                 ; 最小可用的进程描述符，低于这个值supervisor也将不会正常启动。ulimit  -u这个命令，能够查看linux下面用户的最大进程数,默认为200。。。非必须设置
;umask=022                   ; 进程建立文件的掩码,默认为022。。非必须设置项
;user=chrism                 ; 这个参数能够设置一个非root用户，当咱们以root用户启动supervisord以后。我这里面设置的这个用户，也能够对supervisord进行管理,默认状况是不设置。。。非必须设置项
;identifier=supervisor       ; 这个参数是supervisord的标识符，主要是给XML_RPC用的。当你有多个, supervisor的时候，并且想调用XML_RPC统一管理，就须要为每一个,supervisor设置不一样的标识符了, 默认是supervisord。。。非必需设置
;directory=/tmp              ; 这个参数是当supervisord做为守护进程运行的时候，设置这个参数的话，启动supervisord进程以前，会先切换到这个目录默认不设置。。。非必须设置
;nocleanup=true              ; 这个参数当为false的时候，会在supervisord进程启动的时候，把之前子进程产生的日志文件(路径为AUTO的状况下)清除掉。有时候我们想要看历史日志，固然不想日志被清除了。因此能够设置为true,默认是false，有调试需求的同窗能够设置为true。。。非必须设置
;childlogdir=/tmp            ; 当子进程日志路径为AUTO的时候，子进程日志文件的存放路径。默认路径是这个东西，执行下面的这个命令看看就OK了，处理的东西就默认路径,python -c "import tempfile;print tempfile.gettempdir()",非必须设置
;environment=KEY="value"     ; 这个是用来设置环境变量的，supervisord在linux中启动默认继承了linux的环境变量，在这里能够设置supervisord进程特有的其余环境变量。
　　　　　　　　　　　　　　　　  ;supervisord启动子进程时，子进程会拷贝父进程的内存空间内容。 因此设置的这些环境变量也会被子进程继承。小例子：environment=name="haha",age="hehe" 默认为不设置。。。非必须设置
;strip_ansi=false            ; 这个选项若是设置为true，会清除子进程日志中的全部ANSI 序列。什么是ANSI 序列呢？就是咱们的\n,\t这些东西。默认为false。。。非必须设置
; the below section must remain in the config file for RPC
; (supervisorctl/web interface) to work, additional interfaces may be
; added by defining them in separate rpcinterface: sections

[rpcinterface:supervisor]    ;这个选项是给XML_RPC用的，固然你若是想使用supervisord或者web server 这个选项必需要开启的supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface 
[supervisorctl]              ;这个主要是针对supervisorctl的一些配置  
serverurl=unix:///tmp/supervisor.sock ; 这个是supervisorctl本地链接supervisord的时候，本地UNIX socket 路径，注意这个是和前面的[unix_http_server]对应的默认值就是unix:///tmp/supervisor.sock。。非必须设置
;serverurl=http://127.0.0.1:9001 ; 这个是supervisorctl远程链接supervisord的时候，用到的TCP socket路径,注意这个和前面的[inet_http_server]对应,默认就是http://127.0.0.1:9001。。。非必须项
;username=chris              ; 用户名默认空。。非必须设置
;password=123                ; 密码默认空。。非必须设置
;prompt=mysupervisor         ; 输入用户名密码时候的提示符 默认supervisor。。非必须设置
;history_file=~/.sc_history  ; 这个参数和shell中的history相似，咱们能够用上下键来查找前面执行过的命令 默认是no file的。。因此咱们想要有这种功能，必须指定一个文件。。。非必须设置
; The below sample program section shows all possible program subsection values,
; create one or more 'real' program: sections to be able to control them under
; supervisor.

;[program:theprogramname]      ;这个就是我们要管理的子进程了，":"后面的是名字，最好别乱写和实际进程，有点关联最好。这样的program咱们能够设置一个或多个，一个program就是，要被管理的一个进程
;command=/bin/cat              ; 这个就是咱们的要启动进程的命令路径了，能够带参数，例子：/home/test.py -a 'hehe'，有一点须要注意的是，咱们的command只能是那种在终端运行的进程，不能是，
　　　　　　　　　　             ；守护进程。这个想一想也知道了，好比说command=service httpd start。httpd这个进程被linux的service管理了，咱们的supervisor再去启动这个命令这已经不是严格意义的子进程了。这个是个必须设置的项
;process_name=%(program_name)s ; 这个是进程名，若是咱们下面的numprocs参数为1的话，就不用管这个参数了，它默认值%(program_name)s也就是上面的那个program冒号后面的名字，
　　　　　　　　　　　　　　       ；可是若是numprocs为多个的话，那就不能这么干了。想一想也知道，不可能每一个进程都用同一个进程名吧。
;numprocs=1                    ; 启动进程的数目。当不为1时，就是进程池的概念，注意process_name的设置，默认为1    。。非必须设置
;directory=/tmp                ; 进程运行前，会前切换到这个目录，默认不设置。。。非必须设置
;umask=022                     ; 进程掩码，默认none，非必须
;priority=999                  ; 子进程启动关闭优先级，优先级低的，最早启动，关闭的时候最后关闭，默认值为999 。。非必须设置
;autostart=true                ; 若是是true的话，子进程将在supervisord启动后被自动启动，默认就是true   。。非必须设置
;autorestart=unexpected        ; 这个是设置子进程挂掉后自动重启的状况，有三个选项，false,unexpected和true。若是为false的时候，不管什么状况下，都不会被从新启动，若是为unexpected，
　　　　　　　　　　　　　　　　　　；只有当进程的退出码不在下面的exitcodes里面定义的退出码的时候，才会被自动重启。当为true的时候，只要子进程挂掉，将会被无，条件的重启
;startsecs=1                   ; 这个选项是子进程启动多少秒以后，此时状态若是是running，则咱们认为启动成功了默认值为1 。。非必须设置
;startretries=3                ; 当进程启动失败后，最大尝试启动的次数。。当超过3次后，supervisor将把此进程的状态置为FAIL，默认值为3 。。非必须设置
;exitcodes=0,2                 ; 注意和上面的的autorestart=unexpected对应。。exitcodes里面的定义的退出码是expected的。
;stopsignal=QUIT               ; 进程中止信号，能够为TERM, HUP, INT, QUIT, KILL, USR1, or USR2等信号 默认为TERM 。。当用设定的信号去干掉进程，退出码会被认为是expected，非必须设置
;stopwaitsecs=10               ; 这个是当咱们向子进程发送stopsignal信号后，到系统返回信息， 给supervisord，所等待的最大时间。 超过这个时间，supervisord会向该子进程发送一个强制kill的信号。 默认为10秒。。非必须设置
;stopasgroup=false             ; 这个东西主要用于，supervisord管理的子进程，这个子进程自己还有子进程。
　　　　　　　　　　　　　　　　　　;那么咱们若是仅仅干掉supervisord的子进程的话，子进程的子进程,有可能会变成孤儿进程。因此我们能够设置可个选项，把整个该子进程的整个进程组都干掉。 设置为true的话，通常killasgroup也会被设置为true。
                               ;须要注意的是，该选项发送的是stop信号默认为false。。非必须设置。。
;killasgroup=false             ; 这个和上面的stopasgroup相似，不过发送的是kill信号
;user=chrism                   ; 若是supervisord是root启动，咱们在这里设置这个非root用户，能够用来管理该program,默认不设置。。。非必须设置项
;redirect_stderr=true          ; 若是为true，则stderr的日志会被写入stdout日志文件中,默认为false，非必须设置
;stdout_logfile=/a/path        ; 子进程的stdout的日志路径，能够指定路径，AUTO，none等三个选项。设置为none的话，将没有日志产生。
　　　　　　　　　　　　　　　　　　;设置为AUTO的话，将随机找一个地方生成日志文件，并且当supervisord从新启动的时候，之前的日志文件会被清空。当 redirect_stderr=true的时候，sterr也会写进这个日志文件
;stdout_logfile_maxbytes=1MB   ; 日志文件最大大小，和[supervisord]中定义的同样。默认为50
;stdout_logfile_backups=10     ; 和[supervisord]定义的同样。默认10
;stdout_capture_maxbytes=1MB   ; 这个东西是设定capture管道的大小，当值不为0的时候，子进程能够从stdout发送信息，而supervisor能够根据信息，发送相应的event。默认为0，为0的时候表达关闭管道。。。非必须项
;stdout_events_enabled=false   ; 当设置为ture的时候，当子进程由stdout向文件描述符中写日志的时候，将触发supervisord发送PROCESS_LOG_STDOUT类型的event，默认为false。。。非必须设置
;stderr_logfile=/a/path        ; 这个东西是设置stderr写的日志路径，当redirect_stderr=true。这个就不用设置了，设置了也是白搭。由于它会被写入stdout_logfile的同一个文件中，默认为AUTO，也就是随便找个地存，supervisord重启被清空。。非必须设置
;stderr_logfile_maxbytes=1MB   ; 这个出现好几回了，就不重复了
;stderr_logfile_backups=10     ; 这个也是
;stderr_capture_maxbytes=1MB   ; 这个同样，和stdout_capture同样。 默认为0，关闭状态
;stderr_events_enabled=false   ; 这个也是同样，默认为false
;environment=A="1",B="2"       ; 这个是该子进程的环境变量，和别的子进程是不共享的
;serverurl=AUTO                ; 
; The below sample eventlistener section shows all possible
; eventlistener subsection values, create one or more 'real'
; eventlistener: sections to be able to handle event notifications
; sent by supervisor.

;[eventlistener:theeventlistenername] ;这个东西其实和program的地位是同样的，也是suopervisor启动的子进程，不过它干的活是订阅supervisord发送的event。他的名字就叫listener了。咱们能够在listener里面作一系列处理，好比报警等等
;command=/bin/eventlistener    ; 这个和上面的program同样，表示listener的可执行文件的路径
;process_name=%(program_name)s ; 这个也同样，进程名，当下面的numprocs为多个的时候，才须要。不然默认就,OK了
;numprocs=1                    ; 相同的listener启动的个数
;events=EVENT                  ; event事件的类型，也就是说，只有写在这个地方的事件类型。才会被发送
;buffer_size=10                ; 这个是event队列缓存大小，单位不太清楚，楼主猜想应该是个吧。当buffer, 超过10的时候，最旧的event将会被清除，并把新的event放进去。,默认值为10。。非必须选项
;directory=/tmp                ; 进程执行前，会切换到这个目录下执行,默认为不切换。。。非必须
;umask=022                     ; 淹没，默认为none，不说了
;priority=-1                   ; 启动优先级，默认-1，也不扯了
;autostart=true                ; 是否随supervisord启动一块儿启动，默认true
;autorestart=unexpected        ; 是否自动重启，和program一个样，分true,false,unexpected等，注意,unexpected和exitcodes的关系
;startsecs=1                   ; 也是同样，进程启动后跑了几秒钟，才被认定为成功启动，默认1
;startretries=3                ; 失败最大尝试次数，默认3
;exitcodes=0,2                 ; 指望或者说预料中的进程退出码，
;stopsignal=QUIT               ; 干掉进程的信号，默认为TERM，好比设置为QUIT，那么若是QUIT来干这个进程,那么会被认为是正常维护，退出码也被认为是expected中的
;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                   ;设置普通用户，能够用来管理该listener进程。默认为空。。非必须设置
;redirect_stderr=true          ; 为true的话，stderr的log会并入stdout的log里面,默认为false。。。非必须设置
;stdout_logfile=/a/path        ; 这个不说了，好几遍了
;stdout_logfile_maxbytes=1MB   ; 这个也是
;stdout_logfile_backups=10     ; 这个也是
;stdout_events_enabled=false   ; 这个实际上是错的，listener是不能发送event
;stderr_logfile=/a/path        ; 这个也是
;stderr_logfile_maxbytes=1MB   ; 这个也是
;stderr_logfile_backups        ; 这个不说了
;stderr_events_enabled=false   ; 这个也是错的，listener不能发送event
;environment=A="1",B="2"       ; 这个是该子进程的环境变量,默认为空。。。非必须设置
;serverurl=AUTO                ; override serverurl computation (childutils)
; The below sample group section shows all possible group values,
; create one or more 'real' group: sections to create "heterogeneous"
; process groups.

;[group:thegroupname]  ;这个东西就是给programs分组，划分到组里面的program。咱们就不用一个一个去操做了， 咱们能够对组名进行统一的操做。 
　　　　　　　　　　　　  ;注意：program被划分到组里面以后，就至关于原来，的配置从supervisor的配置文件里消失了。。。supervisor只会对组进行管理，而再也不会对组里面的单个program进行管理了
;programs=progname1,progname2  ; 组成员，用逗号分开，这个是个必须的设置项
;priority=999                  ; 优先级，相对于组和组之间说的，默认999。。非必须选项
; The [include] section can just contain the "files" setting.  This
; setting can list multiple files (separated by whitespace or
; newlines).  It can also contain wildcards.  The filenames are
; interpreted as relative to this file.  Included files *cannot*
; include files themselves.

;[include]                         ;这个东西挺有用的，当咱们要管理的进程不少的时候，写在一个文件里面，就有点大了。咱们能够把配置信息写到多个文件中，而后include过来
;files = relative/directory/*.ini

推荐文章

http://blog.chinaunix.net/uid-26000296-id-4759916.html