如何在 Ubuntu 上安装和配置 Supervisor

您应该收到以下输出：

Output
● supervisor.service - Supervisor process control system for UNIX
Loaded: loaded (/lib/systemd/system/supervisor.service; enabled; vendor preset: enabled)
Active: active (running) since Wed 2021-11-17 22:56:48 UTC; 5min ago

现在我们已经安装了 Supervisor，我们可以看看添加我们的第一个程序。

第 2 步 - 添加程序

使用 Supervisor 的最佳实践是为它将处理的每个程序编写一个配置文件。

在 Supervisor 下运行的所有程序都必须在非守护模式下运行（有时也称为“前台模式”）。如果默认情况下你的程序在运行后会自动返回到 shell，那么你可能需要查阅程序的手册来找到启用此模式的选项，否则 Supervisor 将无法正确确定程序的状态。

为了演示 Supervisor 的功能，我们将创建一个 shell 脚本，该脚本除了每秒生成一些可预测的输出外，什么都不做，但将在后台连续运行，直到手动停止。使用 nano 或您喜欢的文本编辑器，在主目录中打开一个名为 idle.sh 的文件：

$ nano ~/idle.sh

添加以下内容：

#!/bin/bash
while true
do 
  # Echo current date to stdout
  echo `date`
  # Echo 'error!' to stderr
  echo 'error!' >&2
  sleep 1
done

接下来，使您的脚本可执行：

$ chmod +x ~/idle.sh

Supervisor程序的每个程序配置文件位于 /etc/supervisor/conf.d 目录中，通常每个文件运行一个程序，并以 .conf 结尾。我们将为此脚本创建一个配置文件，as'/etc/supervisor/conf.d/idle.conf：

$ sudo nano /etc/supervisor/conf.d/idle.conf

添加这些内容：

[program:idle]
command=/home/ubuntu/idle.sh
autostart=true
autorestart=true
startretries=3
stderr_logfile=/var/log/idle.err.log
stdout_logfile=/var/log/idle.out.log

我们将逐行回顾这一点：

command=/home/ubuntu/idle.sh

配置首先定义一个程序，其名称为 idle 和该程序的完整路径

autostart=true
autorestart=true
startretries=3

接下来的两行定义了脚本在特定条件下的自动行为。

autostart选项告诉 Supervisor 该程序应该在系统引导时启动。将此设置为 false 将需要在任何系统关闭后手动启动。

autorestart定义在程序退出时 Supervisor 应如何管理程序：

• false告诉 Supervisor 退出后不要重新启动程序。
• true告诉Supervisor总是在程序退出后重新启动程序。
• unexpected告诉 Supervisor 仅在程序以意外错误代码退出时才重新启动程序（默认情况下，代码 0 或 2 除外）。要了解有关错误代码的更多信息，请查看errno命令。

stderr_logfile=/var/log/idle.err.log
stdout_logfile=/var/log/idle.out.log

最后两行定义程序的两个主日志文件的位置。如选项名称所示，stdout 和 stderr 将分别定向到stdout_logfile和stderr_logfile位置。指定的目录必须已经存在，因为 Supervisor 不会尝试创建任何丢失的目录。

我们在此处创建的配置是 Supervisor 程序的最小模板。Supervisor 文档列出了更多可选配置选项，可用于调整程序的运行方式.

创建并保存配置文件后，我们可以通过 supervisorctl 命令通知 Supervisor 我们的新程序。首先，我们告诉 Supervisor 在 /etc/supervisor/conf.d 目录中查找任何新的或已更改的程序配置：

$ sudo supervisorctl reread

Output
idle: available

 然后告诉它通过以下方式进行任何更改：

$ sudo supervisorctl update

Output
idle: added process group

每当您对任何程序配置文件进行更改时，运行前面的两个命令都会使更改生效。
此时我们的程序应该正在运行。我们可以通过查看输出日志文件来检查它的输出：

$ sudo tail /var/log/idle.out.log

输出:
2022年 05月 29日 星期日 13:17:44 CST
2022年 05月 29日 星期日 13:17:45 CST
2022年 05月 29日 星期日 13:17:46 CST
2022年 05月 29日 星期日 13:17:47 CST
2022年 05月 29日 星期日 13:17:48 CST
2022年 05月 29日 星期日 13:17:49 CST
2022年 05月 29日 星期日 13:17:50 CST
2022年 05月 29日 星期日 13:17:51 CST
2022年 05月 29日 星期日 13:17:52 CST
2022年 05月 29日 星期日 13:17:53 CST

supervisorctl最初将打印所有已配置程序的状态和正常运行时间，然后是其命令提示符。输入help将显示其所有可用命令：

$ supervisor> help

输出:
default commands (type help <topic>):
=====================================
add    exit      open  reload  restart   start   tail   
avail  fg        pid   remove  shutdown  status  update 
clear  maintail  quit  reread  signal    stop    version

您可以使用关联的命令后跟程序名称来start or stop程序：

$ supervisor> stop idle

使用tail命令，您可以查看程序的 stdout 和 stderr 日志中的最新条目：

$ supervisor> tail idle

Output
Sun Nov 21 00:36:10 UTC 2021
Sun Nov 21 00:36:11 UTC 2021
Sun Nov 21 00:36:12 UTC 2021
Sun Nov 21 00:36:13 UTC 2021
Sun Nov 21 00:36:14 UTC 2021
Sun Nov 21 00:36:15 UTC 2021
Sun Nov 21 00:36:17 UTC 2021

$ supervisor> tail idle stderr

Output
error!
error!
error!
error!
error!
error!
error!

$ supervisor> status

Output
idle                      STOPPED    Nov 21 01:07 AM

$ supervisor> quit

$ nano /etc/supervisor/supervisord.conf

[inet_http_server]
port=*:9001
username=admin
password=admin

$ systemctl restart supervisor