阿里云部署Django项目（超详细图文教程） —— Part2. 使用Nginx, Gunicorn, virtualenv, supervisor 部署Django应用

阿里云部署Django项目（超详细图文教程）

Part2. 使用Nginx, Gunicorn, virtualenv, supervisor 部署Django应用

前言：

花了一个月的空闲时间，终于成功把Django网站部署到了阿里云ECS上，包含以下功能：

• 不使用任何第三方工具，直接用网页连接阿里云ECS
• 使用GIT进行源码控制和上传到服务器
• 使用git hooks实现自动部署
• 用的是时下比较流行的一套部署方案——Nginx, Gunicorn, virtualenv, supervisor and PostgreSQL
• 可以在同一台服务器上部署两个、甚至多个网站

光说不练假把式，建议大家边看边操作！

软件介绍

nginx: 反向代理服务器，处理静态资源，负载均衡等。
gunicorn: Python WSGI HTTP Server for UNIX。
virtualenv: 创建独立的 python 环境。
supervisor: 基于linux操作系统的一款服务器管理工具，用以监控服务器的运行，发现问题能立即自动预警及自动重启等功能。

1.系统更新和软件安装

依次在远程管理终端下执行以下步骤，进行服务器系统更新和依赖软件安装：
* 更新系统

 sudo aptitude update
 sudo aptitude upgrade

* 安装数据库PostgreSQL

 sudo aptitude install postgresql postgresql-contrib
 sudo aptitude install libpq-dev python-dev

* 安装virtualenv

 sudo aptitude install python-virtualenv

* 安装Supervisor

 sudo aptitude install supervisor

* 安装Nginx

 sudo aptitude install nginx

PS: 可以使用右上角的“复制命令输入”将命令粘贴进来

过程中会提示需要多少的磁盘空间，如果空间够用的话选择 yes 就可以继续了，耐心等待更新包安装

对比文章标题，大家会发现Gunicorn还没有安装，稍后我们会在创建出的python环境中安装Gunicorn

2. 创建一个权限组来管理应用

出于安全和方便管理的目的，使用专门的用户组来操作web应用

• 添加用户组

sudo groupadd --system webapps

命令解释：
groupadd 添加用户组
–system 指定将要添加的用户组是系统级别的
webapps 用户组的名字，也可以叫djangoapps等，起名字最好有一定的意义
* 添加用户

 sudo useradd --system --gid webapps --shell /bin/bash --home /webapps/hello_django user_hello_django

命令解释：
useradd 添加用户
–gid 指定用户所属的组，后面紧跟的webapps就指定了用户属于webapps组
–shell 用户使用shell的路径，即/bin/bash
–home 用户home文件夹位置，即/webapps/hello_django，这个目录将是web应用的根目录
user_hello_django 用户名(起名字要有辨识度，最好能自解释)

• 为用户设置密码

  sudo passwd user_hello_django

• 给用户添加执行sudo命令的权限

  vim /etc/sudoers

  在root ALL=(ALL:ALL) ALL 下面添加一行：

  user_hello_django ALL=(ALL:ALL) ALL

• 创建目录并授权

     sudo mkdir -p /webapps/hello_django/
     sudo chown user_hello_django /webapps/hello_django/

命令解释：
mkdir 创建文件夹
chown 改变文件或文件夹的所有者
这几条命令都是linux的基础命令，有疑问可以百度之。

3.创建独立的python运行环境

• 切换用户

  sudo su - user_hello_django

  注意命令提示符前缀的变化。

• 进入应用目录

  cd /webapps/hello_django/

• 创建环境
  virtualenv -p /usr/bin/python3.4 .

命令解释：
- p /usr/bin/python3.4 表示创建python3.4的运行环境，也可以通过改变参数创建其他python版本的环境
- . 表示当前目录，也可以指定完整路径，如/webapps/hello_django/
* 激活环境
source bin/activate

4.安装Django和Gunicorn

• 安装

 pip install django
 pip install gunicorn
 pip install psycopg2

• 创建一个Django项目，名称为hello
  django-admin.py startproject hello
• 验证Django是否正常工作
  cd hello
python manage.py runserver 112.74.123.69:8000
  命令解释：
  112.74.123.69 为服务器的IP地址，注意替换为自己的

在浏览器中输入112.74.123.69:8000并跳转，看到如下页面表示成功：

5.创建Gunicorn的启动脚本

• 创建文件/webapps/hello_django/bin/gunicorn_start

cd /webapps/hello_django/bin/
vim gunicorn_start

• 在vim中编辑文件
  输入i进入编辑模式
  粘贴文本内容
  :w 保存修改
  :q 退出

(...)
NAME="hello_app"                                  # Django应用的名称
DJANGODIR=/webapps/hello_django/hello             # Django 项目的目录
SOCKFILE=/webapps/hello_django/run/gunicorn.sock  
USER=user_hello_django                                        # 用户名
GROUP=webapps                                     # 用户组
NUM_WORKERS=3                                     # 一般是服务器使用CPU的个数X2+1，所以一个CPU的话，worker就是3
DJANGO_SETTINGS_MODULE=hello.settings             # Django应用使用的settings文件
DJANGO_WSGI_MODULE=hello.wsgi                     # WSGI 模块名称
(...)

给文件添加可执行权限
sudo chmod u+x bin/gunicorn_start

6.创建Supervisor配置文件

在/etc/supervisor/conf.d目录下创建文件hello.conf
内容如下：

[program:hello]
command = /webapps/hello_django/bin/gunicorn_start                    #指定启动Django app的命令，也是刚才创建的gunicorn脚本
user = user_hello_django                                                          #用户名
stdout_logfile = /webapps/hello_django/logs/gunicorn_supervisor.log   #运行日志存放位置
redirect_stderr = true                                                #把stderr日志也放在刚才的文件里

注意到日志文件还没有创建，我们来创建一下：

 mkdir -p /webapps/hello_django/logs/
 touch /webapps/hello_django/logs/gunicorn_supervisor.log 

可以使用下面的命令控件Supervisor

sudo supervisorctl reread #修改配置文件后需要使用
sudo supervisorctl update #更新状态，会启动刚配置的应用
sudo supervisorctl status hello #查看应用状态
sudo supervisorctl stop hello #停止应用
sudo supervisorctl start hello #启动应用
sudo supervisorctl restart hello #重启应用

7. 创建Nginx虚拟服务器

在目录/etc/nginx/sites-available下创建hello文件

upstream hello_app_server {
  server unix:/webapps/hello_django/run/gunicorn.sock fail_timeout=0;
}

server {
    listen   80;
    server_name hello.test;

client_max_body_size 4G;

access_log /webapps/hello_django/logs/nginx-access.log;
error_log /webapps/hello_django/logs/nginx-error.log;

location /static/ {
    alias   /webapps/hello_django/static/;
}

location /media/ {
    alias   /webapps/hello_django/media/;
}

location / {
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Host $http_host;
    proxy_redirect off;
    if (!-f $request_filename) {
        proxy_pass http://hello_app_server;
        break;
    }
}

执行命令进行文件链接
sudo ln -s /etc/nginx/sites-available/hello /etc/nginx/sites-enabled/hello
sudo service nginx restart
命令解释：
ln -s 建立两个文件之间的同步链接，这时/etc/nginx/sites-available/hello和/etc/nginx/sites-enabled/hello的内容将会完全相同，以后要修改的话也只需要修改/sites-available/hello的内容，会自动同步

如果nginx restart 显示 fail, 可以使用sudo nginx -t命令查看失败原因

注意在Django的settings文件中INSTALLED_APPS加入gunicorn

修改内容后：

sudo service nginx restart
sudo supervisorctl restart hello     

参考文章：
Setting up Django with Nginx, Gunicorn, virtualenv, supervisor and PostgreSQL
本文主要是由该文章翻译整理而来，向大神致敬。