天天看點

Supervisor 背景程序管理

文章目錄

  • ​​一、Supervisor組成部分​​
  • ​​二、supervisor配置​​
  • ​​2.1 supervisor安裝​​
  • ​​2.2 supervisor 服務端配置​​
  • ​​2.3 supervisor監控管理​​
  • ​​三、supervisor 使用​​
  • ​​3.1 supervisor管理服務​​
  • ​​3.2 控制子程序指令​​
  • ​​3.3 supervisord 管理​​
  • ​​四、supervisor 容器​​
  • ​​4.1 配置​​
  • ​​4.2 安裝 supervisor​​
  • ​​4.3 supervisor配置檔案内容​​
  • ​​4.4 使用方法​​

supervisor 是用 Python 開發的一個 C/S 服務。是 Linux/Unix 系統下的程序管理工具。它可以很友善的監聽、啟動、停止、重新開機一個或多個程序。用Supervisor管理的程序,當一個程序意外被殺死,supervisort監聽到程序死後,會自動将它重新拉起,很友善的做到程序自動恢複的功能,不再需要自己寫shell腳本來控制。

相關文檔:

  • 官網介紹:supervisord.org/
  • ​​http://supervisord.org/index.html​​
  • ​​https://weilaihui.gitbooks.io/registry-doc/content/cases/supervisor.html​​

一、Supervisor組成部分

  • supervisord: 服務守護程序

supervisor伺服器的程序名是supervisord。它主要負責在自己的調用中啟動子程式,響應用戶端的指令,重新啟動崩潰或退出的程序,記錄其子程序stdout和stderr的輸出,以及生成和處理對應于子程序生命周期中的"event"伺服器程序使用的配置檔案,通常路徑存放在/etc/supervisord.confa中。此配置檔案是INI格式的配置檔案。

  • supervisorctl:指令行用戶端

supervisor指令行的用戶端名稱是supervisorctl。它為supervisord提供了一個類似于shell的互動界面。使用supervisorctl,使用者可以檢視不同的supervisord程序清單,擷取控制子程序的狀态,如停止和啟動子程序

Web Server:提供與supervisorctl功能相當的WEB操作界面

一個可以通過Web界面來檢視和控制程序的狀态,預設監聽在9091上。

  • XML-RPC Interface:XML-RPC接口
  • supervisor:用于控制的XML-RPC接口

二、supervisor配置

2.1 supervisor安裝

  • centos系統
# cat /etc/redhat-release 
CentOS Linux release 7.8.2003 (Core)

# rpm -ivh https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm

//通過yum方式安裝supervisor
# yum install -y supervisor

//開機自啟動
# systemctl enable supervisord

//啟動
# systemctl start supervisord

//檢視服務狀态
# systemctl status supervisord      

Ubuntu系統

# cat /etc/issue
Ubuntu 22.04 LTS \n \l

//通過方式安裝supervisor
# apt-get install supervisor

//開機自啟動
# systemctl enable supervisor.service

//啟動
# systemctl start supervisor.service

//檢視服務狀态
# systemctl status supervisor.service      

2.2 supervisor 服務端配置

下面介紹 supervisord 配置方法。supervisord 的配置檔案預設位于 /etc/supervisord.conf,内容如下(;後面為注釋):

[unix_http_server]          
file=/tmp/supervisor.sock   ; socket檔案的路徑,supervisorctl用XML_RPC和supervisord通信就是通過它進行
                              的。如果不設定的話,supervisorctl也就不能用了
                              不設定的話,預設為none。 非必須設定      
;chmod=0700                ; 這個簡單,就是修改上面的那個socket檔案的權限為0700
                              不設定的話,預設為0700。 非必須設定
;chown=nobody:nogroup       ; 這個一樣,修改上面的那個socket檔案的屬組為user.group
                              不設定的話,預設為啟動supervisord程序的使用者及屬組。非必須設定
;username=user              ; 使用supervisorctl連接配接的時候,認證的使用者
                               不設定的話,預設為不需要使用者。 非必須設定
;password=123               ; 和上面的使用者名對應的密碼,可以直接使用明碼,也可以使用SHA加密
                              如:{SHA}82ab876d1387bfafe46cc1c8a2ef074eae50cb1d
                              預設不設定。。。非必須設定
  
;[inet_http_server]         ; 偵聽在TCP上的socket,Web Server和遠端的supervisorctl都要用到他
                              不設定的話,預設為不開啟。非必須設定
;port=127.0.0.1:9001        ; 這個是偵聽的IP和端口,偵聽所有IP用 :9001或*:9001。
                              這個必須設定,隻要上面的[inet_http_server]開啟了,就必須設定它
;username=user              ; 這個和上面的uinx_http_server一個樣。非必須設定
;password=123               ; 這個也一個樣。非必須設定
  
[supervisord]                ;這個主要是定義supervisord這個服務端程序的一些參數的
                              這個必須設定,不設定,supervisor就不用幹活了
logfile=/tmp/supervisord.log ; 這個是supervisord這個主程序的日志路徑,注意和子程序的日志不搭嘎。
                               預設路徑$CWD/supervisord.log,$CWD是目前目錄。。非必須設定
logfile_maxbytes=50MB        ; 這個是上面那個日志檔案的最大的大小,當超過50M的時候,會生成一個新的日
                               志檔案。當設定為0時,表示不限制檔案大小
                               預設值是50M,非必須設定。            
logfile_backups=10           ; 日志檔案保持的數量,上面的日志檔案大于50M時,就會生成一個新檔案。檔案
                               數量大于10時,最初的老檔案被新檔案覆寫,檔案數量将保持為10
                               當設定為0時,表示不限制檔案的數量。
                               預設情況下為10。。。非必須設定
loglevel=info                ; 日志級别,有critical, error, warn, info, debug, trace, or blather等
                               預設為info。。。非必須設定項
pidfile=/tmp/supervisord.pid ; supervisord的pid檔案路徑。
                               預設為$CWD/supervisord.pid。。。非必須設定
nodaemon=false               ; 如果是true,supervisord程序将在前台運作
                               預設為false,也就是背景以守護程序運作。。。非必須設定
minfds=1024                  ; 這個是最少系統空閑的檔案描述符,低于這個值supervisor将不會啟動。
                               系統的檔案描述符在這裡設定cat /proc/sys/fs/file-max
                               預設情況下為1024。。。非必須設定
minprocs=200                 ; 最小可用的程序描述符,低于這個值supervisor也将不會正常啟動。
                              ulimit  -u這個指令,可以檢視linux下面使用者的最大程序數
                              預設為200。。。非必須設定
;umask=022                   ; 程序建立檔案的掩碼
                               預設為022。。非必須設定項
;user=chrism                 ; 這個參數可以設定一個非root使用者,當我們以root使用者啟動supervisord之後。
                               我這裡面設定的這個使用者,也可以對supervisord進行管理
                               預設情況是不設定。。。非必須設定項
;identifier=supervisor       ; 這個參數是supervisord的辨別符,主要是給XML_RPC用的。當你有多個
                               supervisor的時候,而且想調用XML_RPC統一管理,就需要為每個
                               supervisor設定不同的辨別符了
                               預設是supervisord。。。非必需設定
;directory=/tmp              ; 這個參數是當supervisord作為守護程序運作的時候,設定這個參數的話,啟動
                               supervisord程序之前,會先切換到這個目錄
                               預設不設定。。。非必須設定
;nocleanup=true              ; 這個參數當為false的時候,會在supervisord程序啟動的時候,把以前子程序
                               産生的日志檔案(路徑為AUTO的情況下)清除掉。有時候咱們想要看曆史日志,當
                               然不想日志被清除了。是以可以設定為true
                               預設是false,有調試需求的同學可以設定為true。。。非必須設定
;childlogdir=/tmp            ; 當子程序日志路徑為AUTO的時候,子程序日志檔案的存放路徑。
                               預設路徑是這個東西,執行下面的這個指令看看就OK了,處理的東西就預設路徑
                               python -c "import tempfile;print tempfile.gettempdir()"
                               非必須設定
;environment=KEY="value"     ; 這個是用來設定環境變量的,supervisord在linux中啟動預設繼承了linux的
                               環境變量,在這裡可以設定supervisord程序特有的其他環境變量。
                               supervisord啟動子程序時,子程序會拷貝父程序的記憶體空間内容。 是以設定的
                               這些環境變量也會被子程序繼承。
                               小例子:environment=name="haha",age="hehe"
                               預設為不設定。。。非必須設定
;strip_ansi=false            ; 這個選項如果設定為true,會清除子程序日志中的所有ANSI 序列。什麼是ANSI
                               序列呢?就是我們的\n,\t這些東西。
                               預設為false。。。非必須設定
  
; the below section must remain in the config file for RPC
; (supervisorctl/web interface) to work, additional interfaces may be
; added by defining them in separate rpcinterface: sections
[rpcinterface:supervisor]    ;這個選項是給XML_RPC用的,當然你如果想使用supervisord或者web server 這
                              個選項必須要開啟的
supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface
  
[supervisorctl]              ;這個主要是針對supervisorctl的一些配置
serverurl=unix:///tmp/supervisor.sock ; 這個是supervisorctl本地連接配接supervisord的時候,本地UNIX socket
                                        路徑,注意這個是和前面的[unix_http_server]對應的
                                        預設值就是unix:///tmp/supervisor.sock。。非必須設定
;serverurl=http://127.0.0.1:9001 ; 這個是supervisorctl遠端連接配接supervisord的時候,用到的TCP socket路徑
                                   注意這個和前面的[inet_http_server]對應
                                   預設就是http://127.0.0.1:9001。。。非必須項
                                 
;username=chris              ; 使用者名
                               預設空。。非必須設定
;password=123                ; 密碼
                              預設空。。非必須設定
;prompt=mysupervisor         ; 輸入使用者名密碼時候的提示符
                               預設supervisor。。非必須設定
;history_file=~/.sc_history  ; 這個參數和shell中的history類似,我們可以用上下鍵來查找前面執行過的指令
                               預設是no file的。。是以我們想要有這種功能,必須指定一個檔案。。。非
                               必須設定
  
; The below sample program section shows all possible program subsection values,
; create one or more 'real' program: sections to be able to control them under
; supervisor.
  
;[program:theprogramname]      ;這個就是咱們要管理的子程序了,":"後面的是名字,最好别亂寫和實際程序
                                有點關聯最好。這樣的program我們可以設定一個或多個,一個program就是
                                要被管理的一個程序
;command=/bin/cat              ; 這個就是我們的要啟動程序的指令路徑了,可以帶參數
                                例子:/home/test.py -a 'hehe'
                                有一點需要注意的是,我們的command隻能是那種在終端運作的程序,不能是
                                守護程序。這個想想也知道了,比如說command=service httpd start。
                                httpd這個程序被linux的service管理了,我們的supervisor再去啟動這個指令
                                這已經不是嚴格意義的子程序了。
                                這個是個必須設定的項
;process_name=%(program_name)s ; 這個是程序名,如果我們下面的numprocs參數為1的話,就不用管這個參數
                                 了,它預設值%(program_name)s也就是上面的那個program冒号後面的名字,
                                 但是如果numprocs為多個的話,那就不能這麼幹了。想想也知道,不可能每個
                                 程序都用同一個程序名吧。
  
                                  
;numprocs=1                    ; 啟動程序的數目。當不為1時,就是程序池的概念,注意process_name的設定
                                 預設為1    。。非必須設定
;directory=/tmp                ; 程序運作前,會前切換到這個目錄
                                 預設不設定。。。非必須設定
;umask=022                     ; 程序掩碼,預設none,非必須
;priority=999                  ; 子程序啟動關閉優先級,優先級低的,最先啟動,關閉的時候最後關閉
                                 預設值為999 。。非必須設定
;autostart=true                ; 如果是true的話,子程序将在supervisord啟動後被自動啟動
                                 預設就是true   。。非必須設定
;autorestart=unexpected        ; 這個是設定子程序挂掉後自動重新開機的情況,有三個選項,false,unexpected
                                 和true。如果為false的時候,無論什麼情況下,都不會被重新啟動,
                                 如果為unexpected,隻有當程序的退出碼不在下面的exitcodes裡面定義的退
                                 出碼的時候,才會被自動重新開機。當為true的時候,隻要子程序挂掉,将會被無
                                 條件的重新開機
;startsecs=1                   ; 這個選項是子程序啟動多少秒之後,此時狀态如果是running,則我們認為啟
                                 動成功了
                                 預設值為1 。。非必須設定
;startretries=3                ; 當程序啟動失敗後,最大嘗試啟動的次數。。當超過3次後,supervisor将把
                                 此程序的狀态置為FAIL
                                 預設值為3 。。非必須設定
;exitcodes=0,2                 ; 注意和上面的的autorestart=unexpected對應。。exitcodes裡面的定義的
                                 退出碼是expected的。
;stopsignal=QUIT               ; 程序停止信号,可以為TERM, HUP, INT, QUIT, KILL, USR1, or USR2等信号
                                  預設為TERM 。。當用設定的信号去幹掉程序,退出碼會被認為是expected
                                  非必須設定
;stopwaitsecs=10               ; 這個是當我們向子程序發送stopsignal信号後,到系統傳回資訊
                                 給supervisord,所等待的最大時間。 超過這個時間,supervisord會向該
                                 子程序發送一個強制kill的信号。
                                 預設為10秒。。非必須設定
;stopasgroup=false             ; 這個東西主要用于,supervisord管理的子程序,這個子程序本身還有
                                 子程序。那麼我們如果僅僅幹掉supervisord的子程序的話,子程序的子程序
                                 有可能會變成孤兒程序。是以咱們可以設定可個選項,把整個該子程序的
                                 整個程序組都幹掉。 設定為true的話,一般killasgroup也會被設定為true。
                                 需要注意的是,該選項發送的是stop信号
                                 預設為false。。非必須設定。。
;killasgroup=false             ; 這個和上面的stopasgroup類似,不過發送的是kill信号
;user=chrism                   ; 如果supervisord是root啟動,我們在這裡設定這個非root使用者,可以用來
                                 管理該program
                                 預設不設定。。。非必須設定項
;redirect_stderr=true          ; 如果為true,則stderr的日志會被寫入stdout日志檔案中
                                 預設為false,非必須設定
;stdout_logfile=/a/path        ; 子程序的stdout的日志路徑,可以指定路徑,AUTO,none等三個選項。
                                 設定為none的話,将沒有日志産生。設定為AUTO的話,将随機找一個地方
                                 生成日志檔案,而且當supervisord重新啟動的時候,以前的日志檔案會被
                                 清空。當 redirect_stderr=true的時候,sterr也會寫進這個日志檔案
;stdout_logfile_maxbytes=1MB   ; 日志檔案最大大小,和[supervisord]中定義的一樣。預設為50
;stdout_logfile_backups=10     ; 和[supervisord]定義的一樣。預設10
;stdout_capture_maxbytes=1MB   ; 這個東西是設定capture管道的大小,當值不為0的時候,子程序可以從stdout
                                 發送資訊,而supervisor可以根據資訊,發送相應的event。
                                 預設為0,為0的時候表達關閉管道。。。非必須項
;stdout_events_enabled=false   ; 當設定為ture的時候,當子程序由stdout向檔案描述符中寫日志的時候,将
                                 觸發supervisord發送PROCESS_LOG_STDOUT類型的event
                                 預設為false。。。非必須設定
;stderr_logfile=/a/path        ; 這個東西是設定stderr寫的日志路徑,當redirect_stderr=true。這個就不用
                                 設定了,設定了也是白搭。因為它會被寫入stdout_logfile的同一個檔案中
                                 預設為AUTO,也就是随便找個地存,supervisord重新開機被清空。。非必須設定
;stderr_logfile_maxbytes=1MB   ; 這個出現好幾次了,就不重複了
;stderr_logfile_backups=10     ; 這個也是
;stderr_capture_maxbytes=1MB   ; 這個一樣,和stdout_capture一樣。 預設為0,關閉狀态
;stderr_events_enabled=false   ; 這個也是一樣,預設為false
;environment=A="1",B="2"       ; 這個是該子程序的環境變量,和别的子程序是不共享的
;serverurl=AUTO                ;
  
; The below sample eventlistener section shows all possible
; eventlistener subsection values, create one or more 'real'
; eventlistener: sections to be able to handle event notifications
; sent by supervisor.
  
;[eventlistener:theeventlistenername] ;這個東西其實和program的地位是一樣的,也是suopervisor啟動的子進
                                       程,不過它幹的活是訂閱supervisord發送的event。他的名字就叫
                                       listener了。我們可以在listener裡面做一系列處理,比如報警等等
                                       樓主這兩天幹的活,就是弄的這玩意
;command=/bin/eventlistener    ; 這個和上面的program一樣,表示listener的可執行檔案的路徑
;process_name=%(program_name)s ; 這個也一樣,程序名,當下面的numprocs為多個的時候,才需要。否則預設就
                                 OK了
;numprocs=1                    ; 相同的listener啟動的個數
;events=EVENT                  ; event事件的類型,也就是說,隻有寫在這個地方的事件類型。才會被發送
                        
                                   
;buffer_size=10                ; 這個是event隊列緩存大小,機關不太清楚,樓主猜測應該是個吧。當buffer
                                 超過10的時候,最舊的event将會被清除,并把新的event放進去。
                                 預設值為10。。非必須選項
;directory=/tmp                ; 程序執行前,會切換到這個目錄下執行
                                 預設為不切換。。。非必須
;umask=022                     ; 淹沒,預設為none,不說了
;priority=-1                   ; 啟動優先級,預設-1,也不扯了
;autostart=true                ; 是否随supervisord啟動一起啟動,預設true
;autorestart=unexpected        ; 是否自動重新開機,和program一個樣,分true,false,unexpected等,注意
                                  unexpected和exitcodes的關系
;startsecs=1                   ; 也是一樣,程序啟動後跑了幾秒鐘,才被認定為成功啟動,預設1
;startretries=3                ; 失敗最大嘗試次數,預設3
;exitcodes=0,2                 ; 期望或者說預料中的程序退出碼,
;stopsignal=QUIT               ; 幹掉程序的信号,預設為TERM,比如設定為QUIT,那麼如果QUIT來幹這個程序
                                 那麼會被認為是正常維護,退出碼也被認為是expected中的
;stopwaitsecs=10               ; max num secs to wait b4 SIGKILL (default 10)
;stopasgroup=false             ; send stop signal to the UNIX process group (default false)
;killasgroup=false             ; SIGKILL the UNIX process group (def false)
;user=chrism                   ;設定普通使用者,可以用來管理該listener程序。
                                預設為空。。非必須設定
;redirect_stderr=true          ; 為true的話,stderr的log會并入stdout的log裡面
                                預設為false。。。非必須設定
;stdout_logfile=/a/path        ; 這個不說了,好幾遍了
;stdout_logfile_maxbytes=1MB   ; 這個也是
;stdout_logfile_backups=10     ; 這個也是
;stdout_events_enabled=false   ; 這個其實是錯的,listener是不能發送event
;stderr_logfile=/a/path        ; 這個也是
;stderr_logfile_maxbytes=1MB   ; 這個也是
;stderr_logfile_backups        ; 這個不說了
;stderr_events_enabled=false   ; 這個也是錯的,listener不能發送event
;environment=A="1",B="2"       ; 這個是該子程序的環境變量
                                 預設為空。。。非必須設定
;serverurl=AUTO                ; override serverurl computation (childutils)
  
; The below sample group section shows all possible group values,
; create one or more 'real' group: sections to create "heterogeneous"
; process groups.
  
;[group:thegroupname]    ;這個東西就是給programs分組,劃分到組裡面的program。我們就不用一個一個去操作了
                         我們可以對組名進行統一的操作。 注意:program被劃分到組裡面之後,就相當于原來
                         的配置從supervisor的配置檔案裡消失了。。。supervisor隻會對組進行管理,而不再
                         會對組裡面的單個program進行管理了
;programs=progname1,progname2  ; 組成員,用逗号分開
                                 這個是個必須的設定項
;priority=999                  ; 優先級,相對于組群組之間說的
                                 預設999。。非必須選項
  
; The [include] section can just contain the "files" setting.  This
; setting can list multiple files (separated by whitespace or
; newlines).  It can also contain wildcards.  The filenames are
; interpreted as relative to this file.  Included files *cannot*
; include files themselves.
  

        ;這個東西挺有用的,當我們要管理的程序很多的時候,寫在一個檔案裡面就有點大了。我們可以把配置資訊寫到多個檔案中,然後include過來
[include]
files = supervisord.d/*.ini  ; 引入 `/etc/supervisor/conf.d/` 下的 `.conf` 檔案      

2.3 supervisor監控管理

為了更友善的遠端管理 Supervisor ,可以開啟其自帶的 web 控制台。

  • 修改配置檔案去掉注釋啟用
# vim /etc/supervisord.conf
[inet_http_server]         ; inet (TCP) server disabled by default
port=0.0.0.0: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))      
注:端口預設是監聽127.0.0.1:9001,這裡友善測試,修改為:port=0.0.0.0:9001
  • 重新開機supervisord服務
systemctl restart supervisord      
  • 通過浏覽器直接通路即可

三、supervisor 使用

3.1 supervisor管理服務

在/etc/supervisor/conf.d/新增子程序配置檔案 bsc-wallet.conf:

# cat bsc-wallet.conf 
;bsc-wallet.ini
;

[program:bsc-wallet] ;程式名稱,在 supervisorctl 中通過這個值來對程式進行一系列的操作
directory = /opt/bsc-wallet/bin/ ; 程式的啟動目錄
command = nohup /opt/bsc-wallet/bin/bsc-wallet -config=/opt/bsc-wallet/conf/dev.toml &  ; 啟動指令,與手動在指令行啟動的指令是一樣的
autostart = true     ; 在 supervisord 啟動的時候也自動啟動
startsecs = 10        ; 啟動 10 秒後沒有異常退出,就當作已經正常啟動了
autorestart = true   ; 程式異常退出後自動重新開機
startretries = 3     ; 啟動失敗自動重試次數,預設是 3
user = root          ; 用哪個使用者啟動
redirect_stderr = true  ; 把 stderr 重定向到 stdout,預設 false
stdout_logfile_maxbytes = 100MB  ; stdout 日志檔案大小,預設 50MB
stdout_logfile_backups = 10     ; stdout 日志檔案備份數
; stdout 日志檔案,需要注意當指定目錄不存在時無法正常啟動,是以需要手動建立目錄(supervisord 會自動建立日志檔案)
stdout_logfile = /opt/bsc-wallet/log/supervisor.log      

3.2 控制子程序指令

reread ;重新加載配置檔案
update ;将配置檔案裡新增的子程序加入程序組,如果設定了autostart=true則會啟動新新增的子程序
status ;檢視所有程序狀态
status <name> ;檢視指定程序狀态
start all; 啟動所有子程序
start <name>; 啟動指定子程序
restart all; 重新開機所有子程序
restart <name>; 重新開機指定子程序
stop all; 停止所有子程序
stop <name>; 停止指定子程序
reload ;重新開機supervisord
add <name>; 添加子程序到程序組
reomve <name>; 從程序組移除子程序,需要先stop。注意:移除後,需要使用reread和update才能重新運作該程序      

3.3 supervisord 管理

Supervisord 安裝完成後有兩個可用的指令行 supervisord 和 supervisorctl,指令使用解釋如下:

supervisord,初始啟動 Supervisord,啟動、管理配置中設定的程序。
supervisorctl stop programxxx,停止某一個程序(programxxx),programxxx 為 [program:beepkg] 裡配置的值,這個示例就是 beepkg。
supervisorctl start programxxx,啟動某個程序
supervisorctl restart programxxx,重新開機某個程序
supervisorctl stop groupworker: ,重新開機所有屬于名為 groupworker 這個分組的程序(start,restart 同理)
supervisorctl stop all,停止全部程序,注:start、restart、stop 都不會載入最新的配置檔案。
supervisorctl reload,載入最新的配置檔案,停止原有程序并按新的配置啟動、管理所有程序。
supervisorctl update,根據最新的配置檔案,啟動新配置或有改動的程序,配置沒有改動的程序不會受影響而重新開機。      
注意:顯示用 stop 停止掉的程序,用 reload 或者 update 都不會自動重新開機。

四、supervisor 容器

Docker 容器在啟動的時候開啟單個程序,比如,一個 ssh 或者 apache 的 daemon 服務。但我們經常需要在一個機器上開啟多個服務,這可以有很多方法,最簡單的就是把多個啟動指令方到一個啟動腳本裡面,啟動的時候直接啟動這個腳本,另外就是安裝程序管理工具。

本小節将使用程序管理工具 supervisor 來管理容器中的多個程序。使用 Supervisor 可以更好的控制、管理、重新開機我們希望運作的程序。在這裡我們示範一下如何同時使用 ssh 和 apache 服務。

4.1 配置

首先建立一個 Dockerfile,内容和各部分的解釋如下。

FROM ubuntu:22.04
MAINTAINER [email protected]
RUN echo "deb http://archive.ubuntu.com/ubuntu precise main universe" > /etc/apt/sources.list
RUN apt-get update
RUN apt-get upgrade -y      

4.2 安裝 supervisor

安裝 ssh、apache 和 supervisor。

RUN apt-get install -y openssh-server apache2 supervisor
RUN mkdir -p /var/run/sshd
RUN mkdir -p /var/log/supervisor      

這裡安裝 3 個軟體,還建立了 2 個 ssh 和 supervisor 服務正常運作所需要的目錄。

COPY supervisord.conf /etc/supervisor/conf.d/supervisord.conf      

添加 supervisord 的配置檔案,并複制配置檔案到對應目錄下面。

EXPOSE 22 80
CMD ["/usr/bin/supervisord"]      

這裡我們映射了 22 和 80 端口,使用 supervisord 的可執行路徑啟動服務。

4.3 supervisor配置檔案内容

[supervisord]
nodaemon=true
[program:sshd]
command=/usr/sbin/sshd -D

[program:apache2]
command=/bin/bash -c "source /etc/apache2/envvars && exec /usr/sbin/apache2 -DFOREGROUND"      

配置檔案包含目錄和程序,第一段 supervsord 配置軟體本身,使用 nodaemon 參數來運作。第二段包含要控制的 2 個服務。每一段包含一個服務的目錄和啟動這個服務的指令。

4.4 使用方法

建立鏡像。

$ sudo docker build -t test/supervisord .      

啟動 supervisor 容器。

$ sudo docker run -p 22 -p 80 -t -i test/supervisords
2013-11-25 18:53:22,312 CRIT Supervisor running as root (no user in config file)
2013-11-25 18:53:22,312 WARN Included extra file "/etc/supervisor/conf.d/supervisord.conf" during parsing
2013-11-25 18:53:22,342 INFO supervisord started with pid 1
2013-11-25 18:53:23,346 INFO spawned: 'sshd' with pid 6
2013-11-25 18:53:23,349 INFO spawned: 'apache2' with pid 7