20《Nginx 入门教程》使用 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 工程和第一个应用后,我们看到工程的结构目录如下:

5e7d673309d7a20604770292.png

为了让工程顺利跑起来,我们需要调整下工程中数据库的配置,在 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

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

5e7d67470988e3a305530401.png

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

5e7d674f090de0fe13660467.png

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

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

5e7d675b0953a88c13630728.png

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 服务。

5e7d676609330c3813660712.jpg

3. 小结

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

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,294评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,493评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,790评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,595评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,718评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,906评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,053评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,797评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,250评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,570评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,711评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,388评论 4 332
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,018评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,796评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,023评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,461评论 2 360
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,595评论 2 350

推荐阅读更多精彩内容