Supervisor使用手册

引言

在Linux系统运维与开发过程中，进程管理是确保服务稳定运行的关键环节。Supervisor作为一款轻量级、跨平台的进程控制工具，能够有效地监控、启动、停止和重启应用程序进程，尤其适用于需要长期运行的服务。本文将深入探讨Supervisor的安装、配置、使用以及高级功能，旨在为开发者及系统管理员提供一份详尽的使用指南。

一、Supervisor概述

1.1 什么是Supervisor？

Supervisor是一个用Python编写的进程管理系统，它允许用户以声明式的方式管理Unix/Linux系统上的进程。通过配置文件定义需要监控的进程，Supervisor可以自动重启失败的进程，确保服务的连续性。此外，Supervisor还提供了Web界面和命令行工具，方便用户进行远程管理和监控。

1.2 Supervisor的核心特性

• 自动重启：当进程意外终止时，自动尝试重启。
• 日志管理：支持将进程输出重定向到日志文件，便于问题排查。
• 灵活配置：通过INI格式的配置文件定义进程组和单个进程。
• Web界面：提供基于Web的图形界面，便于远程管理和监控。
• 多进程管理：支持同时管理多个进程，实现服务集群的统一管理。

二、安装与配置

2.1 安装Supervisor

Supervisor可以通过包管理器（如apt、yum）或pip进行安装。以Ubuntu为例：

sudo apt-get update
sudo apt-get install supervisor

2.2 配置Supervisor

Supervisor的配置文件通常位于/etc/supervisor/supervisord.conf。该文件包含全局设置和进程组定义。

2.2.1 全局设置

• [unix_http_server]：配置Unix域套接字，用于Web界面和命令行工具的通信。
• [supervisord]：Supervisor守护进程的配置，如日志文件位置、PID文件等。
• [rpcinterface:supervisor]：RPC接口配置，允许远程控制。
• [supervisorctl]：命令行客户端配置，用于与supervisord通信。

2.2.2 进程组定义

在[program:name]部分定义需要监控的进程。例如，监控一个名为myapp的Node.js应用：

[program:myapp]
command=/usr/bin/node /path/to/myapp.js
directory=/path/to/myapp
user=nobody
autostart=true
autorestart=true
stderr_logfile=/var/log/myapp.err.log
stdout_logfile=/var/log/myapp.out.log

• command：启动进程的命令。
• directory：工作目录。
• user：运行进程的用户。
• autostart：Supervisor启动时自动启动该进程。
• autorestart：进程意外终止时自动重启。
• stderr_logfile和stdout_logfile：错误和标准输出的日志文件。

三、使用Supervisor

3.1 启动与停止Supervisor

• 启动Supervisor：

  sudo service supervisor start
  # 或
  sudo systemctl start supervisor

• 停止Supervisor：

  sudo service supervisor stop
  # 或
  sudo systemctl stop supervisor

3.2 管理进程

使用supervisorctl命令行工具管理进程：

• 查看进程状态：

  sudo supervisorctl status

• 启动进程：

  sudo supervisorctl start myapp

• 停止进程：

  sudo supervisorctl stop myapp

• 重启进程：

  sudo supervisorctl restart myapp

3.3 Web界面

Supervisor提供了基于Web的图形界面，通过配置[unix_http_server]和[inet_http_server]（如需TCP访问）可以访问。默认情况下，Web界面监听在127.0.0.1:9001，可通过浏览器访问http://localhost:9001。

四、高级功能

4.1 进程组与事件监听

Supervisor支持将多个进程组织成进程组，便于统一管理。此外，可以通过[eventlistener:name]定义事件监听器，响应进程状态变化等事件。

4.2 环境变量配置

在进程定义中，可以使用environment参数设置环境变量：

[program:myapp]
command=/usr/bin/node /path/to/myapp.js
environment=NODE_ENV="production",DB_HOST="localhost"

4.3 优先级与依赖管理

通过priority参数设置进程启动顺序，startsecs参数设置进程启动后等待稳定的时间。利用[program:name]中的startsecs和priority可以实现进程间的依赖管理。

五、最佳实践与故障排查

5.1 最佳实践

• 日志轮转：配置logrotate定期轮转日志文件，防止日志文件过大。
• 监控告警：结合Nagios、Zabbix等监控工具，设置Supervisor进程状态的告警。
• 配置备份：定期备份Supervisor配置文件，以防配置丢失。

5.2 故障排查

• 进程无法启动：检查command路径是否正确，权限是否足够，依赖是否满足。
• 日志无输出：确认stderr_logfile和stdout_logfile路径可写，权限正确。
• Web界面无法访问：检查[unix_http_server]或[inet_http_server]配置，防火墙设置。

结论

Supervisor作为一款强大的进程管理工具，通过其灵活的配置、自动重启机制和丰富的管理功能，极大地提高了Linux系统上应用程序的稳定性和可管理性。本文详细介绍了Supervisor的安装、配置、使用以及高级功能，希望为开发者及系统管理员提供一份实用的参考指南。通过合理利用Supervisor，可以构建更加健壮、可靠的服务架构。