运维

概述

Supervisord 是一个轻量级的进程管理工具。它允许创建和管理多个进程，并提供一些高级功能，如进程监控、自动重启、日志管理等。

他和 Systemd 一样，都是用于管理进程的工具。

安装

1
apt install supervisor

安装完成后有个配置文件: supervisord.conf 如果找不到的话用 find 寻找一下就行.

然后需要启动 supervisord 服务:

1
supervisord -c /etc/supervisor/supervisord.conf

注意下,这里的配置文件是你实际的配置文件所在路径,如果你移动过这个 conf 文件的位置,请使用实际的路径.

进行配置

和上一篇文章一样继续假设我们的应用叫 project-apps 并且需要创建一个服务单元.

给supervisord 添加配置:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
[supervisord]
nodaemon=true
logfile=/dev/null
logfile_maxbytes=0
pidfile=/tmp/supervisord.pid

[program:project-apps]
command=/usr/local/bin/project-apps
user=nobody
environment=PATH="/usr/local/bin:/usr/bin:/bin"
autostart=true
autorestart=true
startsecs=10
startretries=3
redirect_stderr=true
stdout_logfile=/dev/stdout
stderr_logfile=/dev/stderr

逐项解释：

[supervisord] 部分：

  • nodaemon=true：以非守护进程模式运行（容器需要前台进程）。
  • logfile=/dev/null：禁用 supervisord 自身的日志文件（容器日志通过 stdout/stderr 收集）。
  • logfile_maxbytes=0：防止日志文件增长。
  • pidfile=/tmp/supervisord.pid：指定 PID 文件路径。

[program:project-apps] 部分：

  • command=/usr/local/bin/project-apps：运行的命令，等价于 systemd 的 ExecStart。
  • user=nobody：以 nobody 用户运行，等价于 systemd 的 User=nobody。
  • environment=PATH=...：设置环境变量，等价于 systemd 的 Environment。
  • autostart=true：supervisord 启动时自动启动 project-apps
  • autorestart=true：进程退出时自动重启，等价于 systemd 的 Restart=always。
  • startsecs=10：进程运行 10 秒后认为启动成功（避免频繁重启）。
  • startretries=3：启动失败时重试 3 次。
  • redirect_stderr=true：将 stderr 重定向到 stdout。
  • stdout_logfile=/dev/stdout：将 stdout 输出到容器日志。
  • stderr_logfile=/dev/stderr：将 stderr 输出到容器日志。

启动

1
supervisord -c /etc/supervisor/supervisord.conf

查看状态

1
supervisorctl status

停止

1
supervisorctl stop project-apps

重启

1
supervisorctl restart project-apps

支持的各个参数

参数名 描述 类型 默认值 示例值 与 systemd 的对应
command 指定要运行的命令或可执行文件路径 字符串 无（必填） project-apps ExecStart
user 指定运行进程的用户 字符串 无（以 supervisord 的用户运行） nobody User
environment 设置进程的环境变量，格式为 KEY=”value”,KEY2=”value2” 字符串 无 PATH="/usr/local/bin:/usr/bin:/bin" Environment
directory 运行命令前切换的工作目录 字符串 无（当前目录） /app WorkingDirectory
autostart 是否在 supervisord 启动时自动启动进程 布尔值 true true WantedBy（间接对应）
autorestart 进程退出时是否自动重启（true/false/unexpected） 字符串 false true Restart（always 对应 true）
startsecs 进程运行多少秒后认为启动成功（用于重启判断） 整数 1 10 无直接对应（类似 RestartSec）
startretries 启动失败时的最大重试次数 整数 3 3 无直接对应
exitcodes 视为正常退出的退出码（仅当 autorestart=unexpected 时生效） 逗号分隔的整数 0 0,2 无直接对应
stopwaitsecs 停止进程时等待的秒数（超时后发送 SIGKILL） 整数 10 10 TimeoutStopSec
stopasgroup 是否向整个进程组发送停止信号 布尔值 false true 无直接对应（类似 KillMode=process-group）
killasgroup 是否向整个进程组发送终止信号（SIGKILL） 布尔值 false true 无直接对应
stopsignal 用于停止进程的信号 字符串 TERM INT KillSignal
priority 进程启动的优先级（数字越小优先级越高） 整数 999 100 无直接对应（类似 Nice 或启动顺序）
numprocs 启动的进程实例数（多实例运行） 整数 1 2 无直接对应
numprocs_start 多实例进程的起始编号（与 numprocs 配合） 整数 0 1 无直接对应
process_name 进程名称模板（用于多实例，含 % 占位符） 字符串 %(program_name)s %(program_name)s_%(process_num)02d 无直接对应
redirect_stderr 是否将 stderr 重定向到 stdout 布尔值 false true 无直接对应（日志处理相关）
stdout_logfile stdout 日志输出文件路径（支持 /dev/stdout） 字符串 AUTO（自动生成日志文件） /dev/stdout 无直接对应（systemd 使用 journalctl）
stdout_logfile_maxbytes stdout 日志文件的最大大小 字符串 50MB 10MB 无直接对应
stdout_logfile_backups stdout 日志文件的备份数量 整数 10 5 无直接对应
stderr_logfile stderr 日志输出文件路径 字符串 AUTO /dev/stderr 无直接对应
stderr_logfile_maxbytes stderr 日志文件的最大大小 字符串 50MB 10MB 无直接对应
stderr_logfile_backups stderr 日志文件的备份数量 整数 10 5 无直接对应
stdout_capture_maxbytes stdout 捕获缓冲区大小（用于事件监听） 字符串 0 1MB 无直接对应
stdout_events_enabled 是否启用 stdout 事件（用于事件监听） 布尔值 false true 无直接对应
stderr_events_enabled 是否启用 stderr 事件 布尔值 false true 无直接对应