使用 nginx + gunicorn 来部署生产环境的 Django app

2022-10-25 21:00:51 浏览数 (3)

在测试环境下,我们可以简单的使用 python manage.py runserver 8080 启动一个 Django,由于尚未通过安全审核或性能测试,而且是单线程,并发能力也不强,因此不能在生产环境中使用。

生产环境下,需要使用专门的 Web 服务器,像 Gunicorn 或 uWSGI。

今天就来分享一下如何使用 nginx gunicorn 来部署生产环境的 Django app。

Gunicorn(Green Unicorn)是一个用于 UNIX 的 Python WSGI HTTP 服务器。Gunicorn 服务器广泛兼容各种 Web 框架,实现简单,服务器占用资源少,速度相当快。Django app 只是它支持的其中一种框架。

安装

代码语言:javascript复制
pip install gunicorn

gunicorn 没有依赖项,因此下载后可以很容易迁移到生产环境。

快速使用

直接在 Django 项目的目录内,也就是 manage.py 所在的目录内执行:

代码语言:javascript复制
gunicorn your_project.wsgi:application --bind 0.0.0.0:8000

即可启动生产级别的 Web 服务,前提是你的 Django settings 也是生产环境的配置,例如 Debug = False。

配置成系统服务

首先让我们创建一个系统级别的套接字文件:

代码语言:javascript复制
sudo vim /etc/systemd/system/gunicorn.socket

写入以下内容:

代码语言:javascript复制
[Unit]
Description=gunicorn socket

[Socket]
ListenStream=/run/gunicorn.sock

[Install]
WantedBy=sockets.target

然后创建一个 Gunicorn 系统服务文件:

代码语言:javascript复制
sudo vim /etc/systemd/system/gunicorn.service

写入以下内容:

代码语言:javascript复制
[Unit]
Description=gunicorn daemon
Requires=gunicorn.socket
After=network.target

[Service]
User=hitesh
Group=www-data
WorkingDirectory=/home/hitesh/myprojectdir
ExecStart=/home/hitesh/myprojectdir/myprojectenv/bin/gunicorn 
          --access-logfile - 
          --workers 3 
          --bind unix:/run/gunicorn.sock 
          myproject.wsgi:application

[Install]
WantedBy=multi-user.target

这样我们就可以在系统启动的时候启动 Gunicorn 服务,也可以很方面的启动、停止、重启 Gunicorn。

代码语言:javascript复制
sudo systemctl enable gunicorn
sudo systemctl start gunicorn
sudo systemctl stop gunicorn
sudo systemctl restart gunicorn

查看服务状态:

代码语言:javascript复制
sudo systemctl status gunicorn.socket

与 Nginx 配合

Nginx 非常适合处理静态文件,所以静态文件就交给 Nginx,然后服务接口交给 Gunicorn,让 Nginx 代理 Gunicorn。

一个简单的配置文件如下:

代码语言:javascript复制
server {
    listen 80;
    server_name server_domain_or_IP;

    location = /favicon.ico { access_log off; log_not_found off; }
    location /static/ {
        root /home/aaron/myprojectdir;
    }

    location / {
        include proxy_params;
        proxy_pass http://unix:/run/gunicorn.sock;
    }
}

测试配置文件是否有误:

代码语言:javascript复制
sudo nginx -t

如果没有错误,可以重启 Nginx 让新的配置文件生效:

代码语言:javascript复制
sudo nginx -s reload

你可能还需要配置你的证书。

Nginx 和 Gunicorn 故障排除

对于故障排除,日志可以帮助找到根本原因。检查以下日志可以帮助排除故障:

查看 Nginx 进程日志:sudo journalctl -u nginx

查看 Nginx 访问日志:sudo less /var/log/nginx/access.log

检查 Nginx 错误日志:sudo less /var/log/nginx/error.log

检查 Gunicorn 应用程序日志:sudo journalctl -u gunicorn

检查 Gunicorn 套接字日志:sudo journalctl -u gunicorn.socket

最后的话

本文分享了使用 nginx gunicorn 来部署生产环境的 Django app,生产环境下 Nginx 的反向代理,最好都使用 socket 来通讯,至于为什么,可以参考前文redis 是单线程,是怎么解决高并发问题的。如有收获,还请在看支持。

0 人点赞