前段时间用django写了一个小东西,得益于django完善的架构体系和令人惊艳的admin管理界面,我本人用很少的代码就完成了功能。 然后命令行键入
python manage.py runserver 8080
就爽快的运行起来了。
对于要拿来给人的东西,怎么着也要部署到nginx上才行吧,这不仅仅是因为惯例,更重要的是因为django本身自带的用于开发的web服务器并不稳定(说白了就是仅仅只是开发测试用的)。
作为一名运维工程师,当然要熟练掌握各种部署作业,由于我只是个新手,那就拿它来练练手吧。于是在网上搜了很多部署的文章,按照相应的步骤走下来,会发现有很多坑,填完一个又来一个,导致搞了N多天才部署成功。究其原因:
- 一是大多数文章只是讲解部署步骤,并没有对其中的原理有所涉及,对于我这种新手来说感觉是云里雾里;
- 二是不同的linux系统版本存在差异,系统依赖和软件安装存在不确定性,自我摸索是不二法则。
前面废话太多,下面是重点。对web开发和部署有些许经验的同学应该知道,对于生产环境的web应用部署,应该是对 web应用 + web应用服务器软件 + web服务器软件 的组合操作。web应用顾名思义就是你的web project,这可以是java web项目,django项目或者php项目;web应用服务器软件就是运行web应用的地方,例如java用的tomcat服务器,django用的uwsgi服务器,正常情况下你只需要将web项目部署在应用服务器软件上就可以对外提供服务了。只不过这种情况下外部所有的请求不管是(动态请求还是静态请求)都是由web应用服务器软件来处理,在用户较少的情况下这样其实是够用的,但是当用户数增大,就必须要考虑到服务器系统的负载,如果不能做到服务器负载的均衡分配,必然会导致在访问高峰情况下出现不可预知的严重后果。这时就是我们的web服务器软件派上用场的时候了,web服务器软件常见的当然就是著名的apache和nginx了,使用它们再配合应用服务器软件我们就能轻松的实现web网站的动静分离,静态文件请求就交给apahce和nginx,动态请求就会由apache和nginx转发到相应的应用服务器软件来处理。
用图来表示就是如下:
web应用服务器软件
web应用服务器软件 + web服务器软件
本文主要介绍的是nginx + uwsgi 来为django应用提供服务,之所以没有选择apache是因为公司的生产环境大部分是nginx做服务器软件的。
首先有必要介绍一下本文的系统环境:
本文的采用的是 centos 6.7 + python 2.7.9 + django1.9, 仅供参考,毕竟部署配置虽然环境很重要,但是万变不离其宗,懂得原理+搜索,一切都会变得简单。
一、运行起你的django应用
1. 安装linux系统所需的一些软件依赖
这些依赖如果不安装,很可能在后面编译安装python、pip、django和uwsgi等软件时出现一些错误。虽然目前还不了解这些依赖间的关系,也许有些是多余的,但是就目前而言部署成功才是王道!
sudo yum groupinstall "Development tools"
sudo yum install openssl openssl-devel sqlite-devel zlib-develbzip2-devel ncurses-devel readline-devel tk-devel
sudo yum install pcre pcre-devel pcre-static
2.编译安装python2.7
centos6.7 自带的是python2.6,而2.6运行django1.9的项目会报错,所以重新编译安装了python2.7.9:
sudo ./configure
sudo make && sudo make install
3.安装django
sudo pip install django
默认下载的就是django1.9的版本。 至于pip的安装这里不多做介绍,只要已经安装了上述的环境,编译安装pip7.2还是很easy的。
如果默认的pip安装速度缓慢可以使用douban镜像作为下载源:
sudo pip install django -i http://pypi.douban.com/simple --trusted-host pypi.douban.com
4.运行django
切换到django项目所在的目录,运行
python manage.py runserver 8080,
然后在浏览器中输入127.0.0.1:8080 ,如果访问成功说明django运行环境正常。
二、使用uwsgi提供服务
1.安装uwsgi
sudo pip install uwsgi
2.启动uwsgi
切换到django项目的主目录下,对于djano1.9 ,如果你是使用
django-admin startproject your_proj_name
那么在主目录下会有your_proj_name/wsgi.py文件。
这时你只需在主目录下输入
uwsgi --http :8080 --module your_proj_name.wsgi
就可以运行你的web项目了,这时如果在浏览其中输入127.0.0.1:8080 能够成功访问,说明你的应用服务器部署成功,已经可以对外提供服务。
这种提供服务的方式可以表示为:
the web client <-> uWSGI <-> Django
多数情况下我们不会让浏览器直接与uwsgi交互,而是加入nginx作为中间设备转发或处理请求。
三、部署到nginx
1.安装nginx
sudo rpm -ivh http://nginx.org/packages/centos/6/noarch/RPMS/nginx-release-centos-6-0.el6.ngx.noarch.rpm #安装nginx yum源
sudo yum info
sudo yum install nginx
2.设置nginx启动的配置文件
因为/etc/nginx/nginx.conf 文件会include /etc/nginx/conf.d/目录下的所有配置文件,为了方便管理配置文件,我们在/etc/nginx/conf.d/ 下创建自己的web项目的配置文件,例如新建一个my_site.conf文件。 在配置文件里我们输入如下信息(其中easy_sysman是我的工程名):
server {
listen 8080; #启动的nginx进程监听请求的端口
server_name localhost; #域名
error_log /var/log/easy_sysman/error.log; #nginx错误日志,可自行设置,但必须保证提前建立好该目录和文件
location / {
include /etc/nginx/uwsgi_params;
uwsgi_pass 127.0.0.1:9090; #对于动态请求,转发到本机的9090端口,也就是uwsgi监听的端口
}
#error_page 404 /404.html;
error_page 500 502 503 504 /50x.html;
location = /50x.html {
root /usr/share/nginx/html;
}
location /static/ {
alias /var/www/easy_sysman/static/; #设定静态文件所在目录
}
location /media/ {
alias /var/www/easy_sysman/media/; #同样自行设置,要保证目录已经建好
}
}
配置文件写好后,我们要检查配置文件的正确性:
nginx -t -c /etc/nginx/nginx.conf
3.同步静态文件到nginx设置的目录下
首先修改django项目setting.py,增加
STATIC_ROOT = '/var/www/easy_sysman/static/'
在命令行输入
python manage.py collectstatic
自动将所有静态文件复制到nginx的索引目录。
4.启动uwsgi:
切换到django项目目录
uwsgi --socket 9090 --module easy_sysman.wsgi
这里可以使用更复杂的配置文件来启动,可以参考uwsgi-to-run-with-a-ini-file
5.启动nginx
sudo service nginx start
就可以访问 服务器ip:8080/ 就能出现页面,如果不行就检查 /var/log/easy_sysman/error.log里的错误内容,一点点修正。
这种服务提供方式可以表述为:
the web client <-> the web server <-> the socket <-> uWSGI <-> Django
四.踩过的坑
1.启动nginx后出错
查看错误日志时有可能出现
connect() to 127.0.0.1:9090 failed (13: Permission denied) while connecting to upstream 的错误
原因是 selinux 导致的。
敲入 /usr/sbin/sestatus 查看selinux状态,enable说明开启
解决方法就是 setenforce 0
然后getenforce 查看状态为permissive , 应该就可以正常访问了。
2.防火墙
centos最小化安装会默认启动 firewalld服务,导致无法从别的机器访问web应用。第一反应是关闭iptables试一试,可是本身还没有安装iptables服务,后来才知道还有个firewalld。
systemctl stop firewalld ;systemctl mask firewalld
输入上述命令解决
3.运行django出错
Traceback (most recent call last):File "<stdin>", line 1, in <module>
File "/usr/lib/python2.6/site-packages/django/__init__.py", line 1, in <module>
from django.utils.version import get_versionFile "/usr/lib/python2.6/site-packages/django/utils/version.py", line 7, in <module>
from django.utils.lru_cache import lru_cacheFile "/usr/lib/python2.6/site-packages/django/utils/lru_cache.py", line 28
fasttypes = {int, str, frozenset, type(None)},
^SyntaxError: invalid syntax
解决办法是安装python2.7