天天看點

supervisor學習記錄

1.supervisor 簡介

Supervisor 是用Python開發的一個client/server服務,是Linux/Unix系統下的一個程序管理工具,不支援Windows系統。它可以很友善的監聽、啟動、停止、重新開機一個或多個程序。用Supervisor管理的程序,當一個程序意外被殺死,supervisort監聽到程序死後,會自動将它重新拉起,很友善的做到程序自動恢複的功能,不再需要自己寫shell腳本來控制

2. supervisor 安裝

sudo apt-get install supervisor
           

supervisor安裝完成後會生成三個執行程式:supervisortd、supervisorctl、echo_supervisord_conf,分别是supervisor的守護程序服務(用于接收程序管理指令)、用戶端(用于和守護程序通信,發送管理程序的指令)、生成初始配置檔案程式.

3.生成配置檔案

echo_supervisord_conf > /etc/supervisor/supervisord.conf
           

4. 配置檔案參數說明

[unix_http_server]
file=/tmp/supervisor.sock   ;UNIX socket 檔案,supervisorctl 會使用
;chmod=0700                 ;socket檔案的mode,預設是0700
;chown=nobody:nogroup       ;socket檔案的owner,格式:uid:gid

;[inet_http_server]         ;HTTP伺服器,提供web管理界面
;port=127.0.0.1:9001        ;Web管理背景運作的IP和端口,如果開放到公網,需要注意安全性
;username=user              ;登入管理背景的使用者名
;password=123               ;登入管理背景的密碼

[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]
serverurl=unix:///tmp/supervisor.sock ;通過UNIX socket連接配接supervisord,路徑與unix_http_server部分的file一緻
;serverurl=http://127.0.0.1:9001 ; 通過HTTP的方式連接配接supervisord

; [program:xx]是被管理的程序配置參數,xx是程序的名稱
[program:xx]
command=/opt/apache-tomcat-8.0.35/bin/catalina.sh run  ; 程式啟動指令
autostart=true       ; 在supervisord啟動的時候也自動啟動
startsecs=10         ; 啟動10秒後沒有異常退出,就表示程序正常啟動了,預設為1秒
autorestart=true     ; 程式退出後自動重新開機,可選值:[unexpected,true,false],預設為unexpected,表示程序意外殺死後才重新開機
startretries=3       ; 啟動失敗自動重試次數,預設是3
user=tomcat          ; 用哪個使用者啟動程序,預設是root
priority=999         ; 程序啟動優先級,預設999,值小的優先啟動
redirect_stderr=true ; 把stderr重定向到stdout,預設false
stdout_logfile_maxbytes=20MB  ; stdout 日志檔案大小,預設50MB
stdout_logfile_backups = 20   ; stdout 日志檔案備份數,預設是10
; stdout 日志檔案,需要注意當指定目錄不存在時無法正常啟動,是以需要手動建立目錄(supervisord 會自動建立日志檔案)
stdout_logfile=/opt/apache-tomcat-8.0.35/logs/catalina.out
stopasgroup=false     ;預設為false,程序被殺死時,是否向這個程序組發送stop信号,包括子程序
killasgroup=false     ;預設為false,向程序組發送kill信号,包括子程序

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

5. 配置管理程序

程序管理配置參數,不建議全都寫在supervisord.conf檔案中,應該每個程序寫一個配置檔案放在include指定的目錄下包含進supervisord.conf檔案中。 修改/etc/supervisor/supervisord.conf中的include參數,将/etc/supervisor/conf.d目錄添加到include中(關于*.ini,大部分資料用的都是*.conf格式作為配置檔案。這個地方建議大家也都用*.conf不要用*.ini)

[include]
files = /etc/supervisor/conf.d/*.ini
改為
[include]
files = /etc/supervisor/conf.d/*.conf
           

在conf.d檔案夾下建立tomcat.conf檔案,向其添加

[program:tomcat]
command=/opt/tomcat/bin/catalina.sh run # catalina.sh 目錄
environment=JAVA_HOME="/usr/local/jdk/",JAVA_BIN="/usr/local/jdk/bin" # java目錄
directory=/opt/tomcat # Tomcat的根目錄
autostart = true
autorestart=true
redirect_stderr=true
stopasgroup=true
killasgroup=true
           

注意

關于在command中,執行.sh腳本 請參照此配置檔案中command的寫法,直接寫command=source xxx,會報source不認識:

[program:blog]
command=/bin/bash -c 'source /var/ftp_root/program/blog/startall.sh'
user=root
autostart=true
autorestart=true
redirect_stderr=True
stdout_logfile=/tmp/blog.log
stderr_logfile=/tmp/blog.err
stopasgroup=true
killasgroup=true
           

6. 啟動supervisor 服務

supervisord -c /etc/supervisor/supervisord.conf
           

7. 控制程序

  • 7.1 互動終端

    supervisord啟動成功後,可以通過supervisorctl用戶端控制程序,啟動、停止、重新開機。運作supervisorctl指令,不加參數,會進入supervisor用戶端的互動終端,并會列出目前所管理的所有程序。

supervisor學習記錄

輸入help可以檢視可以執行的指令清單,如果想看某個指令的作用,運作help 指令名稱,如:help stop

stop tomcat  // 表示停止tomcat程序
stop all     // 表示停止所有程序
...
           
  • 7.2 supervisor的常用指令
supervisorctl status #檢視所管理的程序狀态
# 在修改好配置檔案之後使用下面兩個指令進行更新
supervisorctl reread  
supervisorctl update
#重新啟動配置中的所有程式
supervisorctl reload  
啟動某個程序(program_name=你配置中寫的程式名稱)
supervisorctl start program_name  
檢視正在管理的程序
supervisorctl  
# 停止某一程序 (program_name=你配置中寫的程式名稱)
supervisorctl stop program_name  
# 停止全部程序
supervisorctl stop all  

           
  • 7.3 web管理頁面

于安全考慮,預設配置是沒有開啟web管理界面,需要修改supervisord.conf配置檔案打開http訪權限,将下面的配置:

;[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))

改為

[inet_http_server]         ; inet (TCP) server disabled by default
port=0.0.0.0: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))
           

port:綁定通路IP和端口,這裡是綁定的是本地IP和9001端口 ,注意要把127.0.0.1修改成0.0.0.0,否則外網通路不了。

username:登入管理背景的使用者名

password:登入管理背景的密碼

8. supervisor開機自啟

編輯/etc/rc.local檔案,在 exit 0 之前加入以下指令

service supervisor start
           

或者

使用supervisor 官方開機啟動腳本 https://github.com/Supervisor/initscripts

繼續閱讀