前言
最近在用django部署网站www.aihunter.cc,经历各种坑后觉得有必要总结一下流程以备日后遗忘。在下阅读众多教程后觉得网上还是缺少介绍Ngnix+Uwsgi+virtualenv+django工作流程的概念文章,结合网上的材料和自己消化本教程将分为概念部分(上篇)以及操作部分(下篇),文中操作内容均为自己实际部署时的流程。另外在下职业非专业程序员若有错误可以在评论中指出,我会必第一时间纠正,以下将实际部署分为4个部分进行说明。
环境说明
服务器:阿里云ecs
系统:ubantu16.04 32位
语言版本:Python 2.7.12
部署方式:Ngnix +Uwsgi + virtualenv
django路径说明:流程中django项目路径为/home/virtuweb/testproject
其中virtuweb是虚拟环境文件夹,testproject是django的项目名字,django下的app名为testmodel
Step1 安装ngnix\uwsgi\virtualenv
nginx安装(真实环境)
注意:nginx的 gzip模块需要 zlib 库、rewrite模块需要 pcre 库、ssl 功能需要openssl库
apt-get install nginx
uwsgi安装(真实环境+虚拟环境)
pip install uwsgi
Virtualenv安装(真实环境)
apt-get install python-virtualenv 或pip install virtualenv
Step2 配置uwsgi 和启动
uWSGI可以通过diango项目的wsgi.py文件启动,也可以用初始化文件启动。在下是用ini初始化文件启动uWSGI的,因此需要配置django项目中的wsgi.py文件和创建一个ini文件。再次说明在下django项目路径为/home/virtuweb/testproject,具体流程如下
step2.1 编辑django项目中的wsgi.py文件
首先进入django项目中的wsgi.py路径下
CD /home/virtuweb/testproject/testproject
然后编辑wsgi.py文件
vim wsgi.py
编辑wsgi.py内容如下
import os,sys,django
from django.core.wsgi import get_wsgi_application
from django.core.handlers.wsgi import WSGIHandler
reload(sys)
sys.setdefaultencoding('utf-8')
os.environ.setdefault("DJANGO_SETTINGS_MODULE", "testproject.settings") #变量testproject.settings为django项目下的settings
django.setup() #避免在虚拟环境下找不到django的app
application = WSGIHandler() #实例化一个WSGI application用作接受nginx服务器传递的envrion、start_response参数
step2.2 创建一个uwsgi.ini文件
返回到django项目下
CD /home/virtuweb/testproject
创建和编辑testproject.ini (文件名称可任意)
vim testproject_uwsgi.ini
testproject_uwsgi.ini文件配置如下
[uwsgi]
socket =127.0.0.1:8080 # uWSGI服务器启动占用的地址和端口
static-map =/static=/home/virtuweb/testproject/testmodel/static #设置django静态文件夹的路径
chdir =/home/virtuweb/testproject #设置django的路径
module =testproject.wsgi:application
virtualenv = /home/aihunter #设置虚拟环境路径,不设置的话在会找不到django
master = true #设置是否允许主进程存在
process = 5 #设置进程数量
harakiri =30 #客户端请求超过设置
vacuum = true #设置服务器退出时自动清理环境
step2.3 以上内容完成后在虚拟环境下运行
uwsgi --ini testproject_uwsgi.ini (省略--ini也行)
详细的wsgi官方介绍http://uwsgi-docs.readthedocs.org/en/latest/WSGIquickstart.html
Step3 配置nginx 步骤
安装好Nginx后其实已经可以启动服务器了,但是我们目的要让Nginx和uWSGI连接起来,因此需创建一个新的配置文件xx.conf。xx.conf存放的位置在Nginx文件夹下的sites-available和sites-enabled文件夹中(一式两份),另外要保证Nginx中存在uwsgi_params文件(一般都有的),设置完毕后执行service nginx start命令启动nginx即可(关闭命令为service nginx stop)。具体流程如下
step3.1 创建Nginx配置文件
进入到nginx文件夹下
cd /etc/nginx/sites-available
删除默认设置文件default
rm deault
创建配置文件test.conf (文件名称随意)
Vim test.conf
编辑test.conf .py内容如下(注意文件夹权限,注意不要缺少句后分号,创建完成后复制一份到 sites-enabled中,也要删除 sites-enabled的default文件)
server {
listen 80; #设置nginx服务器开启的端口号
server_name www.aihunter.cc;
charset utf-8;
client_max_body_size 75M;
location /static {
alias home/virtuweb/testproject/testmodel/static; #设置django静态文件路径
}
location / {
uwsgi_pass 127.0.0.1:8080; #设置为uwsgi服务器开启的端口
include /etc/nginx/uwsgi_params; #设置uwsgi_params文件路径
}
}
step3.2 启动服务器
执行以下命令,Nginx启动成功后没有返回值,错误才返回值。可以使用netstat -nltp命令查看
service nginx start
step4 阿里云服务器端口开启
设置阿里云服务器安全组规则以及django中settings文件的host参数后外网才可以访问。
1.首先在阿里云服务器上开启安全组规则(开启80端口)
2.django的settings文件中设置allowed_hosts设置为服务器的域名(若没有域名则填服务器ip地址)
部署程中出现的错误以及解决
不知道是环境或者是版本不同的问题,在下参考网上其他教程后在实践时还是遇到些关于wsgi设置的坑以下内容为当时遇到的问题和解决方法。
第一坑 app不能加载
错误提示:django.core.exceptions.AppRegistryNotReady:loadr yet.
处理方式:不能加载那就补充加载咯,于是在wspy文件中加入代码 django.setup()后解决成功。
第二坑 找不到django 库
错误提示:ImportError:No module named django
错误显示
处理方式:原来是由于没有设置虚拟环境的路径导致的,需要在虚拟环境下运行django项目的朋友一定要在uwsgi.ini文件中补上虚拟环境的路径virtualenv=path
参考文章和视频
浅谈cgi、wsgi、uwsgi 与 uWSGI Python uwsgiu WSGI nginx CGI
Nginx工作原理和优化、漏洞。
【教程】Nginx + uWsgi 部署 Django + Mezzanine 生产服务器...