nginx + uwsgi + centos部署 django攻略

96
文艺范的奔三运维青年
2015.12.28 15:34 字数 2167

前段时间用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转发到相应的应用服务器软件来处理。
用图来表示就是如下:

  1. web应用服务器软件

  2. 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

运维学习