其实我的网站一开始的部署方式就是 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来启动Django
  • directory：启动命令前进入的目录，比如这里是进入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：

参考文章

版权声明：如无特殊说明，文章均为本站原创，转载请注明出处

本文链接：https://tendcode.com/subject/article/Supervisor_gunicorn_django/

许可协议：署名-非商业性使用 4.0 国际许可协议