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

一、为什么会有这篇文章

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