所需命令

  1. $ sudo su - #切换为root用户
  2. # yum install epel-release
  3. # yum install -y supervisor
  4. # systemctl enable supervisord # 开机自启动
  5. # systemctl start supervisord # 启动supervisord服务
  6. # systemctl status supervisord # 查看supervisord服务状态
  7. # ps -ef|grep supervisord # 查看是否存在supervisord进程

安装完毕后通过命令

  1. echo_supervisord_conf

或

  1. cat /etc/supervisord/supervisord.conf

查看当前supervisor的配置文件

配置文件内容及命令

  1. ; Sample supervisor config file.
  2. ;
  3. ; For more information on the config file, please see:
  4. ; http://supervisord.org/configuration.html
  5. ;
  6. ; Notes:
  7. ;  - Shell expansion ("~" or "$HOME") is not supported.  Environment
  8. ;    variables can be expanded using this syntax: "%(ENV_HOME)s".
  9. ;  - Comments must have a leading space: "a=b ;comment" not "a=b;comment".
  11. [unix_http_server]
  12. file=/tmp/supervisor.sock   ; (the path to the socket file)
  13. ;chmod=0700                 ; socket file mode (default 0700)
  14. ;chown=nobody:nogroup       ; socket file uid:gid owner
  15. ;username=user              ; (default is no username (open server))
  16. ;password=123               ; (default is no password (open server))
  18. ;[inet_http_server]         ; inet (TCP) server disabled by default
  19. ;port=127.0.0.1:9001        ; (ip_address:port specifier, *:port for all iface)
  20. ;username=user              ; (default is no username (open server))
  21. ;password=123               ; (default is no password (open server))
  23. [supervisord]
  24. logfile=/tmp/supervisord.log ; (main log file;default $CWD/supervisord.log)
  25. logfile_maxbytes=50MB        ; (max main logfile bytes b4 rotation;default 50MB)
  26. logfile_backups=10           ; (num of main logfile rotation backups;default 10)
  27. loglevel=info                ; (log level;default info; others: debug,warn,trace)
  28. pidfile=/tmp/supervisord.pid ; (supervisord pidfile;default supervisord.pid)
  29. nodaemon=false               ; (start in foreground if true;default false)
  30. minfds=1024                  ; (min. avail startup file descriptors;default 1024)
  31. minprocs=200                 ; (min. avail process descriptors;default 200)
  32. ;umask=022                   ; (process file creation umask;default 022)
  33. ;user=chrism                 ; (default is current user, required if root)
  34. ;identifier=supervisor       ; (supervisord identifier, default is 'supervisor')
  35. ;directory=/tmp              ; (default is not to cd during start)
  36. ;nocleanup=true              ; (don't clean up tempfiles at start;default false)
  37. ;childlogdir=/tmp            ; ('AUTO' child log dir, default $TEMP)
  38. ;environment=KEY="value"     ; (key value pairs to add to environment)
  39. ;strip_ansi=false            ; (strip ansi escape codes in logs; def. false)
  41. ; the below section must remain in the config file for RPC
  42. ; (supervisorctl/web interface) to work, additional interfaces may be
  43. ; added by defining them in separate rpcinterface: sections
  44. [rpcinterface:supervisor]
  45. supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface
  47. [supervisorctl]
  48. serverurl=unix:///tmp/supervisor.sock ; use a unix:// URL  for a unix socket
  49. ;serverurl=http://127.0.0.1:9001 ; use an http:// url to specify an inet socket
  50. ;username=chris              ; should be same as http_username if set
  51. ;password=123                ; should be same as http_password if set
  52. ;prompt=mysupervisor         ; cmd line prompt (default "supervisor")
  53. ;history_file=~/.sc_history  ; use readline history if available
  55. ; The below sample program section shows all possible program subsection values,
  56. ; create one or more 'real' program: sections to be able to control them under
  57. ; supervisor.
  59. ;[program:theprogramname]
  60. ;command=/bin/cat              ; the program (relative uses PATH, can take args)
  61. ;process_name=%(program_name)s ; process_name expr (default %(program_name)s)
  62. ;numprocs=1                    ; number of processes copies to start (def 1)
  63. ;directory=/tmp                ; directory to cwd to before exec (def no cwd)
  64. ;umask=022                     ; umask for process (default None)
  65. ;priority=999                  ; the relative start priority (default 999)
  66. ;autostart=true                ; start at supervisord start (default: true)
  67. ;autorestart=unexpected        ; whether/when to restart (default: unexpected)
  68. ;startsecs=1                   ; number of secs prog must stay running (def. 1)
  69. ;startretries=3                ; max # of serial start failures (default 3)
  70. ;exitcodes=0,2                 ; 'expected' exit codes for process (default 0,2)
  71. ;stopsignal=QUIT               ; signal used to kill process (default TERM)
  72. ;stopwaitsecs=10               ; max num secs to wait b4 SIGKILL (default 10)
  73. ;stopasgroup=false             ; send stop signal to the UNIX process group (default false)
  74. ;killasgroup=false             ; SIGKILL the UNIX process group (def false)
  75. ;user=chrism                   ; setuid to this UNIX account to run the program
  76. ;redirect_stderr=true          ; redirect proc stderr to stdout (default false)
  77. ;stdout_logfile=/a/path        ; stdout log path, NONE for none; default AUTO
  78. ;stdout_logfile_maxbytes=1MB   ; max # logfile bytes b4 rotation (default 50MB)
  79. ;stdout_logfile_backups=10     ; # of stdout logfile backups (default 10)
  80. ;stdout_capture_maxbytes=1MB   ; number of bytes in 'capturemode' (default 0)
  81. ;stdout_events_enabled=false   ; emit events on stdout writes (default false)
  82. ;stderr_logfile=/a/path        ; stderr log path, NONE for none; default AUTO
  83. ;stderr_logfile_maxbytes=1MB   ; max # logfile bytes b4 rotation (default 50MB)
  84. ;stderr_logfile_backups=10     ; # of stderr logfile backups (default 10)
  85. ;stderr_capture_maxbytes=1MB   ; number of bytes in 'capturemode' (default 0)
  86. ;stderr_events_enabled=false   ; emit events on stderr writes (default false)
  87. ;environment=A="1",B="2"       ; process environment additions (def no adds)
  88. ;serverurl=AUTO                ; override serverurl computation (childutils)
  90. ; The below sample eventlistener section shows all possible
  91. ; eventlistener subsection values, create one or more 'real'
  92. ; eventlistener: sections to be able to handle event notifications
  93. ; sent by supervisor.
  95. ;[eventlistener:theeventlistenername]
  96. ;command=/bin/eventlistener    ; the program (relative uses PATH, can take args)
  97. ;process_name=%(program_name)s ; process_name expr (default %(program_name)s)
  98. ;numprocs=1                    ; number of processes copies to start (def 1)
  99. ;events=EVENT                  ; event notif. types to subscribe to (req'd)
  100. ;buffer_size=10                ; event buffer queue size (default 10)
  101. ;directory=/tmp                ; directory to cwd to before exec (def no cwd)
  102. ;umask=022                     ; umask for process (default None)
  103. ;priority=-1                   ; the relative start priority (default -1)
  104. ;autostart=true                ; start at supervisord start (default: true)
  105. ;autorestart=unexpected        ; whether/when to restart (default: unexpected)
  106. ;startsecs=1                   ; number of secs prog must stay running (def. 1)
  107. ;startretries=3                ; max # of serial start failures (default 3)
  108. ;exitcodes=0,2                 ; 'expected' exit codes for process (default 0,2)
  109. ;stopsignal=QUIT               ; signal used to kill process (default TERM)
  110. ;stopwaitsecs=10               ; max num secs to wait b4 SIGKILL (default 10)
  111. ;stopasgroup=false             ; send stop signal to the UNIX process group (default false)
  112. ;killasgroup=false             ; SIGKILL the UNIX process group (def false)
  113. ;user=chrism                   ; setuid to this UNIX account to run the program
  114. ;redirect_stderr=true          ; redirect proc stderr to stdout (default false)
  115. ;stdout_logfile=/a/path        ; stdout log path, NONE for none; default AUTO
  116. ;stdout_logfile_maxbytes=1MB   ; max # logfile bytes b4 rotation (default 50MB)
  117. ;stdout_logfile_backups=10     ; # of stdout logfile backups (default 10)
  118. ;stdout_events_enabled=false   ; emit events on stdout writes (default false)
  119. ;stderr_logfile=/a/path        ; stderr log path, NONE for none; default AUTO
  120. ;stderr_logfile_maxbytes=1MB   ; max # logfile bytes b4 rotation (default 50MB)
  121. ;stderr_logfile_backups        ; # of stderr logfile backups (default 10)
  122. ;stderr_events_enabled=false   ; emit events on stderr writes (default false)
  123. ;environment=A="1",B="2"       ; process environment additions
  124. ;serverurl=AUTO                ; override serverurl computation (childutils)
  126. ; The below sample group section shows all possible group values,
  127. ; create one or more 'real' group: sections to create "heterogeneous"
  128. ; process groups.
  130. ;[group:thegroupname]
  131. ;programs=progname1,progname2  ; each refers to 'x' in [program:x] definitions
  132. ;priority=999                  ; the relative start priority (default 999)
  134. ; The [include] section can just contain the "files" setting.  This
  135. ; setting can list multiple files (separated by whitespace or
  136. ; newlines).  It can also contain wildcards.  The filenames are
  137. ; interpreted as relative to this file.  Included files *cannot*
  138. ; include files themselves.
  140. ;[include]
  141. ;files = relative/directory/*.ini
  142. [root@localhost zrdev]# cd /etc/supervisord.d/
  143. [root@localhost supervisord.d]# ls
  144. [root@localhost supervisord.d]# ls
  145. [root@localhost supervisord.d]# vi  /etc/supervisord/supervisord.conf
  146. [root@localhost supervisord.d]# cat  /etc/supervisord/supervisord.conf
  147. cat: /etc/supervisord/supervisord.conf: 没有那个文件或目录
  148. [root@localhost supervisord.d]# whereis supervisord
  149. supervisord: /usr/bin/supervisord /etc/supervisord.d /etc/supervisord.conf
  150. [root@localhost supervisord.d]# cat  /etc/supervisord.conf
  151. ; Sample supervisor config file.
  153. [unix_http_server]
  154. file=/var/run/supervisor/supervisor.sock   ; (the path to the socket file)
  155. ;chmod=0700                 ; sockef file mode (default 0700)
  156. ;chown=nobody:nogroup       ; socket file uid:gid owner
  157. ;username=user              ; (default is no username (open server))
  158. ;password=123               ; (default is no password (open server))
  160. ;[inet_http_server]         ; inet (TCP) server disabled by default
  161. ;port=127.0.0.1:9001        ; (ip_address:port specifier, *:port for all iface)
  162. ;username=user              ; (default is no username (open server))
  163. ;password=123               ; (default is no password (open server))
  165. [supervisord]
  166. logfile=/var/log/supervisor/supervisord.log  ; (main log file;default $CWD/supervisord.log)
  167. logfile_maxbytes=50MB       ; (max main logfile bytes b4 rotation;default 50MB)
  168. logfile_backups=10          ; (num of main logfile rotation backups;default 10)
  169. loglevel=info               ; (log level;default info; others: debug,warn,trace)
  170. pidfile=/var/run/supervisord.pid ; (supervisord pidfile;default supervisord.pid)
  171. nodaemon=false              ; (start in foreground if true;default false)
  172. minfds=1024                 ; (min. avail startup file descriptors;default 1024)
  173. minprocs=200                ; (min. avail process descriptors;default 200)
  174. ;umask=022                  ; (process file creation umask;default 022)
  175. ;user=chrism                 ; (default is current user, required if root)
  176. ;identifier=supervisor       ; (supervisord identifier, default is 'supervisor')
  177. ;directory=/tmp              ; (default is not to cd during start)
  178. ;nocleanup=true              ; (don't clean up tempfiles at start;default false)
  179. ;childlogdir=/tmp            ; ('AUTO' child log dir, default $TEMP)
  180. ;environment=KEY=value       ; (key value pairs to add to environment)
  181. ;strip_ansi=false            ; (strip ansi escape codes in logs; def. false)
  183. ; the below section must remain in the config file for RPC
  184. ; (supervisorctl/web interface) to work, additional interfaces may be
  185. ; added by defining them in separate rpcinterface: sections
  186. [rpcinterface:supervisor]
  187. supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface
  189. [supervisorctl]
  190. serverurl=unix:///var/run/supervisor/supervisor.sock ; use a unix:// URL  for a unix socket
  191. ;serverurl=http://127.0.0.1:9001 ; use an http:// url to specify an inet socket
  192. ;username=chris              ; should be same as http_username if set
  193. ;password=123                ; should be same as http_password if set
  194. ;prompt=mysupervisor         ; cmd line prompt (default "supervisor")
  195. ;history_file=~/.sc_history  ; use readline history if available
  197. ; The below sample program section shows all possible program subsection values,
  198. ; create one or more 'real' program: sections to be able to control them under
  199. ; supervisor.
  201. ;[program:theprogramname]
  202. ;command=/bin/cat              ; the program (relative uses PATH, can take args)
  203. ;process_name=%(program_name)s ; process_name expr (default %(program_name)s)
  204. ;numprocs=1                    ; number of processes copies to start (def 1)
  205. ;directory=/tmp                ; directory to cwd to before exec (def no cwd)
  206. ;umask=022                     ; umask for process (default None)
  207. ;priority=999                  ; the relative start priority (default 999)
  208. ;autostart=true                ; start at supervisord start (default: true)
  209. ;autorestart=true              ; retstart at unexpected quit (default: true)
  210. ;startsecs=10                  ; number of secs prog must stay running (def. 1)
  211. ;startretries=3                ; max # of serial start failures (default 3)
  212. ;exitcodes=0,2                 ; 'expected' exit codes for process (default 0,2)
  213. ;stopsignal=QUIT               ; signal used to kill process (default TERM)
  214. ;stopwaitsecs=10               ; max num secs to wait b4 SIGKILL (default 10)
  215. ;user=chrism                   ; setuid to this UNIX account to run the program
  216. ;redirect_stderr=true          ; redirect proc stderr to stdout (default false)
  217. ;stdout_logfile=/a/path        ; stdout log path, NONE for none; default AUTO
  218. ;stdout_logfile_maxbytes=1MB   ; max # logfile bytes b4 rotation (default 50MB)
  219. ;stdout_logfile_backups=10     ; # of stdout logfile backups (default 10)
  220. ;stdout_capture_maxbytes=1MB   ; number of bytes in 'capturemode' (default 0)
  221. ;stdout_events_enabled=false   ; emit events on stdout writes (default false)
  222. ;stderr_logfile=/a/path        ; stderr log path, NONE for none; default AUTO
  223. ;stderr_logfile_maxbytes=1MB   ; max # logfile bytes b4 rotation (default 50MB)
  224. ;stderr_logfile_backups=10     ; # of stderr logfile backups (default 10)
  225. ;stderr_capture_maxbytes=1MB   ; number of bytes in 'capturemode' (default 0)
  226. ;stderr_events_enabled=false   ; emit events on stderr writes (default false)
  227. ;environment=A=1,B=2           ; process environment additions (def no adds)
  228. ;serverurl=AUTO                ; override serverurl computation (childutils)
  230. ; The below sample eventlistener section shows all possible
  231. ; eventlistener subsection values, create one or more 'real'
  232. ; eventlistener: sections to be able to handle event notifications
  233. ; sent by supervisor.
  235. ;[eventlistener:theeventlistenername]
  236. ;command=/bin/eventlistener    ; the program (relative uses PATH, can take args)
  237. ;process_name=%(program_name)s ; process_name expr (default %(program_name)s)
  238. ;numprocs=1                    ; number of processes copies to start (def 1)
  239. ;events=EVENT                  ; event notif. types to subscribe to (req'd)
  240. ;buffer_size=10                ; event buffer queue size (default 10)
  241. ;directory=/tmp                ; directory to cwd to before exec (def no cwd)
  242. ;umask=022                     ; umask for process (default None)
  243. ;priority=-1                   ; the relative start priority (default -1)
  244. ;autostart=true                ; start at supervisord start (default: true)
  245. ;autorestart=unexpected        ; restart at unexpected quit (default: unexpected)
  246. ;startsecs=10                  ; number of secs prog must stay running (def. 1)
  247. ;startretries=3                ; max # of serial start failures (default 3)
  248. ;exitcodes=0,2                 ; 'expected' exit codes for process (default 0,2)
  249. ;stopsignal=QUIT               ; signal used to kill process (default TERM)
  250. ;stopwaitsecs=10               ; max num secs to wait b4 SIGKILL (default 10)
  251. ;user=chrism                   ; setuid to this UNIX account to run the program
  252. ;redirect_stderr=true          ; redirect proc stderr to stdout (default false)
  253. ;stdout_logfile=/a/path        ; stdout log path, NONE for none; default AUTO
  254. ;stdout_logfile_maxbytes=1MB   ; max # logfile bytes b4 rotation (default 50MB)
  255. ;stdout_logfile_backups=10     ; # of stdout logfile backups (default 10)
  256. ;stdout_events_enabled=false   ; emit events on stdout writes (default false)
  257. ;stderr_logfile=/a/path        ; stderr log path, NONE for none; default AUTO
  258. ;stderr_logfile_maxbytes=1MB   ; max # logfile bytes b4 rotation (default 50MB)
  259. ;stderr_logfile_backups        ; # of stderr logfile backups (default 10)
  260. ;stderr_events_enabled=false   ; emit events on stderr writes (default false)
  261. ;environment=A=1,B=2           ; process environment additions
  262. ;serverurl=AUTO                ; override serverurl computation (childutils)
  264. ; The below sample group section shows all possible group values,
  265. ; create one or more 'real' group: sections to create "heterogeneous"
  266. ; process groups.
  268. ;[group:thegroupname]
  269. ;programs=progname1,progname2  ; each refers to 'x' in [program:x] definitions
  270. ;priority=999                  ; the relative start priority (default 999)
  272. ; The [include] section can just contain the "files" setting.  This
  273. ; setting can list multiple files (separated by whitespace or
  274. ; newlines).  It can also contain wildcards.  The filenames are
  275. ; interpreted as relative to this file.  Included files *cannot*
  276. ; include files themselves.
  278. [include]
  279. files = supervisord.d/*.ini

以上配置文件用到几个部分：

  • [unix_http_server]：这部分设置HTTP服务器监听的UNIX domain socket
    • file: 指向UNIX domain socket，即file=/var/run/supervisor.sock
    • chmod：启动时改变supervisor.sock的权限
  • [supervisord]：与supervisord有关的全局配置需要在这部分设置
    • logfile: 指向记录supervisord进程的log文件
    • pidfile：pidfile保存子进程的路径
    • childlogdir：子进程log目录设为AUTO的log目录
  • [supervisorctl]：
    • serverurl：进入supervisord的URL， 对于UNIX domain sockets, 应设为 unix:///absolute/path/to/file.sock
  • [include]：如果配置文件包含该部分，则该部分必须包含一个files键：
    • files：包含一个或多个文件，这里包含了/etc/supervisor/conf.d/目录下所有的.conf文件，可以在该目录下增加我们自己的配置文件，在该配置文件中增加[program:x]部分，用来运行我们自己的程序，如下：
  • [program:x]：配置文件必须包括至少一个program，x是program名称，必须写上，不能为空
    • command：包含一个命令，当这个program启动时执行
    • directory：执行子进程时supervisord暂时切换到该目录
    • user：账户名
    • startsecs：进程从STARING状态转换到RUNNING状态program所需要保持运行的时间（单位：秒）
    • redirect_stderr：如果是true，则进程的stderr输出被发送回其stdout文件描述符上的supervisord
    • stdout_logfile：将进程stdout输出到指定文件
    • stdout_logfile_maxbytes：stdout_logfile指定日志文件最大字节数，默认为50MB，可以加KB、MB或GB等单位
    • stdout_logfile_backups：要保存的stdout_logfile备份的数量

如需web前端网页进行管理，可配置[inet_http_server]中的port，并取消注释。

通过whereis命令查看supervisord的相关路径

  1. [root@localhost supervisord.d]# whereis supervisord
  2. supervisord: /usr/bin/supervisord /etc/supervisord.d /etc/supervisord.conf

如上，/etc/supervisord.d中存放要运行的线程的配置文件，/etc/supervisord.conf是supervisor的配置文件，由于在/etc/supervisord.conf中已经由

  1. [include]
  2. files = supervisord.d/*.ini

将/etc/supervisord.d下的所有ini文件加入了总配置文件，所以只需要将要运行的线程的配置文件统一放入/etc/supervisord.d中即可。

示例

以下是ziot平台配置文件例子，可供参考

  1. [root@localhost supervisord.d]# pwd
  2. /etc/supervisord.d
  3. [root@localhost supervisord.d]# ls
  4. ziot.ini
  1. ;/etc/supervisord.d/zrdev.ini
  3. [program:ziot]                                                                     ;程序名称
  5. command     =sudo /usr/bin/env python3 /data/ziot/ziot-backend-product/server.py   ;执行该程序所需命令 
  6. directory   = /data/ziot/ziot-backend-product                                      ;执行上述命令前先跳转到此目录
  7. user        = root                                                                 ;执行命令的用户
  8. startsecs   = 3
  9. autostart   = true
  11. redirect_stderr         = true
  12. stdout_logfile_maxbytes = 50MB
  13. stdout_logfile_backups  = 10
  14. stdout_logfile          = /data/ziot/ziot-backend-product/app_log/app.log          ;日志存放路径

配置好之后重启supervisor即可。