進程管理工具 Supervisor

要想在終端後臺常駐進程，首先想到的是在命令後加 & 符號，來達到隱藏程序在後臺的目的，儘管看起來進程已經在後臺運行了，實際上終端會話關閉時進程仍是會被 kill 掉，這種問題通常是採用搭配 nohup 命令來解決的，nohup 做用是忽略 SIGHUP 信號，而會話關閉時正好發送了該信號給會話內全部運行程序，簡而言之，nohup 命令搭配 & 不只能夠在後臺運行，還不受會話關閉的影響。

$ nohup /bin/cat &

那麼問題來了，雖然作到了後臺運行，也避免了掛斷操做帶來的影響，可是它避免不了常駐進程本身出現問題，一旦它因自身異常終止了進程，這對黃金搭檔就無力迴天了。那怎麼才能把掛了的常駐進程拉起來呢？這就是咱們要講的主題 Supervisor。

Supervisor 介紹

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

<span id="unix"></span>

類 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

<span id="gen_conf"></span>

若是你是經過 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語言與技術原理。