supervisor program配置實例


program 配置

上面我們已經把 supervisrod 運行起來了,現在可以添加我們要管理的進程的配置文件。可以把所有配置項都寫到 supervisord.conf 文件里,但並不推薦這樣做,而是通過 include 的方式把不同的程序(組)寫到不同的配置文件里。

為了舉例,我們新建一個目錄 /etc/supervisor/ 用於存放這些配置文件,相應的,把 /etc/supervisord.conf 里 include 部分的的配置修改一下:

[include] files = /etc/supervisor/*.conf 

假設有個用 Python 和 Flask 框架編寫的用戶中心系統,取名 usercenter,用 gunicorn (http://gunicorn.org/) 做 web 服務器。項目代碼位於 /home/leon/projects/usercenter,gunicorn 配置文件為gunicorn.py,WSGI callable 是 wsgi.py 里的 app 屬性。所以直接在命令行啟動的方式可能是這樣的:

cd /home/leon/projects/usercenter gunicorn -c gunicorn.py wsgi:app 

現在編寫一份配置文件來管理這個進程(需要注意:用 supervisord 管理時,gunicorn 的 daemon 選項需要設置為 False):

[program:usercenter] directory = /home/leon/projects/usercenter ; 程序的啟動目錄 command = gunicorn -c gunicorn.py wsgi:app ; 啟動命令,可以看出與手動在命令行啟動的命令是一樣的 autostart = true ; 在 supervisord 啟動的時候也自動啟動 startsecs = 5 ; 啟動 5 秒后沒有異常退出,就當作已經正常啟動了 autorestart = true ; 程序異常退出后自動重啟 startretries = 3 ; 啟動失敗自動重試次數,默認是 3 user = leon ; 用哪個用戶啟動 redirect_stderr = true ; 把 stderr 重定向到 stdout,默認 false stdout_logfile_maxbytes = 20MB ; stdout 日志文件大小,默認 50MB stdout_logfile_backups = 20 ; stdout 日志文件備份數 ; stdout 日志文件,需要注意當指定目錄不存在時無法正常啟動,所以需要手動創建目錄(supervisord 會自動創建日志文件) stdout_logfile = /data/logs/usercenter_stdout.log ; 可以通過 environment 來添加需要的環境變量,一種常見的用法是修改 PYTHONPATH ; environment=PYTHONPATH=$PYTHONPATH:/path/to/somewhere 

一份配置文件至少需要一個 [program:x] 部分的配置,來告訴 supervisord 需要管理那個進程。[program:x] 語法中的 x 表示 program name,會在客戶端(supervisorctl 或 web 界面)顯示,在 supervisorctl 中通過這個值來對程序進行 start、restart、stop 等操作。

使用 supervisorctl

Supervisorctl 是 supervisord 的一個命令行客戶端工具,啟動時需要指定與 supervisord 使用同一份配置文件,否則與 supervisord 一樣按照順序查找配置文件。

supervisorctl -c /etc/supervisord.conf

上面這個命令會進入 supervisorctl 的 shell 界面,然后可以執行不同的命令了:

> status    # 查看程序狀態 > stop usercenter # 關閉 usercenter 程序 > start usercenter # 啟動 usercenter 程序 > restart usercenter # 重啟 usercenter 程序 > reread # 讀取有更新(增加)的配置文件,不會啟動新添加的程序 > update # 重啟配置文件修改過的程序 

上面這些命令都有相應的輸出,除了進入 supervisorctl 的 shell 界面,也可以直接在 bash 終端運行:

$ supervisorctl status
$ supervisorctl stop usercenter
$ supervisorctl start usercenter
$ supervisorctl restart usercenter
$ supervisorctl reread
$ supervisorctl update 

其它

除了 supervisorctl 之外,還可以配置 supervisrod 啟動 web 管理界面,這個 web 后台使用 Basic Auth 的方式進行身份認證。

除了單個進程的控制,還可以配置 group,進行分組管理。

經常查看日志文件,包括 supervisord 的日志和各個 pragram 的日志文件,程序 crash 或拋出異常的信息一半會輸出到 stderr,可以查看相應的日志文件來查找問題。

 

比如說,我現在啟動一個我本機上的logstash

cd /etc/supervisord.d

vim logstash.conf

[program:logstash]
command=/opt/logstash/bin/logstash -f /opt/logstash/conf/zabbix.conf -l /opt/logstash/logs/zabbix.log
numprocs=1
autostart=true
autorestart=true
log_stdout=true
log_stderr=true

 


免責聲明!

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



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