程序管理工具 -- supervisor使用詳解

簡介

supervisord是一個程序管理工具，可以把其它程序當作supervisord的子程序進行管理，主要功能包括對子程序的狀态監控、子程序異常自動重新開機、子程序異常資訊收集等功能。

安裝supervisor

首先切換為root使用者然後使用yum指令安裝

yum install epel-release
           

yum install -y supervisor
           

或者

easy_install supervisor
           

檢視配置檔案

安裝supervisor後會自動生成一個預設的supervisord.conf檔案，可以直接使用該配置檔案，一般的功能都可以使用

cat /etc/supervisord.conf
           

; Sample supervisor config file.
[unix_http_server]
file=/var/run/supervisor/supervisor.sock ; (the path to the socket file) ;UNIX socket 檔案，supervisorctl 會使用
;chmod=0700 ; sockef file mode (default 0700) ;socket檔案的mode，預設是0700
;chown=nobody:nogroup ; socket file uid:gid owner ;socket檔案的owner，格式：uid:gid
;username=user ; (default is no username (open server))
;password=123 ; (default is no password (open server))
file = /tmp/supervisor.sock
chmod = 0777
username = admin
password = 12345

[inet_http_server] ;HTTP伺服器，提供web管理界面
port = *:9001;Web管理背景運作的IP和端口，如果開放到公網，需要注意安全性
username = admin;登入管理背景的使用者名
password = 12345 ;登入管理背景的密碼
;[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=/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=/var/run/supervisord.pid ; (supervisord pidfile;default supervisord.pid)
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)
user = root
;umask=022                  ; (process file creation umask;default 022)
;user=chrism                 ; (default is current user, required if root)
;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)

; 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]
supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface

[supervisorctl]
;serverurl=unix:///var/run/supervisor/supervisor.sock ; use a unix:// URL  for a unix socket
serverurl=unix:///tmp/supervisor.sock
username = admin
password = 12345
prompt = admin user
;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
;prompt=mysupervisor         ; cmd line prompt (default "supervisor")
;history_file=~/.sc_history  ; use readline history if available


[include] ;包含其它配置檔案
files = supervisord.d/*.ini;可以指定一個或多個以.ini結束的配置檔案
           

子程序的配置檔案

子程序的配置檔案應該放在/etc/supervisord.d目錄下，一般是以.ini檔案為字尾的，和supervisord.conf中的[include] 比對（也可以定義為.conf字尾名檔案）

[program:pinserver];程序名
command=/usr/java/jdk1.8.0_171/bin/java -Xms64m -Xmx128m -jar /opt/pin-server/web-0.0.1-SNAPSHOT.war--spring.profiles.active=prod,ext--server.port=8080 ; 程式啟動指令
autostart=true; 在supervisord啟動的時候也自動啟動
startsecs=10 ; 啟動10秒後沒有異常退出，就表示程序正常啟動了，預設為1秒
autorestart=false; 程式退出後自動重新開機,可選值：[unexpected,true,false]，預設為unexpected，表示程序意外殺死後才重新開機
startretries=3 ; 啟動失敗自動重試次數，預設是3
user=root ; 用哪個使用者啟動程序，預設是root
priority=999; 程序啟動優先級，預設999，值小的優先啟動
redirect_stderr=true ; 把stderr重定向到stdout，預設false
stdout_logfile_maxbytes=10MB ; stdout 日志檔案大小，預設50MB
stdout_logfile_backups = 20 ; stdout 日志檔案備份數，預設是10
; stdout 日志檔案，需要注意當指定目錄不存在時無法正常啟動，是以需要手動建立目錄（supervisord 會自動建立日志檔案）
stdout_logfile=/opt/pin-server/logs/java8080.out
stderr_logfile=/opt/pin-server/logs/java8080err.out
stderr_logfile_maxbytes=10MB
stderr_logfile_backups=20
stderr_capture_maxbytes=1MB
stderr_events_enabled=false
stopasgroup=false ;預設為false,程序被殺死時，是否向這個程序組發送stop信号，包括子程序
killasgroup=false;預設為false，向程序組發送kill信号，包括子程序

           

管理supervisor程序的常用指令

啟動supervisor，-c指定讓其讀取的配置檔案

supervisord -c /etc/supervisord.conf
           

關閉supervisor

設定supervisor開機自動啟動

systemctl enable supervisord.service
           

啟動supervisor程序

systemctl start supervisord.service
           

關閉supervisor程序

systemctl stop supervisord.service
           

配置檔案修改後可以使用該指令加載新的配置

supervisorctl update 
           

管理supervisor子程序的常用指令

檢視子程序狀态

supervisorctl status
           

啟動子程序

supervisorctl -c /etc/supervisord.conf start pinserver
           

停止子程序

supervisorctl -c /etc/supervisord.conf stop pinserver
           

重新開機子程序

supervisorctl -c /etc/supervisord.conf restart pinserver
           

啟動所有子程序

supervisorctl -c /etc/supervisord.conf start all
           

停止所有子程序

supervisorctl -c /etc/supervisord.conf stop all
           

子程序定時重新開機任務

crontab -e
           

1 0 * * * supervisorctl -c /etc/supervisord.conf restart pinserver
           

每天24點01分重新開機定時任務

crontab 檔案的格式：

{minute} {hour} {day-of-month} {month} {day-of-week} {full-path-to-shell-script}

• minute: 區間為 0 – 59
• hour: 區間為0 – 23
• day-of-month: 區間為0 – 31
• month: 區間為1 – 12. 1 是1月. 12是12月.
• Day-of-week: 區間為0 – 7. 周日可以是0或7.