使用 Supervisor 部署 Django 应用程序
其实我的网站一开始的部署方式就是 gunicorn 启动 Django，就很简单的一个运行命令就行了。但是最近在搞网站的定时任务功能，也就是会使用到 celery 中间件，由于需要单独的进程启动 celery 相关的程序，所以网站需要变换部署方式。
具体的方案是加入 supervisor 来守护 gunicorn，也就是说使用 supervisor 来启动 gunicorn 进而运行 Django。
关于 Supervisor
初识 Supervisor
Supervisor是一个用于进程管理的开源工具，通常用于在Unix和类Unix系统上监控和控制进程的运行。它提供了一个简单而强大的方式来管理后台进程，例如Web服务器、任务队列、应用程序等。
Supervisor的主要功能包括：
进程监控：Supervisor可以监控指定的进程，并在进程意外终止时自动重新启动它们。这对于确保关键进程的持续运行非常有用，以及防止因进程崩溃而导致的服务中断。
进程控制：Supervisor允许您通过命令行或API控制进程的启动、停止、重启等操作。这使得管理和操作进程变得更加便捷，无需手动干预或编写复杂的脚本。
日志管理：Supervisor可以捕获和管理进程的输出日志，包括标准输出和标准错误。它提供了对日志文件的轻松访问和旋转，以便有效地跟踪和调试应用程序的运行情况。
配置灵活：Supervisor使用简单的配置文件来定义要监控和管理的进程。您可以为每个进程指定启动命令、工作目录、运行用户等信息，并通过配置文件灵活地定义进程之间的依赖关系。
扩展性：Supervisor支持通过插件扩展其功能。您可以使用插件来添加额外的监控指标、告警机制、Web界面等，以满足特定需求或增强系统的可视化和可管理性。
Supervisor的使用非常广泛，特别适用于服务器环境下的进程管理。它被广泛应用于Web服务器（如Nginx、Apache）、应用程序框架（如Django、Flask）、队列处理（如Celery）等场景，以确保关键进程的稳定运行和自动恢复。
总而言之，Supervisor是一个可靠而灵活的进程管理工具，它简化了在Unix系统上管理和监控后台进程的任务，提供了更好的稳定性和可管理性。
安装 Supervisor
由于 Supervisor 是一个 python 的第三方库，所以可以直接使用 pip 进行安装:
pip install supervisor
生成Supervisor配置文件
提示
也可以使用默认的配置，默认的配置文件为 /etc/supervisord.conf
安装Supervisor之后可以直接使用内置的命令来生成一个默认的配置文件，这个配置文件也是作为Supervisor的启动文件，具体命令为：
echo_supervisord_conf > supervisord.conf
这样就得到了一个基本的配置文件，不过文件里面大部分内容都是注释，而且很多都是非必需的配置，我们可以直接来一个基础配置，如下：
[supervisord]
logfile=/var/log/supervisor/supervisord.log
pidfile=/tmp/supervisord.pid
[unix_http_server]
file=/tmp/supervisor.sock
[rpcinterface:supervisor]
supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface
[supervisorctl]
serverurl=unix:///tmp/supervisor.sock
[include]
files = /opt/cloud/izone/supervisord.d/*.conf
这里有几个地方需要注意，第一个是 pidfile 参数，这个就是进程自动生成的 pid 文件地址，然后是 file 参数和 serverurl 参数的地址应该报错一致，这两个文件会自动生成，所以要保证权限有。
include 里面的 files 就很类似 nginx 配置里面的 conf.d 目录，就是表示配置可以加载其他地方的配置，比如一些进程配置可以放到这里，当然，你也可以直接把配置放到这个主配置文件中。
创建服务配置
上面的主配置中 include 的目录中创建服务配置，比如django.conf，放到 /opt/cloud/izone/supervisord.d/ 目录里面就行。
[program:gunicorn-django]
command=gunicorn izone.wsgi -b 0.0.0.0:8000
directory=/opt/cloud/izone
stdout_logfile=/var/log/supervisor/gunicorn.django.log
stderr_logfile=/var/log/supervisor/gunicorn.django.log
autostart=true
autorestart=true
startsecs=2
stopwaitsecs=2
priority=100
这里的参数解释一下：
command：启动的进程命令，比如这里是用gunicorn来启动Djangodirectory：启动命令前进入的目录，比如这里是进入Django项目根目录stdout_logfile和stderr_logfile：日志路径autostart：跟随supervisor一起启动autorestart：进程死掉自动重启startsecs：启动几秒后没有异常退出，就表示进程正常启动了stopwaitsecs：杀死进程前等待的时间priority：进程启动优先级，值小的最先启动，关闭的时候最后关闭
启动Supervisor
启动命令
配置创建之后，可以直接启动Supervisor，命令如下：
supervisord -c supervisord.conf
其实就很简单，使用 supervisord 启动，然后 -c 指定一下启动的配置文件。这个时候如果没有问题可以看到后台有个 gunicorn 进程在运行，也就是 django 在运行。
更新配置
涉及配置变动，需要更新。保存并关闭配置文件后，我们需要重新加载Supervisor的配置，使其生效。可以运行以下命令：
supervisorctl reread
supervisorctl update
这将使Supervisor读取新的配置文件并更新应用程序。
服务的操作
现在，可以使用Supervisor来启动、停止和管理Django应用程序了。可以运行以下命令：
supervisorctl start gunicorn-django
supervisorctl stop gunicorn-django
supervisorctl restart gunicorn-django
这将启动、停止或重新启动Django应用程序。
通过以上步骤，我们成功地使用Supervisor部署了Django应用程序。Supervisor将负责监控应用程序的运行状态，并在需要时自动重启应用程序。这样，我们可以确保Django应用程序在服务器上持续稳定地运行。
停止Supervisor
停止命令：
supervisorctl shutdown
容器化部署改动
修改 Dockerfile
由于更改了部署方式，所以在容器里面也要修改一下，之前是直接使用 gunicorn 来运行，现在改成 supervisord。
修改为:
FROM python:3.9
ARG pip_index_url=https://pypi.org/simple
ARG pip_trusted_host=pypi.org
ENV PYTHONUNBUFFERED=1
WORKDIR /opt/cloud/izone
RUN cp /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && \
mkdir -p /var/log/supervisor
COPY requirements.txt requirements.txt
RUN pip install --no-cache-dir -r requirements.txt --index-url $pip_index_url --trusted-host $pip_trusted_host
COPY . .
CMD ["supervisord", "-n", "-c", "supervisord.conf"]
在容器里面必须加上 -n 参数，表示在前台运行，不然容器是无法运行的。
修改 docker-compose 文件
由于这次改动直接把 CMD 命令写到镜像构建里面了，所以容器启动的时候就会自动执行这个命令，那原来 docker-compose 文件里面的 command 参数就可以删除，具体要删除的是这里：
command: gunicorn izone.wsgi -b 0.0.0.0:8000
总结
本文介绍了如何使用Supervisor来部署Django应用程序。通过配置Supervisor，我们可以轻松地管理Django应用程序的进程，并确保应用程序的稳定性和持续运行。
本次变更的代码提交记录见 github：