關於網路那些事...

網路行銷,SEO,網路趨勢,教學文章,網頁設計,生活時事

Supervisor 介紹與使用方式

| Comments

Supervisor 是由 python 所寫的一套進程管理系統,可以監控指定的程式,當程式崩潰停止執行時,將程式重啟

Supervisor 有分成 (1) server 主程式 與 (2) client process

(1) server 主程式: 是由 supervisor 執行 supervisor.conf 設定檔所啟動

(2) client process: 則由 supervisorctl 來控制 process

在運行過程,是以C/S模式來運行,也就是由 client process (supervisorctl) 將守護進程的訊息傳送給 server 主程式(supervisord),開始啟用守護進程服務。

一般操作設定 supervisor 都會建議在 root 權限下進行,

這裏則說明如果不在 root 權限的環境,如何安裝及使用

安裝

supervisor 是由 python 開發,因此可直接用 pip 安裝:

pip install supervisor

or

sudo apt-get install supervisor

生成 server 主程式的配置文件

安裝完 supervisor 之後,就可以透過 echo_supervisord_conf 指令來輸出配置

先在使用者根目錄生成 supervisord.conf

cd ~/
echo_supervisord_conf > supervisord.conf

再將檔案移動到 /etc

### Mac
mv supervisord.conf /usr/local/etc/

### Linux
mv supervisord.conf /etc/

建立 client process 設定檔 & Log

接著在使用者根目錄建立 client process 設定檔及 log 資料夾

~/supervisor/log/     - 存放 log
~/supervisor/conf.d/  - 存放監控設定檔

之後就將監控設定檔案放在這裡面

修改 server process 設定檔文件

回到 server process 設定檔案 supervisord.conf,將 files 註解移除,並且輸入指向 client process 設定檔案位置(須留意的是,都要寫成絕對路徑)

vim /usr/local/etc/supervisord.conf

在最後兩行 ; 註解移除,並且修改 files 指向

[include]
files = /Users/liaoxiangru/supervisor/conf.d/*.conf

啟動 supervisor server process 服務

啟動主程式,可透過 supervisor -c 選項來指定配置文件的路徑 即可啟動:

### Mac
supervisord -c /usr/local/etc/supervisord.conf

### Linux
supervisord -c /et/supervisord.conf

查看 supervisor 主程式服務運行狀態

ps aux|grep superviosrd

會得到類似這樣的資訊

username      22092   0.0  0.0  4276968    908 s001  S+   11:27下午   0:00.00 grep --color=auto superviosrd

建立一個 Laravel 守護進程

[建立 laravel client 守護進程設定檔]

這裡我們建立一個 laravel 服務的守護進程 來作為範例,

當我們執行這個 process 時,要能自動啟用 webserver,並且中斷後會自動連線

首先,建立 client process 的設定檔案:

vim ~/supervisor/conf.d/laravel-project.conf

編輯內容

[program:laravel-project]
command = php /Users/username/docker_project/laravel-project/artisan serve
directory = /Users/username/docker_project/laravel-project/
user = username
autostart = true
autorestart = true
stdout_logfile = /Users/username/supervisor/log/laravelapi.log
stderr_logfile = /Users/username/supervisor/log/laravelapi_err.log
environment = NODE_ENV='testing'

[啟動進程]

接著,執行 supervisor process 必須透過主控台 supervisorctl 來操作

通常可以先執行 supervisorctl 進入控制環境:

supervisorctl

接著會進入supervisor進程控制

supervisor>

就能下各種指令,例如 start, reload, reread, stop

但這裡示範,我們都一律用 supervisorctl + 指令的方式,清楚知道是在用進程控制

[重新載入監控及設定]

每次有新增或修改設定檔案,都要重新執行 reread, reload

supervisor>reread
supervisor>reload

查詢目前新增的 laravelapi 是否已經執行

supervisor>status
 
laravel-project                       RUNNING   pid 21417, uptime 0:01:46

[停止process]

supervisor>stop laravel-project

查詢目前新增的 laravelapi 是否已經執行

supervisor>status
 
laravel-project                       FAILE   pid 21417, uptime 0:01:46

注意!當執行停止守護進程,只是將守護的功能停止,該進程還是會繼續運行。

如果要中斷進程,就要手動方式執行 kill。

停止 supervisor process 及終止 php artisan serve

停止process

sudo supervisorctl stop laravel-project

先查看目前程序

lsof -i -P -n | grep LISTEN

會得到類似下方的字串

rapportd  21424 username    3u  IPv4 0xf9ddddd52b6de08d      0t0  TCP *:8000 (LISTEN)

手動刪除指定程序

kill -s SIGTERM 21424

在刪除的同時,應該會在 ~/supervisor/log/laravel-project.log 的紀錄中多了一筆重啟紀錄

Laravel development server started: <http://127.0.0.1:8000>

關閉 supervisor server

supervisor server 主要由 supervisor.sock 來維護,因此關閉方式就是直接將 socket 啟用的連線刪掉

首先列出目前在執行的 supervisor server

ps -ef | grep supervisord

會得到類似這樣的回應

  501 21255     1   0 10:35下午 ??         0:01.07 /usr/local/Cellar/python@2/2.7.15_1/Frameworks/Python.framework/Versions/2.7/Resources/Python.app/Contents/MacOS/Python /usr/local/bin/supervisord
  501 22361 21183   0 11:36下午 ttys001    0:00.00 grep --color=auto supervisord

手動刪除連線

kill -s SIGTERM 21255
kill -s SIGTERM 22361

檢查 client 狀態

supervisorctl status

應該會顯示下方文字,表示 server 已停止連線

unix:///tmp/supervisor.sock no such file

重新啟用 supervisor

執行下方語句就能重新啟用 supervisor server

supervisord

最後,如果你喜歡這篇文章,請幫忙點個讚



最新文章推薦

討論

comments powered by Disqus