使用 Nginx 部署 Python 项目

今天的目标是完成一个 Python Web 项目的线上部署,我们使用最新的 Django 项目搭建一个简易的 Web 工程,然后基于 Nginx 服务部署该 Python Web 项目。

1. 前期准备

1.1 安装虚拟环境pyenv

首先要知道,使用虚拟环境逐渐成了 python 项目开发中的一种主流方式。pyenv 可以帮我们生成多个 python 的虚拟环境,这样我可以在同一台机器上使用 python2 或者 python3 或者 python3 的不同版本,避免不同项目因为依赖模块版本问题发生冲突。只要使用时,切换到那个具体的版本环境即可。下面来看在 CentOS 上如何安装并使用 pyenv :

# 安装git
$ yum install git
$ git clone https://github.com/pyenv/pyenv.git ~/.pyenv
# 安装 pyenv-virtualenv
$ git clone https://github.com/pyenv/pyenv-virtualenv.git $(pyenv root)/plugins/pyenv-virtualenv
$ cat ~/.bashrc
  ...

  # 在~/.bashrc最后加上如下3行
  export PATH="~/.pyenv/bin:$PATH"
  eval "$(pyenv init -)"
  eval "$(pyenv virtualenv-init -)"

# 使配置生效
$ source ~/.bashrc

# 查看pyenv的版本
$ pyenv version

# 查看 pyenv 已经托管了哪些 python 版本
$ pyenv versions

# 安装某个版本的python
$ pyenv install <version>

接下来我们安装 python 3.8.1 ,同时建立一个以该版本为基础的虚拟环境:

 # 安装python 3.8.1版本
 $ pyenv install 3.8.1
 # 建立一个虚拟环境,python版本选择3.8.1
 $ pyenv virtualenv 3.8.1 env-3.8.1
 # 激活该虚拟环境
 $ pyenv activate env-3.8.1
 # 查看该环境下python版本
 $ python

激活创建的虚拟环境后,在使用 python 就是3.8.1版本的了,pip 命令也是该虚拟环境下的命令。所有 pip 安装的模块都会被安装到该虚拟环境下,而不是主环境中。

1.2 创建django项目

接下来,我们通过 django 框架创建一个简单的 web 项目,操作系统是 CentOS 7.6。

 # 进入虚拟环境
 $ pyenv activate env-3.8.1
 # 安装django 2.2版本
 $ pip install django==2.2 -i https://pypi.tuna.tsinghua.edu.cn/simple
 # 使用django-admin命令创建项目
 $ django-admin startproject test_nginx
 $ cd test_nginx
 # 创建第一个应用
 $ django-admin startapp first

创建 django 的 web 工程和第一个应用后,我们看到工程的结构目录如下:

图片描述

为了让工程顺利跑起来,我们需要调整下工程中数据库的配置,在 test_nginx/settings.p 中,找到 DATABASES 变量的赋值语句,并修改成数据库相关配置,改为使用 mysql 提供数据库服务,因此我们需要额外准备一台有 mysql 服务的机器。具体修改如下图所示:

图片描述

最后,我们可以使用命令行启动该 django 服务了。

 # 安装依赖
 $ yum install mysql-devel
 $ pip install mysqlclient -i https://pypi.tuna.tsinghua.edu.cn/simple
 # 首先要生成django系统给我们准备好的一些数据表
 $ python manage.py migrate
 # 交互式启动django服务
 $ python manage.py runserver 0.0.0.0:8000

执行上述指令后的运行结果如下:

图片描述

访问主机的8000端口,发现有报错,如下:

图片描述

同样是 test_nginx/settings.py 中的配置问题,默认是只允许本机访问,要开放的话,可以在 settings.py 中的修改 ALLOWED_HOSTS 的赋值,具体如下:

# ALLOWED_HOSTS = []
# 添加*,允许其他主机访问django服务
ALLOWED_HOSTS = ['*']

图片描述

2. 基于 Nginx 完成 Django 工程的部署

2.1 安装 uwsgi

python web 服务必须通过 uwsgi 协议才能进行访问,因此需要安装 uwsgi 服务来转发 python 的 http 请求。因此,第一步我们要安装 uwsgi 服务:

# 激活虚拟环境
$ pyenv activate env-3.8.1
# 安装uwsgi服务
$ pip install uwsgi -i https://pypi.tuna.tsinghua.edu.cn/simple

2.2 使用 uwsgi 启动 django 服务

# 进入工程目录
$ cd /root/test_nginx
$ mkdir uwsgi
# 编辑uwsgi.ini
$ vim uwsgi.ini
$ cat uwsgi.ini
[uwsgi]
# 指定监听端口
socket = :8000
# 重要配置
chdir = /root/test_nginx   
# 重要,要有wsgi.py文件              
module = test_nginx.wsgi                

master = true
# 启动进程数
processes = 5
threads = 5
vacuum = true
stats=%(chdir)/uwsgi/uwsgi.status
pidfile=%(chdir)/uwsgi/uwsgi.pid

# 启动uwsgi服务, 使用-d参数可以放到后台运行
$ uwsgi -d --ini uwsgi.ini   

2.3 配置 nginx ,将请求转发到 uwsgi 服务处理

我们在 nginx 中只需要写上一段简单的配置,将可以将请求转发到对应的 uwsgi 服务上进行处理,具体如下:

$ cat /root/nginx/conf/nginx.conf
...
server {
   listen         8001;
   server_name    127.0.0.1
   charset UTF-8;
   access_log      /var/log/nginx/web_access.log;
   error_log       /var/log/nginx/web_error.log;

   client_max_body_size 75M;

   # 最重要的部分
   location / {
       include uwsgi_params;          # 通过uwsgi转发请求
       uwsgi_pass 127.0.0.1:8000;     # 和前面配置django服务的socket端口保持一致
       uwsgi_read_timeout 15;         # 设置请求超时时间
   }
}

...

重启 nginx 服务后,访问8081端口,我们就可以看到前面访问8000端口的结果了。不同的是,前面是交互式的,使用的是 django 内置的 uwsgi 服务。但是线上环境,一般不会这样去部署 django 服务,而是使用 nginx + uwsgi 配合部署 django web 服务。

图片描述

3. 小结

本节我们介绍了 python 的虚拟环境搭建,使用 django 框架创建第一个 web 工程,然后使用 uwsgi 服务运行该 django 项目,最后我们使用 Nginx 服务将 http 请求转发到 uwsgi 容器中的 django 工程去执行。最后我们从浏览器中成功访问了了 django 工程的首页,这表明着我们部署 django 项目成功。