Django + uWSGI + nginx 部署 Python Web 应用

Django + uWSGI + nginx 部署 Python Web 应用

在实现一些算法模式后，考虑的就是模型的部署了。对于一些相对独立的模型应用，如 OCR 识别引擎等，部署为独立的 Web 应用，以提供 API 的供其他系统调用的方式将是一个不错的解决方案。此方案的优点有以下几个方面：

• 模型应用与其他系统隔离，仅通过 web 请求调用，既能极大得扩展应用的兼容性，又便于模型的迭代升级。
• 当 web 应用启动后，模型文件加载到内存，每次运行模型都无需重新载入，大大缩短调用时间。

本文使用的环境

• ubuntu-16.04.3-server
• Anaconda3 的 Python 3.7
• Django-2.2.5
• uwsgi-2.0.18
• nginx-1.14.0

1、Django 的安装和使用

• 安装

pip install Django

• 创建项目

django-admin startproject demosite

将会在当前目录下创建一个web项目，项目目录结构如下：

demosite/
├── demosite
│   ├── __init__.py
│   ├── settings.py
│   ├── urls.py
│   └── wsgi.py
└── manage.py

在 demosite/demosite/ 目录下创建 views.py 文件，输入代码：

from diango.http import HttpResponse


def hello(request):
    return HttpResponse("Hello World! [CSD]")

进入 urls.py 文件中添加：

from demosite.views import hello

在 urlpatterns 中添加 url 路径：

urlpatterns = [
    path('admin/', admin.site.urls),
    path('hello/', hello),
]

修改 settings.py 文件，将本地的IP添加到 ALLOWED_HOSTS = [], 如：

ALLOWED_HOSTS = ['192.168.0.100'] 

• 启动项目

在 demosite 目录下，运行：

python manage.py runserver 192.168.0.100:8000

然后在浏览器中输入 url：

http://192.168.0.100:8000/hello/

就可以看的返回的

Hello World! [CSD]

Django 更高级的使用和配置可以参考官方文档：https://docs.djangoproject.com/en/2.2/

2、使用 uWSGI 管理 Django 应用

使用 uWSGI 就可以部署一个简单的 Django Web 应用，管理 WEB 请求实现良好的并发访问。同时 uWSGI 是 Django 推荐的方式: How to use Django with uWSGI，详情可参考 uWSGI 的官网.

• 安装 uWSGI

安装 uWSGI 需要 c 编译器，安装方法参考官方的安装指南，也可以用 conda 直接安装：

conda install -c conda-forge uwsgi

• 使用 uwsgi 启动 Django 应用

在 demosite 目录下(也可以在其他目录)新建 demo_uwsgi.ini 配置文件：

[uwsgi]
chdir = /home/csd/demosite
wsgi-file = demosite/wsgi.py
buffer-size = 65536
master = true
processes = 8
threads=10
http = 192.168.0.100:8080  
vaccum = true
daemonize = /home/csd/demosite/logs/demo_uwsgi.log

在 demosite 目录下创建文件夹：logs/

启动命令如下：

uwsgi --ini demo_uwsgi.ini --enable-threads

--enable-threads 参数用于启动多线程支持。

此时可以访问链接：

http://192.168.0.100:8080/hello/

此时关闭项目需要执行：

killall -9 uwsgi

• 安装 libiconv

如果上面启动 uwsgi 报错：

uwsgi: error while loading shared libraries: libiconv.so.2: cannot open shared object file: No such file or directory

则需要安装 libiconv

wget http://ftp.gnu.org/pub/gnu/libiconv/libiconv-1.14.tar.gz
tar zxvf libiconv-1.14.tar.gz
cd libiconv-1.14
./configure
sudo make
sudo make install

如果 make 出错：

/stdio.h:1010:1: error: ‘gets’ undeclared here (not in a function) 
_GL_WARN_ON_USE (gets, “gets is a security hole - use fgets instead”); 

则在 libiconv-1.14/srclib/stdio.in.h 文件中，将698行的代码：

_GL_WARN_ON_USE (gets, "gets is a security hole - use fgets instead");

替换为：

#if defined(__GLIBC__) && !defined(__UCLIBC__) && !__GLIBC_PREREQ(2, 16)
_GL_WARN_ON_USE (gets, "gets is a security hole - use fgets instead");
#endif

然后从新执行：

./configure
sudo make
sudo make install

安装完成后，切换 root 账户，输入以下命令：

echo '/usr/local/lib' >> /etc/ld.so.conf
ldconfig

最后输入：

iconv --version

如果能执行则安装正确。

3、nginx 部署

使用 nginx 服务器部署，实现负载均衡，更好得管理 WEB 请求。

• 安装

需要下载以下几个安装包：

nginx-1.14.0.tar.gz  
nginx_uploadprogress_module-0.9.0.tar.gz  
openssl-1.0.2o.tar.gz  
pcre-8.42.tar.gz

解压后进入 nginx-1.14.0/ 编译并安装 nginx：

./configure --prefix=/home/csd/nginx --with-openssl=../openssl-1.0.2o --with-pcre=../pcre-8.42 --add-module=../masterzen-nginx-upload-progress-module-a788dea --without-http_gzip_module
make
make install 

• 配置

进入安装目录 (/home/csd/nginx/) 下的 conf 目录，修改 nginx.conf 配置文件

将工作进程设置为4：

worker_processes  4;

nginx 默认监听 80 端口，所以有必要先查看 80 端口是否已被占用：

netstat -lnp|grep 80

如果被占用则改为其他端口，server 配置中增加如下配置：

server {
    listen       90;
    server_name  192.168.0.100;
    large_client_header_buffers 4 16k;
    client_max_body_size 300m;
    client_body_buffer_size 128k;
    proxy_connect_timeout 600;
    proxy_read_timeout 600;
    proxy_send_timeout 600;
    proxy_buffer_size 256k;
    proxy_buffers   16 256k;
    proxy_busy_buffers_size 512k;
    proxy_temp_file_write_size 512k;

    location / {
        root   html;
        index  index.html index.htm;
        include     uwsgi_params;
        uwsgi_pass   unix:/home/csd/demosite/uwsgi.sock;
    }
    location /static {
        alias /home/csd/demosite/static;
    }
    location /media {
        alias /home/csd/demosite/media;
    }
}

接着在 demosite 目录下创建 static/ 和 media/ 两个文件夹。将 demo_uwsgi.ini 中的

http = 192.168.0.100:8080

修改为

socket =  /home/csd/demosite/uwsgi.sock

在 settings.py 文件最后添加：

STATIC_ROOT = os.path.join(BASE_DIR, "static/")

• 启动服务

收集静态文件，在 demosite 目录下运行：

python manage.py collectstatic

启动 uwsgi：

uwsgi --ini demo_uwsgi.ini --enable-threads

启动 nginx：

sudo /home/csd/nginx/sbin/nginx

此时访问：

http://192.168.0.100:90/hello/