supervisor program配置實例

program 配置

上面咱們已經把 supervisrod 運行起來了,如今能夠添加咱們要管理的進程的配置文件。能夠把全部配置項都寫到 supervisord.conf 文件裏,但並不推薦這樣作,而是經過 include 的方式把不一樣的程序(組)寫到不一樣的配置文件裏。web

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

[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 屬性。因此直接在命令行啓動的方式多是這樣的:vim

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

如今編寫一份配置文件來管理這個進程(須要注意:用 supervisord 管理時,gunicorn 的 daemon 選項須要設置爲 False):bash

[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 同樣按照順序查找配置文件。app

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 的方式進行身份認證。ui

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

常常查看日誌文件,包括 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

相關文章
相關標籤/搜索