填坑！！！virtualenv 中 nginx + uwsgi 部署 django

2023-08-19 09:12:22

一、为什么会有这篇文章

第一次接触 uwsgi 和 nginx ,这个环境搭建，踩了太多坑，现在记录下来，让后来者少走弯路。

本来在 Ubuntu14.04 上搭建好了环境，然后到 centos7.4 就遇到了一堆问题。下面把步骤记录下来，中间会记录遇到的问题及解决方案。

二、开发环境搭建

安装 python3

我的 centos7.4 预装了 python2.7.5 ，首先安装 python3，这里我选择 python3.4。

添加epel源：

yum install epel-release

安装Python3.4：

yum install python34

安装 pip3

yum install python34-setuptools

easy_install-3.4 pip

安装 django

版本选择：

Django 1.5.x 支持 Python 2.6.5 Python 2.7, Python 3.2 和 3.3

Django 1.6.x 支持 Python 2.6.X, 2.7.X, 3.2.X 和 3.3.X

Django 1.7.x 支持 Python 2.7, 3.2, 3.3, 和 3.4 （注意：Python 2.6 不支持了）

Django 1.8.x 支持 Python 2.7, 3.2, 3.3, 3.4 和 3.5. （长期支持版本 LTS)

Django 1.9.x 支持 Python 2.7, 3.4 和 3.5. 不支持 3.3 了

Django 1.10.x 支持 Python 2.7, 3.4 和 3.5

Django 1.11.x 支持 Python 2.7, 3.4, 3.5 和 3.6（长期支持版本 LTS) 最后一个支持 Python 2.7 的版本

Django 2.0.x 支持 Python 3.4, 3.5 和 3.6 （注意，不再支持 Python 2）

安装 django 1.11.13 ：

pip3 install Django==1.11.13

验证 django 是否安装成功，终端上输入 python3 ,点击 Enter，进入 python3 环境：

>>> import django

>>> django.VERSION

(1, 11, 13, 'final', 0)

>>> django.get_version()

'1.11.13'

安装 Virtualenv (虚拟环境依赖)

1. 为什么要安装虚拟环境依赖

在开发Python应用程序的时候，我系统安装的 Python3 只有一个版本：3.4。所有第三方的包都会被pip3 安装到 Python3 的 site-packages 目录下。如果我们要同时开发多个应用程序，那这些应用程序都会共用一个Python3 ，就是安装在系统的Python 3。如果应用A应用需要 django1.11，而应用B需要 django 2.0 怎么办？

这种情况下，每个应用可能需要各自拥有一套“独立”的Python运行环境。virtualenv 就是用来为一个应用创建一套“隔离”的Python运行环境。

virtualenv 用的时候参数比较复杂，本文不细说了，可以上网搜索了解一下，这里在再安装 virtualenvwrapper ，顾名思义，virtualenvwrapper 就是对 virtualenv 的一个包装，让其用起来更简单。

2. pip安装虚拟环境依赖

pip3 install virtualenv

pip3 install virtualenvwrapper

3.配置环境变量

修改 ~/.bashrc 配置环境变量：

centos7.4 中：

if [ -f /usr/bin/virtualenvwrapper.sh ]; then

  export WORKON_HOME=$HOME/virtualenvs

  export PROJECT_HOME=$HOME/workspace

  export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3

  source /usr/bin/virtualenvwrapper.sh

fi

ubuntu 14.04中：

if [ -f /usr/local/bin/virtualenvwrapper.sh ]; then

  export WORKON_HOME=$HOME/.virtualenvs

  export PROJECT_HOME=$HOME/workspace

  export VIRTUALENVWRAPPER_PYTHON=/usr/bin/python3

  source /usr/local/bin/virtualenvwrapper.sh

fi

修改后使之立即生效(也可以重启终端使之生效)：

source ~/.bashrc

这是第一个坑：在 Ubuntu 14.04 中，virtualenvwrapper.sh 文件路径和 centos7.4 中不一样在，这个坑很容易发现，因为下面，你执行命令的时候会报错，找不到文件，这个坑容易填。

3. 虚拟环境使用方法：

mkvirtualenv env1：创建运行环境 env1

workon env1: 工作在 env1 环境或从其它环境切换到 env1 环境

deactivate: 退出终端环境

其它的：

rmvirtualenv ENV：删除运行环境ENV

mkproject mic：创建mic项目和运行环境mic

mktmpenv：创建临时运行环境

lsvirtualenv: 列出可用的运行环境

lssitepackages: 列出当前环境安装了的包

创建的环境是独立的，互不干扰，无需sudo权限即可使用 pip 来进行包的管理。

三、部署环境搭建

安装 nginx

1.安装 nginx

ubuntu 中：

apt-get install nginx

centos中：

yum install epel-release

yum install nginx

2.验证 nginx 是否安装成功

查看 nginx 配置文件：

cat /etc/nginx/nginx.conf

截取部分内容如下：

截图第二行，配置了 nginx 错误日志保存地址，

重点关注 http 下的 server 中 listen 显示了默认监听的端口是 80 ，可以修改端口号。

server 上面有一行： include /etc/nginx/conf.d/*.conf;，这样我们可以将自定义的配置文件，放到 /etc/nginx/conf.d/ 目录下，以 .conf 后缀命名即可。

验证 nginx 是否安装成功,则启动 nginx ：

service start nginx

通过浏览器访问该 ip 80 端口,能正确返回下面页面,说明 nginx 安装成功。

坑：网上收到很多资料启动 nginx 的命令：nginx start,nginx -s start,nginx -s reload。可能是 nginx 版本不同原因，本人亲测，启动、关闭、重新加载 nginx 服务命令如下：

service start nginx

service stop nginx

service restart nginx

** 追加：**

systemctl start nginx

安装 uwsgi

1.安装 uwsgi

python 安装 uwsgi 方法有很多，但是也有坑。官方文档上说：

要构建uWSGI，您需要Python和一个C编译器（gcc并且clang受支持）。根据您希望支持的语言，您将需要他们的开发头文件。在Debian / Ubuntu系统上，您可以安装它们（以及构建软件所需的其他基础架构），具体如下：

首先安装依赖文件：

Ubuntu 中：

apt-get install build-essential

apt-get install python-dev

centos中：

yum install epel-release

yum groupinstall "Development Tools"

yum install python-devel

坑：上面的命令针对 python2，对应 python3 中，Ubuntu 中应该改成是 apt-get install python3-dev，而 centos 中，yum install python3-devel 会找不到 python3-devel 包，网上有人说执行 yum install -y python3-devel.x86_64,同样也找不到包。同时应注意， ubuntu 和 centos 中包名也不一样。解决方法:How to install python3-devel on red hat 7

所以针对 python3：

ubuntu 中：

apt-get install python3-dev

centos 中：

先执行：yum search python3 | grep devel,

python34-cairo-devel.x86_64 : Libraries and headers for python34-cairo

python34-greenlet-devel.x86_64 : C development headers for python34-greenlet

python34-devel.x86_64 : Libraries and header files needed for Python 3

                      : development

python34-gobject-devel.x86_64 : Development files for embedding Python 3.4

python36-devel.x86_64 : Libraries and header files needed for Python development

shiboken-python34-devel.x86_64 : Development files for shiboken

然后依次执行：

yum install -y python34-cairo-devel.x86_64

yum install -y python34-greenlet-devel.x86_64

yum install -y python34-devel.x86_64

yum install -y python34-gobject-devel.x86_64

yum install -y shiboken-python34-devel.x86_64

我把 python3.4 相关的包都安装了。

下载源码编译：

wget https://projects.unbit.it/downloads/uwsgi-latest.tar.gz

tar zxvf uwsgi-latest.tar.gz

cd <dir>

make

坑：上面步骤也是对应于 python2，对于 python3 在 make 之前，一定要先执行：

python3 uwsgiconfig.py --build ,执行这个命令可能会报错：

原因是 python-devel 对应的 python3 依赖包没有安装。如果不巧，你刚好没有执行这个命令，就直接编译，并且通过了，则相当于，到时候，会出现 uwsgi 执行时找不到 module 或者 app ,

诸如 "No module named site " 或者下面信息之类的错误。

cannot open shared object file: No such file or directory

unable to load app 0

pip3 安装（推荐）

pip3 install uwsgi

如果出现错误，则是依赖包没安装好，见上面下载源码编译的坑。

2.验证 uwsgi 是否安装成功

下面的来自 uwsgi 官方文档：

我们从一个简单的“Hello World”例子开始：

def application （env ， start_response ）：

    start_response （'200 OK' ， [（'Content-Type' ，'text / html' ）]）

    return  [ b “Hello World” ]

（保存为foobar.py）。

如您所见，它由一个Python函数组成。它被称为“应用程序”，因为这是uWSGI Python加载程序将搜索的默认函数（但您明显可以自定义它）。

部署HTTP端口9090上

现在启动uWSGI运行一个HTTP服务器/路由器，将请求传递给你的WSGI应用程序：

uwsgi --http：9090 --wsgi-file foobar.py

就这样。

下面通过浏览器访问该 ip 80 端口,能正确返回“ Hello World”。

注意：如果前面没有成功安装 python3 相关的依赖包，这里也能正确访问。但是部署 django 网站时会出错。

如果出现下面错误：

your processes number limit is 16384

your memory page size is 4096 bytes

detected max file descriptor number: 65536

lock engine: pthread robust mutexes

thunder lock: disabled (you can enable it with --thunder-lock)

probably another instance of uWSGI is running on the same address (:8080).

bind(): Address already in use [core/socket.c line 769]

则是 uwsgi 启动太多次了，可以用命令杀掉这个端口在重启：

sudo fuser -k 8080/tcp

(用自己配置的端口号)

四、virtualenv + nginx + uwsgi 部署 django 网站

如果前面的步骤都没问题了，这一步只要把配置文件写正确，就没什么问题了。记得在虚拟环境中安装所有的 project 需要依赖包。

下面是一个简单示例：

uwgsi 配置

uwsgi 支持多种形式的配置，可以执行 uwsgin 直接带参数，可以用 xml 文件配置等等，这里用 ini 文件配置。

新建一个 ini 文件，比如命名为：'dj_uwsgi.ini'

[uwsgi]

socket = :9090

chdir = /home/sharpcj/PythonProjects/testsite     # 切换到 project 目录

env = DJANGO_SETTINGS_MODULE=testsite.settings

module = testsite.wsgi

master = true

wsgi-file = testsite/wsgi.py

home = /home/sharpcj/.virtualenvs/testsite_evn   # python 及相关依赖包所在 path

touch-file = testsite/wsgi.py

processes = 4

threads = 2

chmod-socket = 664

vacuum = true

注意：为了配合 nginx 工作，端口协议是 socket , 如果换成 http ,则可以直接运行uwsgi，就能通过浏览器访问页面了。命令为 uwsgi dj_uwsgi.ini。

nginx 配置

在 /etc/nginx/conf.d/ 下创建 testsite.conf 文件：

server {

    listen         9999;

    server_name    127.0.0.1

    charset UTF-8;

    access_log      /var/log/nginx/myweb_access.log;

    error_log       /var/log/nginx/myweb_error.log;

    client_max_body_size 75M;

    location /media  {

        alias /home/sharpcj/PythonProjects/testsite/media;

    }

    location /static {

        alias /home/sharpcj/PythonProjects/testsite/static;

    }

    location / {

        uwsgi_pass  127.0.0.1:9090;

        include     /etc/nginx/uwsgi_params;

    }

 }

listen 指定的是nginx代理uwsgi对外的端口号。

server_name 网上大多资料都是设置的一个网址（例，www.example.com），我这里如果设置成网址无法访问，所以，指定的到了本机默认ip。在进行配置的时候，我有个问题一直想不通。nginx到底是如何uwsgi产生关联。现在看来大概最主要的就是这两行配置。

    include uwsgi_params;

    uwsgi_pass 127.0.0.1:9090;

include 必须指定为 uwsgi_params ；而 uwsgi_pass 指的本机IP的端口号与 dj_uwsgi.ini 配置中的文件中的必须一致。

此时启动 nginx 服务，并启动 uwsgi 服务，即可通过 ip:9999 访问网站。

通过这个IP和端口号的指向，请求应该是先到nginx的。如果你在页面上执行一些请求，就会看到，这些请求最终会转到uwsgi来处理。

ps：这个过程本应不算复杂，前天花了一下午时间没搞定，昨天又花了一下午时间才搞定。网上搜到的文章比较乱，有些太简单的看不懂，有些又太啰嗦的不知道核心的几步是什么，有些又因为版本不对，或者环境不同，不能成功，希望本文能帮到后面的人。

码农公寓