使用Nginx和Gunicorn部署Django项目

Posted 2021-04-11 码道仕

创建虚拟独立环境

# 创建虚拟环境
$ virtualenv --python /usr/local/bin/python3.6 py-env-boluomi
# 进入虚拟环境
$ source py-env-boluomi/bin/activate
# 退出依赖环境
(py-env-boluomi)$ deactivate

安装依赖包

# 在虚拟环境中安装django
(py-env-boluomi)$ pip install django
# 在虚拟环境中安装mysqlclient
(py-env-boluomi)$ pip install mysqlclient
# 在虚拟环境中安装gunicorn
(py-env-boluomi)$ pip install gunicorn

创建Django项目

# 在项目目录创建Django项目
(py-env-boluomi)$ django-admin startproject boluomi

项目目录结构如下：

boluomi
├── boluomi
│   ├── __init__.py
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
└── manage.py

编辑settings.py文件，将数据库改为MySQL：

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        'NAME': 'boluomi',
        'USER': 'root',
        'PASSWORD': '123456',
        'HOST': '127.0.0.1',
        'PORT': '3306',
        'OPTIONS': {
            'init_command':"SET sql_mode='STRICT_TRANS_TABLES'",
        },
    }
}

根据模型将数据表同步到数据库：

(py-env-boluomi)$ python manage.py migrate 

根据提示创建一个admin的管理账户：

(py-env-boluomi)$ python manage.py createsuperuser

启动Django内置服务器：

(py-env-boluomi)$ python manage.py runserver 0.0.0.0:8080

配置Gunicorn

在实际生产环境中不会使用Django内置的单线程开发服务器，可以采用Gunicorn，Gunicorn是一个被广泛使用的高性能的Python WSGI UNIX HTTP服务器。Gunicorn采用pre-fork worker模式，具有使用非常简单，轻量级的资源消耗，以及高性能等特点。

# 使用方法
# gunicorn [OPTIONS] 模块名:变量名
# 模块名是python文件名（可以是完整的路径+python文件名）
# 变量名是python文件中可调用的WSGI（Web Server Gateway）

# [OPTIONS]
# 指定一个配置文件
# -c CONFIG, --config

# 绑定socket
# -b ADDRESS, --bind ADDRESS

# 以守护进程方式运行Gunicorn进程
# -D, --daemon

# 切换到指定的工作目录
# --chdir CHDIR

# 工作进程的数量，在Gunicorn启动的时候，在主进程中预先fork出指定数量的worker进程处理请求
# -w INT, --workers INT

# worker重启前处理的最大请求数
# --max-requests INT

# worker空闲的超时时间，空闲超时将重启（默认30秒）
# -t INT, --timeout INT

# 指定访问日志文件
# --access-logfile FILE

# 指定error log的错误级别
# --log-level LEVEL

# 指定错误日志文件
# --error-logfile FILE, --log-file FILE

启动/关闭/重启Gunicorn：

# 启动Gunicorn
(py-env-boluomi)$ gunicorn boluomi.wsgi:application --bind 0.0.0.0:8080 --workers 2
# 关闭Gunicorn
$ pstree | grep gunicorn | grep -v grep | awk 'NR==1{system("kill -QUIT "$2)}'
# 重启Gunicorn
$ pstree | grep gunicorn | grep -v grep | awk 'NR>1{system("kill -HUP "$2)}'

在生产环境使用Gunicorn需要添加很多配置，通常我们会把这些配置写成一个bash脚本，如下所示：

#!/bin/bash
# 激活虚拟环境
VIRTUALENV_DIR=/data/server/workspace/py-project/py-env-boluomi
source $VIRTUALENV_DIR/bin/activate
#进入项目目录
DJANGO_DIR=/data/server/workspace/py-project/boluomi
cd $DJANGO_DIR
#启动Gunicorn服务
gunicorn boluomi.wsgi:application \
--bind 0.0.0.0:8080 \
--workers 2 \
--timeout 30 \
--daemon \
--access-logfile /data/logs/gunicorn/boluomi_access.log \
--error-logfile /data/logs/gunicorn/boluomi_error.log

==用Gunicorn启动服务后，Django的admin无法显示static文件，解决方法如下：==

在项目的settings.py中设置ALLOWED_HOSTS：

# 这个参数的设置是为了限制一些主机的访问，当Debug=False的时候，这个值是必须要设定的，否则会报错。
# 其值是一个列表，可以是ip地址，也可以是域名，还可以支持通配符。
ALLOWED_HOSTS = ['*']

在项目的settings.py中添加STATIC_ROOT：

STATIC_ROOT = os.path.join(BASE_DIR, 'static')

执行如下命令会自动创建static文件夹，并把静态文件全部复制到static文件夹中：

$ python manage.py collectstatic 

在项目urls.py中添加如下内容：

from django.conf import settings
from django.conf.urls import url
from django.views.static import serve

# DEBUG为Fasle时执行
if not settings.DEBUG:
    urlpatterns += [url(r'^static/(?P<path>.*)$', serve, {'document_root': settings.STATIC_ROOT})]

配置nginx

通常Gunicorn会部署在Nginx后面，Nginx会直接解析静态请求，并将动态请求转发给Gunicorn去解析。

server {
    listen       80;
    server_name  boluomi.corp.haozu.com;

    access_log   /data/logs/nginx/boluomi_access.log  main;
    error_log    /data/logs/nginx/boluomi_error.log;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }

    location /static {
        alias /data/server/workspace/py-project/boluomi/static;
    }
}