supervisor 安裝配置及使用


為了更加便捷方便的管理RabbitMQ進程,了解Supervisor的安裝及使用,是必不可少的有效方法。

什么是supervisor

supervisor是用python寫的一個進程管理工具,用來啟動,重啟,關閉進程。

安裝Supervisor

#我的安裝環境是windows下WSL, ubuntu系統。
apt install supervisor

安裝完成,簡單了解一下supervisord 和 supervisorctl

supervisord 是 supervisor的守護進程服務(服務端),主要用於接收進程的管理命令。

#當運行supervisord的時候,它將在默認位置(包括當前工作目錄)中搜索其配置文件,如果有安全意識,可以通過“-c” 來指定配置文件的絕對路徑。
supervisord -c /etc/supervisord.conf (在此之前需要配置supervisord.conf)
supervisord 常用命令行選項:
短命令 長命令 說明
-c FILE --configuration=FILE 配置文件的路徑
-h --help 命令幫助
-l FILE --logfile=FILE 用作監督活動日志的文件名路徑
-y BYTES --logfile_maxbytes=BYTES 輪換之前,受監管日志文件的最大大小。該值后綴乘以,例如“ 1”是一個字節,“ 1MB”是1兆字節,“ 1GB”是1千兆字節。
-z NUM --logfile_backups=NUM 要保留的受監督日志的備份副本數。每個日志文件的大小為logfile_maxbytes
-e LEVEL --loglevel=LEVEL 記錄日志的級別,分別是trace, debug, info, warn, error, and critical

更多命令查看官方文檔

supervisorctl 是 supervisor的客戶端,用於和守護進程通信,發送管理進程的指令。

要啟動supervisorctl,請運行$ BINDIR / supervisorctl。將提供一個shell,使您可以控制supervisor當前管理的過程。在提示符下鍵入“ help”以獲取有關支持的命令的信息。
supervisorctl 常用命令選項:
短命令 長命令 說明
-c FILE --configuration=FILE 配置文件的路徑
-h --help 打印使用情況消息並退出
-i --interactive 執行命令后啟動交互式Shell
-s --serverurl URL 管服務器正在偵聽的URL(默認為“ http:// localhost:9001 ”)。
-u --username 用於服務器身份驗證的用戶名
-p --password 用於服務器驗證的密碼
-r --history-file 保留閱讀行歷史記錄

更多命令查看官方文檔

運行supervisorctl:
supervisorctl -c /etc/supervisord.conf
supervisorctl 操作命令:
命令 說明 樣例
help 打印可用動作列表 help add/start/restart ...
add 激活配置中進程/組的任何更新 add
remove 從活動配置中刪除進程/組 remove
update 重新加載配置並根據需要添加/刪除,並將重新啟動受影響的程序 update
update all 重新加載配置並根據需要添加/刪除,並將重新啟動受影響的程序 update all
update 更新特定的組 update
clear 清除進程的日志文件 clear test

更多命令查看官方文檔

看一下Supervisord.conf文件內容

生成supervisord.conf文件的前提:

Supervisor安裝完成后,運行 echo_supervisord_conf。這會將“樣本” Supervisor配置文件打印到終端的標准輸出。

一旦看到文件回顯到終端,請重新調用命令 echo_supervisord_conf > /etc/supervisord.conf。如果您沒有root用戶訪問權限,則無法使用。

如果你沒有root訪問權限,或者你不想把 supervisord.conf文件/etc/supervisord.conf,你可以將它放在當前目錄(echo_supervisord_conf > supervisord.conf),並開始supervisord與 - c標志以指定配置文件位置。

例如,supervisord -c supervisord.conf。使用-c 標志其實就是在這種情況下多余的,因為 supervisord搜索當前目錄下的 supervisord.conf之前,它會搜索該文件的任何其他地方,但它會奏效。有關-c標志的更多信息

配置文件內容說明
#配置文件分為幾部分:
[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=/bin/cat     ; 程序啟動命令
autostart=true       ; 在supervisord啟動的時候也自動啟動
startsecs=10         ; 啟動10秒后沒有異常退出,就表示進程正常啟動了,默認為1秒
autorestart=true     ; 程序退出后自動重啟,可選值:[unexpected,true,false],默認為unexpected,表示進程意外殺死后才重啟
startretries=3       ; 啟動失敗自動重試次數,默認是3
user=root            ; 用哪個用戶啟動進程,默認是root
priority=999         ; 進程啟動優先級,默認999,值小的優先啟動
redirect_stderr=true ; 把stderr重定向到stdout,默認false
stdout_logfile_maxbytes=20MB  ; stdout 日志文件大小,默認50MB
stdout_logfile_backups = 20   ; stdout 日志文件備份數,默認是10
stdout_logfile=/a/path ; stdout 日志文件,需要注意當指定目錄不存在時無法正常啟動,所以需要手動創建目錄(supervisord 會自動創建日志文件)
stopasgroup=false     ;默認為false,進程被殺死時,是否向這個進程組發送stop信號,包括子進程
killasgroup=false     ;默認為false,向進程組發送kill信號,包括子進程

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

測試

修改/etc/supervisord.conf文件
[include]
files = /etc/supervisor/conf.d/*.conf
添加運行的程序
[program:test]
command=php index.php  # 運行命令    
directory=/tmp/        # 運行文件目錄
autostart=true         # 自動啟動
startsecs=2            # 啟動10秒后沒有異常退出,就表示進程正常啟動了,默認為1秒
startretries=3         # 啟動失敗自動重試次數,默認是3  
stopsignal=TERM        # 請求停止時用於終止程序的信號。可以是TERM,HUP,INT,QUIT,KILL,USR1或USR2中的任何一個  

運行supervisord、supervisorctl
# 運行supervisord
supervisord -c /etc/supervisord.conf

# 運行supervisorctl
supervisorctl -c /etc/supervisord.conf
查看腳本運行狀態
foo                              RUNNING   pid 80, uptime 1:58:59
test                             RUNNING   pid 339, uptime 0:00:08

可以通過RUNNING 看出test正在運行;

管理進程的命令
stop test # 停止test進程
start test # 運行test進程
...

以上就可以管理進程了

遇到的問題

1. 操作supervisorctl 查看沒有test進程
問題原因在於:[include] 沒有打開,謹記!!!。 
2.Unlinking stale socket /tmp/supervisor.sock
unlink /tmp/supervisor.sock


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM