Supervisor 為服務創建守護進程

　　今天需要再服務上部署一個.net 方面的項目；當時開啟服務的命令只能在前台執行；使用nohub CMD &等放在后台開啟服務都會宕機；所以搜尋了Supervisor 這個解決辦法，為服務創建守護進程。具體操作如下

1、什么是守護進程

　　在linux或者unix操作系統中，守護進程（Daemon）是一種運行在后台的特殊進程，它獨立於控制終端並且周期性的執行某種任務或等待處理某些發生的事件。由於在linux中，每個系統與用戶進行交流的界面稱為終端，每一個從此終端開始運行的進程都會依附於這個終端，這個終端被稱為這些進程的控制終端，當控制終端被關閉的時候，相應的進程都會自動關閉。但是守護進程卻能突破這種限制，它脫離於終端並且在后台運行，並且它脫離終端的目的是為了避免進程在運行的過程中的信息在任何終端中顯示並且進程也不會被任何終端所產生的終端信息所打斷。它從被執行的時候開始運轉，直到整個系統關閉才退出。

本篇的創建守護進程，是指發布在Linux上 asp.net core 程序的dotnet xxx.dll命令的宿主進程創建一個守護進程。

在 Linux 上有很多可以管理進程的工具，我們使用 Supervisor 來做這個事情。原因有兩點：

•  1、它是微軟官方文檔推薦的，降低學習成本。
•  2、它並不一定是最好的，但一定是文檔最全的。

 

2、認識 Supervisor

2.1 Supervisor 介紹

官方文檔：http://supervisord.org/

　　Supervisor是一個客戶端/服務器系統，采用 Python(2.4+) 開發的，它是一個允許用戶管理，基於 Unix 系統進程的 Client/Server 系統，提供了大量功能來實現對進程的管理。

 

2.2 Supervisor 特征

•  簡單
  • Supervisor通過簡單的INI樣式（可以修改為.conf后綴）配置文件進行配置，該文件易於學習。它提供了許多每個進程選項，使您的生活更輕松，如重新啟動失敗的進程和自動日志輪換。
• 集中
  • 主管為您提供一個啟動，停止和監控流程的位置。流程可以單獨控制，也可以成組控制。您可以將Supervisor配置為提供本地或遠程命令行和Web界面。
• 高效
  • 主管通過fork / exec啟動其子進程，子進程不進行守護。當進程終止時，操作系統會立即向Supervisor發出信號，這與某些依賴麻煩的PID文件和定期輪詢重新啟動失敗進程的解決方案不同。
• 擴展
  • Supervisor有一個簡單的事件通知協議，用任何語言編寫的程序都可以用它來監視它，以及一個用於控制的XML-RPC接口。它還使用可由Python開發人員利用的擴展點構建。
• 兼容
  • 除了Windows之外，Supervisor幾乎可以處理所有事情。它在Linux，Mac OS X，Solaris和FreeBSD上經過測試和支持。它完全用Python編寫，因此安裝不需要C編譯器。
• 久經考驗
  • 雖然Supervisor今天非常活躍，但它並不是新軟件。主管已存在多年，已在許多服務器上使用。

 

3、安裝配置 Supervisor

3.1 各個平台安裝Supervisor

（1）在 linux 中使用以下命令進行安裝：

•  centos

yum install supervisor

•  ubuntu

sudo apt-get install supervisor

•  python

pip install supervosor easy_install supervisor

 

（2）在 masOS 中直接使用brew工具進行安裝即可：

brew install supervisor

 

3.2 Supervisor 配置

（1）linux 安裝完后會有一個主配置文件/etc/supervisord.conf，和一個/etc/supervisord.d 自配置文件目錄

$ ls /etc/supervisord.*
/etc/supervisord.conf
/etc/supervisor

　　

（2）修改主配置文件，設置自配置文件生效的后綴

$ vim /etc/supervisord.conf   在最后一行
[include]
files = supervisord.d/*.conf

　　

（3）為了方便管理，就在自配置文件目錄下，創建項目的配置文件

$ cd /etc/supervisord.d/
$ vim ProjectName.conf
[program: ProjectName]
command=dotnet ProjectName.dll   ; 運行程序的命令
directory=/usr/local/ProjectName/   ; 命令執行的目錄
autorestart=true   ; 程序意外退出是否自動重啟
autostart=true   ; 是否自動啟動
stderr_logfile=/var/log/ProjectName.err.log   ; 錯誤日志文件
stdout_logfile=/var/log/ProjectName.out.log   ; 輸出日志文件
environment=ASPNETCORE_ENVIRONMENT=Production   ; 進程環境變量
user=root   ; 進程執行的用戶身份
stopsignal=INT
startsecs=1   ; 自動重啟間隔

　　

3.3 啟動 Supervisor 服務

（1）開啟服務，並設為開機自啟

$ systemctl start supervisord.service 
$ systemctl enable supervisord.service 
Created symlink from /etc/systemd/system/multi-user.target.wants/supervisord.service to /usr/lib/systemd/system/supervisord.service.

 

（2）查詢服務狀態

$ systemctl status supervisord.service 
● supervisord.service - Process Monitoring and Control Daemon
   Loaded: loaded (/usr/lib/systemd/system/supervisord.service; disabled; vendor preset: disabled)
   Active: active (running) since Fri 2019-01-11 15:00:23 CST; 57min ago
  Process: 910 ExecStart=/usr/bin/supervisord -c /etc/supervisord.conf (code=exited, status=0/SUCCESS)
 Main PID: 913 (supervisord)
   CGroup: /system.slice/supervisord.service
           ├─913 /usr/bin/python /usr/bin/supervisord -c /etc/supervisord.conf
           └─914 dotnet eXiu.OBD.Host.dll

Jan 11 15:00:23 iZe4iwiics91xjZ systemd[1]: Starting Process Monitoring and Control Daemon...
Jan 11 15:00:23 iZe4iwiics91xjZ systemd[1]: Started Process Monitoring and Control Daemon.

　　

（3）查看進程認證

$ ps -ef | grep dotnet ProjectName
root       914   913  0 15:00 ?        00:00:05 dotnet ProjectName.dll
root      3455  3058  0 15:58 pts/0    00:00:00 grep --color=auto dotnet

 

4、報錯處理

（1）使用Supervisor 為服務創建守護進程失敗

Error: Another program is already listening on a port that one of our HTTP servers is configured to use.  
Shut this program down first before starting supervisord.
For help, use /usr/bin/supervisord –h

　　是因為有一個使用supervisor配置的應用程序正在運行，需要執行supervisorctl shutdown命令終止它，或重新創建一個ProjectName.conf文件再執行第一條命令。

 

（2）如果運行supervisorctl出現以下錯誤

error: <class 'socket.error'>, [Errno 111] Connection refused: file: /usr/lib64/python2.6/socket.py line: 567

 

　　說明Supervisor 服務沒有啟動成功，或Supervisor 服務被關閉了，重啟啟動服務即可。

 

5、supervisorctl 常用命令

$ sudo service supervisor stop 停止supervisor服務
$ sudo service supervisor start 啟動supervisor服務
$ supervisorctl shutdown #關閉所有任務
$ supervisorctl stop|start program_name #啟動或停止服務
$ supervisorctl status #查看所有任務狀態