行程管理工具 Supervisor

要想在終端后臺常駐行程，首先想到的是在命令后加 & 符號，來達到隱藏程式在后臺的目的，盡管看起來行程已經在后臺運行了，實際上終端會話關閉時行程還是會被 kill 掉，這種問題一般是采用搭配 nohup 命令來解決的，nohup 作用是忽略 SIGHUP 信號，而會話關閉時正好發送了該信號給會話內所有運行程式，簡而言之，nohup 命令搭配 & 不僅可以在后臺運行，還不受會話關閉的影響，

$ nohup /bin/cat &

那么問題來了，雖然做到了后臺運行，也避免了掛斷操作帶來的影響，但是它避免不了常駐行程自己出現問題，一旦它因自身例外終止了行程，這對黃金搭檔就無力回天了，那怎么才能把掛了的常駐行程拉起來呢？這就是我們要講的主題 Supervisor，

Supervisor 介紹

Supervisor 是專門用來在類 Unix 系統上監控管理行程的工具，發布于 2004 年，雖然名字氣勢磅礴，但它的志向并不是統籌整個作業系統的行程，而是致力于做一個聽話的貼身助理，你只需要告訴它要管理的程式，它就按你的要求監控行程，救死扶傷，保證行程的持續運行，

類 Unix 系統就是由 Unix 設計風格演變出的作業系統，除了 Windows 市面上絕大多數系統都是類 Unix 系統，

官方檔案介紹 Supervisor 是 C/S 架構體系，它對應的角色分別為 Supervisorctl 和 Supervisord，后者的主要作用是啟動配置好的程式、回應 Supervisorctl 發過來的指令以及重啟退出的子行程，而前者是 Supervisor 的客戶端，它以命令列的形式提供了一系列引數，來方便用戶向 Supervisord 發送指令，常用的有啟動、暫停、移除、更新等命令，

Supervisor 安裝與配置

安裝 Supervisor 很簡單，在各大作業系統的軟體包管理器中都可以直接安裝，

$ yum install -y supervisor

安裝好的 Supervisor 組態檔默認為 /etc/supervisor.conf，如果找不到組態檔可以通過官方命令生成，該組態檔包含了一個空的配置目錄 /etc/supervisor.d（不同 OS 可能不一樣），只需在該目錄添加組態檔即可動態擴展，所以 supervisor.conf 一般不需要做改動，

我們以最簡單的 cat 命令為例，cat 命令不加引數會阻塞住等待標準輸入，所以很適合做常駐行程的演示，現在創建一個組態檔 cat.ini 到 /etc/supervisor.d/，第一行定義程式的名稱，該名稱用來做操作的標識，第二行定義命令路徑，它才是程式執行的根本命令，

[program:foo]
command=/bin/cat

配置好后，啟動 supervisord 服務，注意通過 -c 指定 supervisor 的組態檔，

$ supervisord -c /etc/supervisord.conf

當然也可以不指定配置路徑，那么它會按以下順序逐個搜索組態檔：

• $CWD/supervisord.conf
• $CWD/etc/supervisord.conf
• /etc/supervisord.conf
• /etc/supervisor/supervisord.conf
• ../etc/supervisord.conf
• ../supervisord.conf

如果你是通過 Mac OS 安裝的 Supervisor，可能從上述目錄都找不到組態檔，可以利用官方提供的命令生成配置，

$ echo_supervisord_conf > supervisor.conf

這個時候 cat 行程應該已經跑起來了，

$ ps aux | grep /bin/cat

殺掉行程，行程 id 會發生變化，證明 supervisor 又把 cat 拉了起來，

$ sudo kill 9 <行程ID>

核心配置講解

組態檔中的選項并不止 command，官方提供了很多配置項，

[program:name]
command=sh /tmp/echo_time.sh
priority=999
numprocs=1
autostart=true
autorestart=true
startsecs=10
startretries=3 
exitcodes=0,2
stopsignal=QUIT
stopwaitsecs=10
user=root
log_stdout=true
log_stderr=true
logfile=/tmp/echo_time.log
logfile_maxbytes=1MB
logfile_backups=10 
stdout_logfile_maxbytes=20MB 
stdout_logfile_backups=20 
stdout_logfile=/tmp/echo_time.stdout.log

下面挑選幾個配置簡要說明

• command：要執行的命令
• priority：執行優先級，值越高就越晚啟動，越早關閉
• numprocs：行程數量
• autostart：是否與 supervisord 一起啟動
• autorestart：自動重啟
• startsecs：延時啟動時間，默認為 10 秒
• startretries：啟動重試次數，默認為 3 次
• exitcodes：當程式的退出碼為 0 或 2 時，重啟
• stopsignal：停止信號
• stopwaitsecs：延時停止時間，收到停止指令后多久停止
• user：以哪個用戶執行

動態操作子程式

添加新的程式，只需增加組態檔，然后執行 supervisorctl update 即可動態添加新的程式，并不需要重啟 supervisord 服務，如果出現 refused connection 的提示，可能是沒找到組態檔，需要加上配置選項，

$ supervisorctl update
foo1: added process group

洗掉同理，remove 時會先將行程關閉，再從串列中移除，

foo1: stopped
foo1: removed process group

如果需要單獨停止某個程式，可以使用 stop 命令，stop 后跟的是 program 名稱，

$ supervisorctl stop foo
foo: stopped

當然還可以通過 stop all 命令更加暴力的停止所有行程，

$ supervisorctl stop all
foo: stopped
foo1: stopped

反之亦然，啟動行程只需要將 stop 改為 start，

$ supervisorctl start all

連接到某個行程

$ supervisorctl fg <program 名稱>

重啟 supervisord

$ supervisorctl reload

動態加載 supervisor.conf

$ supervisorctl reread

查看所有行程運行狀況

$ supervisorctl status

Web 界面操作

官方提供了界面操作方式，需要在 supervisor.conf 中去掉 inet_http_server 的注釋，

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

重啟 supervisord，

$ supervisorctl reload

訪問 http://localhost:9001 可以看到 supervisor 的操作界面，

我是平也，這有一個專注Gopher技術成長的開源專案「go home」

感謝大家的觀看，如果覺得文章對你有所幫助，歡迎關注公眾號「平也」，聚焦Go語言與技術原理，

標籤：Go

上一篇：使用feign的errorDecoder出現IOException: stream is closed！！

下一篇：List<Map>多關鍵字排序，來個大神