网站功能——使用 Supervisor 部署 Django 应用程序
网站功能——使用 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配置文件
安装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：