[TOC] [**Supervisor**](http://supervisord.org) 是用 Python 开发的一套通用的进程管理程序，能将一个普通的命令行进程变为后台 daemon，并监控进程状态，异常退出时能自动重启。它是通过 `fork/exec` 的方式把这些被管理的进程当作 supervisor 的子进程来启动，这样只要在 supervisor 的配置文件中，把要管理的进程的可执行文件的路径写进去即可。也实现当子进程挂掉的时候，父进程可以准确获取子进程挂掉的信息的，可以选择是否自己启动和报警。 > 官网：http://supervisord.org ## **安装** Ubuntu： ~~~shell apt install supervisor ~~~ CentOS： ~~~shell yum install supervisor ~~~ ## **配置文件** ### 创建配置文件 ~~~shell echo_supervisord_conf > /etc/supervisord.conf ~~~ _ps：需要 root 权限_ ### [unix_http_server] ~~~text file=/tmp/supervisor.sock ;UNIX socket 文件，supervisorctl 会使用 ;chmod=0700 ;socket文件的mode，默认是0700 ;chown=nobody:nogroup ;socket文件的所有者，格式：uid:gid ;username=user ; default is no username (open server) ;password=123 ; default is no password (open server) ~~~ > 修改 `file = /var/run/supervisor.sock` ### [supervisord] ~~~text [supervisord] logfile=/tmp/supervisord.log ;日志文件，默认是 $CWD/supervisord.log logfile_maxbytes=50MB ;日志文件大小，超出会rotate，默认 50MB，如果设成0，表示不限制大小 logfile_backups=10 ;日志文件保留备份数量默认10，设为0表示不备份 loglevel=info ;日志级别，默认info，其它: debug,warn,trace pidfile=/tmp/supervisord.pid ;pid 文件 nodaemon=false ;是否在前台启动，默认是false，即以 daemon 的方式启动 minfds=1024 ;可以打开的文件描述符的最小值，默认 1024 minprocs=200 ;可以打开的进程数的最小值，默认 200 ~~~ ### [supervisorctl] ~~~shell [supervisorctl] serverurl=unix:///tmp/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 in [*_http_server] if set ;password=123 ; should be same as in [*_http_server] if set ;prompt=mysupervisor ; cmd line prompt (default "supervisor") ;history_file=~/.sc_history ; use readline history if available ~~~ ### [program:xxxx] ~~~text [program:theprogramname] command=/bin/cat ; 命令路径，如果使用python启动的程序应该为 python /home/test.py process_name=%(program_name)s ; 当`numprocs`为1时,process_name=%(program_name)s；当`numprocs` >= 2时,%(program\_name)s_%(process_num)02d ;numprocs=1 ; 启动的进程数量 (def 1) ;directory=/tmp ; 执行目录 (def no cwd) 若有 /home/supervisor\_test/test1.py，则`command` 只需设置成 python test1.py，否则`command`必须设置成绝对执行目录 ;umask=022 ; 权限 (default None) ;priority=999 ; 相对启动优先级。值越高,最后启动,最先被关闭 (default 999) ;autostart=true ; 如果是true,当supervisor启动时,程序将会自动启动 (default: true) ;startsecs=1 ; # 启动延时执行 (def. 1) ;startretries=3 ; 启动尝试次数 (default 3) ;autorestart=unexpected ; 自动重启 (def: unexpected) ;exitcodes=0 ; 与自动重启一起使用的退出代码。当退出码是0,2时,执行重启 (default 0) ;stopsignal=QUIT ; 停止信号 (default TERM)。中断:INT(类似于Ctrl+C)(kill -INT pid),退出后会将写文件或日志(推荐)；终止:TERM(kill -TERM pid)；挂起:HUP(kill -HUP pid),注意与Ctrl+Z/kill -stop pid不同；从容停止:QUIT(kill -QUIT pid)；KILL, USR1, USR2其他见命令(kill -l),说明1 ;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 ; 以root用户执行 ; 重定向 ;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 (0 means none, default 10) ;stdout_capture_maxbytes=1MB ; number of bytes in 'capturemode' (default 0) ;stdout_events_enabled=false ; emit events on stdout writes (default false) ;stdout_syslog=false ; send stdout to syslog with process name (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 (0 means none, default 10) ;stderr_capture_maxbytes=1MB ; number of bytes in 'capturemode' (default 0) ;stderr_events_enabled=false ; emit events on stderr writes (default false) ;stderr_syslog=false ; send stderr to syslog with process name (default false) ;environment=A="1",B="2" ; 环境变量设置 (def no adds) ;serverurl=AUTO ; override serverurl computation (childutils) ~~~ 详细：http://supervisord.org/configuration.html#program-x-section-settings ### inet_http_server 可以使用浏览器查看和控制进程状态 ~~~shell [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 ; 用户名 (open server) password=123 ; 密码 (open server) ~~~ > 更多配置：http://supervisord.org/configuration.html ## **常用命令** ~~~shell supervisord -c /etc/supervisord.conf # 启动 supervisor ，如果不指定 `-c` 参数，则加载其安装目录下的 supervisord.conf 文件 supervisorctl status # 查看所有进程的状态 supervisorctl start <process_name> # 启动 一个进程 supervisorctl stop <process_name> # 停止一个进程，`<process_name>`：配置文件中定义的名称 supervisorctl restart # 重启，不会重新读取配置文件 supervisorctl update # 重新加载配置并根据需要添加/删除，并将重新启动受影响的程序 supervisorctl reload # 重新启动配置中的所有程序 supervisorctl reread # 重新加载守护进程的配置文件，不需要添加/删除(不重启) ~~~ > 官网提醒： > 当**supervisord**启动时，它将在默认位置搜索其配置文件，*包括当前工作目录*。如果您有安全意识，您可能希望在**supervisord**命令指定配置文件的绝对路径后指定一个“-c”参数，以确保有人不会欺骗您从包含流氓的目录中运行 supervisorsupervisord.conf文件。当supervisor 以root 身份启动而没有这个\-c参数时，会发出警告。 ## **管理 Laravel 队列进程** 1. 修改 `/etc/supervisord.conf` ~~~text [include] files = /etc/supervisor/conf.d*.conf ~~~ 2. 创建 `/etc/supervisor/conf.d/laravel-worker.conf` ~~~text [program:laravel-worker] process_name=%(program_name)s_%(process_num)02d command=php /usr/share/nginx/html/tanteng.me/artisan queue:work --tries=3 autostart=true autorestart=true user=root numprocs=8 redirect_stderr=true stdout_logfile=/var/log/supervisor/laravel-queue.log ~~~ > `user` 设置为 `root` 或当前运行命令的用户 3. 启动 supervisor / 重载配置 ~~~shell sudo supervisord -c /etc/supervisord.conf ~~~ 如果已经启动，则重载配置 ~~~shell sudo supervisorctl reread ~~~ 4. 启动队列进程的监听 ~~~shell sudo supervisorctl start laravel-worker:* ~~~ 5. 查看启动的进程 ~~~shell admin_s@SC-201811011347:/etc/supervisor$ ps aux |grep 'laravel' root 108 0.1 0.3 88928 40332 ? S 08:53 0:01 php /mnt/d/phpStudy/PHPTutorial/WWW/laravel_workerman/artisan queue:work --tries=3 root 109 0.1 0.3 88928 40388 ? S 08:53 0:01 php /mnt/d/phpStudy/PHPTutorial/WWW/laravel_workerman/artisan queue:work --tries=3 root 110 0.1 0.3 88928 40476 ? S 08:53 0:01 php /mnt/d/phpStudy/PHPTutorial/WWW/laravel_workerman/artisan queue:work --tries=3 root 111 0.1 0.3 88928 40528 ? S 08:53 0:01 php /mnt/d/phpStudy/PHPTutorial/WWW/laravel_workerman/artisan queue:work --tries=3 root 112 0.1 0.3 88928 40572 ? S 08:53 0:01 php /mnt/d/phpStudy/PHPTutorial/WWW/laravel_workerman/artisan queue:work --tries=3 root 113 0.1 0.3 88928 40572 ? S 08:53 0:01 php /mnt/d/phpStudy/PHPTutorial/WWW/laravel_workerman/artisan queue:work --tries=3 root 114 0.1 0.3 88928 40320 ? S 08:53 0:01 php /mnt/d/phpStudy/PHPTutorial/WWW/laravel_workerman/artisan queue:work --tries=3 root 115 0.1 0.3 88928 40428 ? S 08:53 0:01 php /mnt/d/phpStudy/PHPTutorial/WWW/laravel_workerman/artisan queue:work --tries=3 root 193 1.6 0.3 88928 40552 ? S 09:06 0:01 php /mnt/d/phpStudy/PHPTutorial/WWW/laravel_workerman/artisan queue:work --tries=3 root 194 1.3 0.3 88928 40500 ? S 09:06 0:00 php /mnt/d/phpStudy/PHPTutorial/WWW/laravel_workerman/artisan queue:work --tries=3 root 195 1.8 0.3 88928 40584 ? S 09:06 0:01 php /mnt/d/phpStudy/PHPTutorial/WWW/laravel_workerman/artisan queue:work --tries=3 root 196 1.6 0.3 88928 40644 ? S 09:06 0:01 php /mnt/d/phpStudy/PHPTutorial/WWW/laravel_workerman/artisan queue:work --tries=3 root 197 1.3 0.3 88928 40424 ? S 09:06 0:00 php /mnt/d/phpStudy/PHPTutorial/WWW/laravel_workerman/artisan queue:work --tries=3 root 198 1.7 0.3 88928 40780 ? S 09:06 0:01 php /mnt/d/phpStudy/PHPTutorial/WWW/laravel_workerman/artisan queue:work --tries=3 root 199 1.6 0.3 88928 40696 ? S 09:06 0:01 php /mnt/d/phpStudy/PHPTutorial/WWW/laravel_workerman/artisan queue:work --tries=3 root 200 2.0 0.3 88928 40624 ? S 09:06 0:01 php /mnt/d/phpStudy/PHPTutorial/WWW/laravel_workerman/artisan queue:work --tries=3 ~~~