解放程序員雙手之Supervisor

 

前言

 

對於大部分程序員來講，主要工做都是進行編碼以及一些簡單的中間件安裝，這就致使了不少人對於「運維」相關的工做會比較生疏。例如當咱們擁有一臺本身的服務器之後，可能會在上面跑一跑本身blog程序，mysql，nginx等等。當程序愈來愈多了沒有一個統一的入口管理啓停，也可能會遇到一些特殊的緣由致使程序被kill掉了，這時候又沒裝相關的監控程序或者腳本（太麻煩了懶得裝，機器配置差不想裝），因此只能當咱們訪問本身程序發現異常的時候纔會登上服務器查找緣由。

 

這些情況對咱們來講是比較麻煩的，那麼這就須要一個「神器」來解放咱們的雙手，鐺鐺鐺！！Supervisor 就來了。

 

正文

 

Supervisor 介紹

 

Supervisor是用Python開發的一套通用的進程管理程序，能將一個普通的命令行進程變爲後臺daemon，並監控進程狀態，異常退出時能自動重啓。它是經過fork/exec的方式把這些被管理的進程看成supervisor的子進程來啓動，這樣只要在supervisor的配置文件中，把要管理的進程的可執行文件的路徑寫進去便可。也實現當子進程掛掉的時候，父進程能夠準確獲取子進程掛掉的信息的，能夠選擇是否本身啓動和報警。

 

supervisor 安裝

 

簡單粗暴

 

yum install supervisor -y

 

supervisor 配置說明

 

經過這種形式安裝的supervisor，其配置文件的目錄位於：
/etc/supervisord.conf (主配置文件，下面會詳細介紹)
/etc/supervisor.d/ (默認子進程配置文件，也就是須要咱們根據程序配置的地方)

 

---

 

supervisord.conf 基本配置項說明，因爲其參數比較多，這些只貼出一些經常使用的配置項，詳細內容可參閱官網。舒適提示「;」 符號是表示該行配置被註釋。

 

[unix_http_server]
file=/home/supervisor/supervisor.sock   ; supervisorctl使用的 socket文件的路徑
;chmod=0700                 ; 默認的socket文件權限0700
;chown=nobody:nogroup       ; socket文件的擁有者

[inet_http_server]         ; 提供web管理後臺管理相關配置
port=0.0.0.0:9001          ; web管理後臺運行的ip地址及端口，綁定外網需考慮安全性 
;username=root             ; web管理後臺登陸用戶名密碼
;password=root

[supervisord]
logfile=/var/log/supervisord.log ; 日誌文件，默認在$CWD/supervisord.log
logfile_maxbytes=50MB        ; 日誌限制大小，超過會生成新文件，0表示不限制
logfile_backups=10           ; 日誌備份數量默認10，0表示不備份
loglevel=info                ; 日誌級別
pidfile=/home/supervisor/supervisord.pid ; supervisord pidfile; default supervisord.pid              ; pid文件
nodaemon=false               ; 是否在前臺啓動，默認後臺啓動false
minfds=1024                  ; 能夠打開文件描述符最小值
minprocs=200                 ; 能夠打開的進程最小值

[supervisorctl]
serverurl=unix:///home/supervisor/supervisor.sock ; 經過socket鏈接supervisord,路徑與unix_http_server->file配置的一致

　

[include]
files = supervisor.d/*.conf ;指定了在當前目錄supervisor.d文件夾下配置多個配置文件

　　

準備測試項目

 

這裏我打包了一個簡單的spring-boot程序，存放與「/opt/project/」下。

在這個程序中咱們只是簡單的定義了一個rest接口，主要用於演示做用。

@RestController
public class HelloController {

    @RequestMapping("/hello")
    public String hello(){
        return "hello world";
    }
}

 

若是不用supervisor的話，咱們啓動程序通常用一下命令

nohup java -jar springboot-hello-sample.jar &

 

這是之後臺的方式啓動jar包，程序運行相關輸出會在nohup.out中，咱們咱們就再也不贅述了，那麼咱們來看一下，切換到supervisor的方式，咱們是怎麼配置項目，以及管理的呢？

 

定義supervisor管理進程配置文件

 

從上面的配置文件[include]->files配置項咱們能夠知道，supervisor會把supervisor.d/下以conf結尾的配置文件都加載進來，那麼咱們在這個目錄下面新建一個sboot.conf,內容以下：

[program:sboot] ;[program:xxx] 這裏的xxx是指的項目名字
directory = /opt/project  ;程序所在目錄
command =  java -jar springboot-hello-sample.jar ;程序啓動命令
autostart=true ;是否跟隨supervisord的啓動而啓動
autorestart=true; 程序退出後自動重啓,可選值：[unexpected,true,false]，默認爲unexpected，表示進程意外殺死後才重啓
stopasgroup=true;進程被殺死時，是否向這個進程組發送stop信號，包括子進程
killasgroup=true;向進程組發送kill信號，包括子進程
stdout_logfile=/var/log/sboot/supervisor.log;該程序日誌輸出文件，目錄須要手動建立
stdout_logfile_maxbytes = 50MB;日誌大小
stdout_logfile_backups  = 100;備份數

 

能夠看到，在配置文件裏面已經有配置該程序名，啓動路徑等，這樣一來，supervisor就能夠徹底的掌管程序的生死了。接着咱們執行

service supervisord restart

重啓supervisord。

 

觀察效果

瀏覽器輸入:服務器ip:9001 （這裏的web管理頁面端口是在配置文件配置好的。）

 

 

如圖所示，咱們能夠能夠觀察到springboot程序已是running狀態了，pid是27517，咱們能夠點擊Tail -f來觀察輸出日誌，它的做用跟咱們在服務器直接「tail -f」是相似的。

 

 

這裏咱們爲了方便演示就沒有添加驗證了，若是你們是在公網的使用環境，須要配置文件裏面的用戶名密碼驗證註釋打開。否則別人掃出你的後臺管理頁面就能夠隨意控制程序了。

除了web管理頁面，還有一些簡單的命令也是須要咱們掌握的。

直接在命令行輸入supervisorctl會展現當前已配置好的項目信息。

 

[root@wangzh supervisor.d]# supervisorctl
sboot                            RUNNING   pid 27517, uptime 0:18:04
supervisor>

 

而後能夠執行

start/stop/restart sboot 來簡單控制項目的啓停等

　　

其餘經常使用命令

supervisorctl update #更新配置文件
supervisorctl reload #從新啓動配置的程序
supervisorctl stop all #中止所有管理進程

　　

結語

只須要一點簡單的配置，就能夠統一的管理咱們的程序了，同時也能夠在進程意外死掉的時候自動重啓，這些工做之後就交給supervisor了，咱們只要掌握一點簡單的命令就能夠「隨心所欲」。

supervisor官網：http://www.supervisord.org/

文章首發於微信公衆號《深夜裏的程序猿》，轉載務必註明出處，侵權必究。