進程管理工具 Supervisor

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

$ nohup /bin/cat &
複製代碼

file

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

Supervisor 介紹

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

file

類 Unix 系統就是由 Unix 設計風格演變出的操做系統,除了 Windows 市面上絕大多數系統都是類 Unix 系統。bash

官方文檔介紹 Supervisor 是 C/S 架構體系,它對應的角色分別爲 Supervisorctl 和 Supervisord。後者的主要做用是啓動配置好的程序、響應 Supervisorctl 發過來的指令以及重啓退出的子進程,而前者是 Supervisor 的客戶端,它以命令行的形式提供了一系列參數,來方便用戶向 Supervisord 發送指令,經常使用的有啓動、暫停、移除、更新等命令。架構

Supervisor 安裝與配置

安裝 Supervisor 很簡單,在各大操做系統的軟件包管理器中均可以直接安裝。工具

$ yum install -y supervisor
複製代碼

安裝好的 Supervisor 配置文件默認爲 /etc/supervisor.conf,若是找不到配置文件能夠經過官方命令生成,該配置文件包含了一個空的配置目錄 /etc/supervisor.d(不一樣 OS 可能不同),只需在該目錄添加配置文件便可動態擴展,因此 supervisor.conf 通常不須要作改動。ui

咱們以最簡單的 cat 命令爲例,cat 命令不加參數會阻塞住等待標準輸入,因此很適合作常駐進程的演示。如今建立一個配置文件 cat.ini 到 /etc/supervisor.d/,第一行定義程序的名稱,該名稱用來作操做的標識,第二行定義命令路徑,它纔是程序執行的根本命令。spa

[program:foo]
command=/bin/cat
複製代碼

配置好後,啓動 supervisord 服務,注意經過 -c 指定 supervisor 的配置文件。操作系統

$ supervisord -c /etc/supervisord.conf
複製代碼

固然也能夠不指定配置路徑,那麼它會按如下順序逐個搜索配置文件:pwa

  • $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 的操做界面。

file


我是平也,這有一個專一Gopher技術成長的開源項目「go home」


感謝你們的觀看,若是以爲文章對你有所幫助,歡迎關注公衆號「平也」,聚焦Go語言與技術原理。

關注我
相關文章
相關標籤/搜索