JIYIK CN >

Generally, the configuration files of supervisor are /etc/supervisord.conf. The directory where tasks are stored is /etc/supervisord.d, and you can create a new file named yourname.ini under this directory. Each .ini file is a task, and we can configure our service commands and other information in this task file. The following is the template of the .ini file

[program:theprogramname]        ; program是固定的，后面是任务名称，可以自定义。该名称用于之后 客户端 supervisorctl 的管理
command=/bin/server            ; 启动服务的命令/方式；the program (relative uses PATH, can take args)
process_name=%(program_name)s   ; process_name expr (default %(program_name)s)
numprocs=1                    ; number of processes copies to start (def 1)
directory=/tmp                ; directory to cwd to before exec (def no cwd)
umask=022                     ; umask for process (default None)
priority=999                  ; the relative start priority (default 999)
autostart=true                ; start at supervisord start (default: true)
autorestart=true              ; retstart at unexpected quit (default: true)
startsecs=10                  ; number of secs prog must stay running (def. 1)
startretries=3                ; max # of serial start failures (default 3)
exitcodes=0,2                 ; 'expected' exit codes for process (default 0,2)
stopsignal=QUIT               ; signal used to kill process (default TERM)
stopwaitsecs=10               ; max num secs to wait b4 SIGKILL (default 10)
user=chrism                   ; setuid to this UNIX account to run the program
redirect_stderr=true          ; redirect proc stderr to stdout (default false)
stdout_logfile=/a/path        ; stdout log path, NONE for none; default AUTO
stdout_logfile_maxbytes=1MB   ; max # logfile bytes b4 rotation (default 50MB)
stdout_logfile_backups=10     ; # of stdout logfile backups (default 10)
stdout_capture_maxbytes=1MB   ; number of bytes in 'capturemode' (default 0)
stdout_events_enabled=false   ; emit events on stdout writes (default false)
stderr_logfile=/a/path        ; stderr log path, NONE for none; default AUTO
stderr_logfile_maxbytes=1MB   ; max # logfile bytes b4 rotation (default 50MB)
stderr_logfile_backups=10     ; # of stderr logfile backups (default 10)
stderr_capture_maxbytes=1MB   ; number of bytes in 'capturemode' (default 0)
stderr_events_enabled=false   ; emit events on stderr writes (default false)
environment=A=1,B=2           ; process environment additions (def no adds)
serverurl=AUTO                ; override serverurl computation (childutils)

The task configuration file does not necessarily have to be in .ini format. This can be configured by modifying it in the supervisord.conf configuration file

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

Therefore, we can define the extension of the task configuration file ourselves. After the modification is completed, you need to restart the supervisord service

In the above template file, you can choose according to your needs. Of course, [program:theprogramname] and command are required.

After the file is added successfully, for example, the added task name is goserver[program:goserver], then use the supervisorctl command to start the task. The general steps are as follows

$ supervisorctl reread  # 重新读取配置文件
$ supervisorctl reload  # 读取新添加的或者更新的配置文件  但是不会重启任务
$ supervisorctl update  # 重启配置文件修改过的任务
$ supervisorctl start goserver  # 启动goserver任务
$ supervisorctl stop goserver   # 关闭goserver任务
$ supervisorctl restart goserver # 重启goserver任务
$ supervisorctl status  # 查看当前supervisord服务中各个任务的状态