【转】uWSGI+django+nginx的工作原理流程与部署历程

一、前言
献给和我一样懵懂中不断汲取知识,进步的人们。

霓虹闪烁,但人们真正需要的,只是一个可以照亮前路的烛光

二、必要的前提

2.1 准备知识

1.django

一个基于python的开源web框架,请确保自己熟悉它的框架目录结构。

2.uWSGI

一个基于自有的uwsgi协议、wsgi协议和http服务协议的web网关

3.nginx

常用高性能代理服务器

4.wsgi.py

django项目携带的一个wsgi接口文件
如果项目名叫destiny的话,此文件就位于[destiny/destiny/wsgi.py]

2.2 相关资料

wsgi:一种实现python解析的通用接口标准/协议,是一种通用的接口标准或者接口协议,实现了python web程序与服务器之间交互的通用性。
利用它,web.py或bottle或者django等等的python web开发框架,就可以轻松地部署在不同的web server上了;
uwsgi:同WSGI一样是一种通信协议
uwsgi协议是一个uWSGI服务器自有的协议,它用于定义传输信息的类型,它与WSGI相比是两样东西。
uWSGI :一种python web server或称为Server/Gateway
uWSGI类似tornadoweb或者flup,是一种python web server,uWSGI是实现了uwsgi和WSGI两种协议的Web服务器,负责响应python 的web请求。

因为apache、nginx等,它们自己都没有解析动态语言如php的功能,而是分派给其他模块来做,比如apache就可以说内置了php模块,让人感觉好像apache就支持php一样。

uWSGI实现了wsgi协议、uwsgi协议、http等协议。 Nginx中HttpUwsgiModule的作用是与uWSGI服务器进行交换。

2.3 项目流程

其实网上很多教程,都是关于uwsgi+nginx部署django的,StackOverflow也有一些解决常见错误的方法,但是部署还是容易出问题,新手难解决。
归根到底是自己不了解整个项目的流程。教程都只教方法,但为什么这样部署,这样部署有什么好处,每个组件都起什么作用却只字不提。致使只要部署稍微有那么一点不同,就无可是从了。
所以说,项目流程和每个组件的用途才是此次部署最重要的部分。

1 首先客户端请求服务资源,
2 nginx作为直接对外的服务接口,接收到客户端发送过来的http请求,会解包、分析,
3 如果是静态文件请求就根据nginx配置的静态文件目录,返回请求的资源,
4 如果是动态的请求,nginx就通过配置文件,将请求传递给uWSGI;uWSGI 将接收到的包进行处理,并转发给wsgi,
5 wsgi根据请求调用django工程的某个文件或函数,处理完后django将返回值交给wsgi,
6 wsgi将返回值进行打包,转发给uWSGI,
7 uWSGI接收后转发给nginx,nginx最终将返回值返回给客户端(如浏览器)。
8 *注:不同的组件之间传递信息涉及到数据格式和协议的转换

作用:

1. 第一级的nginx并不是必须的,uwsgi完全可以完成整个的和浏览器交互的流程;
2. 在nginx上加上安全性或其他的限制,可以达到保护程序的作用;
3. uWSGI本身是内网接口,开启多个work和processes可能也不够用,而nginx可以代理多台uWSGI完成uWSGI的负载均衡;
4. django在debug=False下对静态文件的处理能力不是很好,而用nginx来处理更加高效。

三、安装与配置

首先,确保你已经安装好了nginx并可以正常使用。
其次,确保自己安装完成了python,并已经完成了pip的安装。如果没有,请先安装。
接着,别忘了确认自己项目所需的django已经完成安装并正常工作。
没有的话参考以下命令安装django , 建立一个工程或利用已经写好的工程,打开浏览器,输入部署地址(如:http://127.0.0.1:8000/)(或http://内网ip:8000、或http://外网ip:8000)测试,确认是否可正常打开浏览。

安装:sudo pip install django==1.10
测试:python manage.py runserver 0.0.0.0:8000

上面的工作都完成了,接着安装uWSGI

sudo pip install uwsgi

测试uWSGI: 新建文件test.py,写入以下内容

def application(env, start_response):
start_response(‘200 OK‘, [(‘Content-Type‘,‘text/html‘)])
return "Hello World"

运行

sudo uwsgi --http 0.0.0.0:8000 --wsgi-file test.py

如果端口占用,使用

lsof -i :8000

列出占用端口的程序的pid号,并使用以下命令杀掉所有占用端口的程序

sudo kill -9 pid

然后浏览 http://127.0.0.1:8000(或http://内网ip:8000、或http://外网ip:8000)查看效果,有”Hello World”输出即安装成功。

下一步,建立工程单独的nginx配置文件
首先确认自己准确的知道nginx的默认配置文件目录(nginx.conf)的路径,如果不清楚,请使用如下命令获取:

nginx -t

大概会列出以下类似信息:

nginx: the configuration file /etc/nginx/conf/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/conf/nginx.conf test is successful

里面说明了nginx默认配置文件的路径是:/etc/nginx/conf/nginx.conf;

然后,确保nginx.conf的同目录下有uwsgi_params文件(/etc/nginx/conf/uwsgi_params),没有的话根据链接获取, 后面要用到。

在自己的工程目录下,建立如destiny.conf(/wwwroot/destiny/destiny.conf)的配置文件;复制nginx.conf里面全部的内容,全部写入destiny.conf中。
然后按照下面写的,把destiny.conf配置文件中的server段部分全部替换掉。

server {
listen 80;
server_name localhost;
charset utf-8;
access_log /wwwroot/destiny/nginx_access.log;
error_log /wwwroot/destiny/nginx_error.log;
client_max_body_size 75M;

location /static {
alias /wwwroot/destiny/destiny/static;
}

location / {
include /etc/nginx/conf/uwsgi_params;
uwsgi_pass 127.0.0.1:9090;
}
}

其中的 listen 80代表服务器开放80端口;

location [目录名]代表项目路径的引导;
access_log 和error_log是定义nginx访问日志和错误日志的存放路径。
“location /static”中的”/static”是自己定义的项目引用静态文件时,浏览器中显示的静态资源所在的根目录名;这样的话,用户在浏览器中查看到的所有image、css或js资源都是处在http://127.0.0.1/static下的。
django静态文件的绝对路径是根据自己的实际情况来确定的,一般在自己的django的app名/static目录下,或自己python manage.py collectstatic后的路径下。像我的是在/wwwroot/destiny/destiny/static根目录下。
“location /”是指访问项目根目录时,nginx要做的事。其中需要指定 uwsgi_params文件的绝对路径,上面已经提到了;如果还有media文件之类的静态目录,仿照static的写法,自己补充。
127.0.0.1:9090是指uWSGI绑定的监听地址,这里使用了9090端口。

需要注意的是,请确认自己django的静态文件目录所有者是www用户,如果不是,请用以下命令更改静态目录权限归属者:

sudo chown -R www:www /wwwroot/destiny/destiny/static

下面接着建立uWSGI的配置文件,在自己工程目录下创建uwsgi.ini文件,写入以下内容

[uwsgi]
socket = 127.0.0.1:9090
chdir=/wwwroot/destiny
module=destiny.wsgi
master = true
processes=2
threads=2
max-requests=2000
chmod-socket=664
vacuum=true
daemonize = /wwwroot/destiny/uwsgi.log

其中的socket字段值”127.0.0.1:9090”必须要和上面写的density.conf配置文件中的uWSGI监听地址完全一样;

chdir指自己工程的绝对路径;
module指的是wsgi.py在自己工程中的相对路径,”.”指代一层目录;我的django工程的wsgi.py文件是在”/wwwroot/destiny/destiny/wsgi.py”,所以写成destiny.wsgi;
daemonize指定uWSGI日志的存储路径。

好了,现在理一下路径:

1 工程路径: /wwwroot/destiny
2 工程静态文件路径: /wwwroot/destiny/destiny/static
3 wsgi.py的路径: /wwwroot/destiny/destiny/wsgi.py
4 uwsgi.ini的路径: /wwwroot/destiny/uwsgi.ini
5 uwsgi日志路径: /wwwroot/destiny/uwsgi.log
6 destiny.conf的路径: /wwwroot/destiny/destiny.conf
7 uwsgi_params的路径: /etc/nginx/conf/uwsgi_params
8 nginx访问日志路径: /wwwroot/destiny/nginx_access.log
9 nginx错误日志路径: /wwwroot/destiny/nginx_error.log

可以发现,我几乎把所有有关工程的配置文件和日志文件都放在工程目录下了,方便后期维护与查错。

启动uWSGI

sudo uwsgi --ini /wwwroot/destiny/destiny.ini

启动nginx

在这之前,我们要先去nginx配置文件的根目录拷贝mime.types(/etc/nginx/conf/mime.types)到工程目录(/wwwroot/destiny/mime.types),和destiny.conf放在一起。
否则用配置文件启动nginx会报错:

nginx: [emerg] open() "/**/**/**/mime.types" failed (2: No such file or directory)


当然,如果不想拷贝mime.types文件,也可以将配置文件中“include mime.types;”一项,改成绝对路径“include /etc/nginx/conf/mime.types;”
如果nginx已经开启,先关闭nginx(service nginx stop或nginx -s stop),再执行以下命令:

nginx -c /wwwroot/destiny/destiny.conf

这里的-c 表示加载配置文件启动

四、后记
到这里,工作基本就做完了,可以打开浏览器,输入自己项目的IP地址,如http://127.0.0.1/查看效果了。

如果启动时就报错,查看终端信息,解决错误。
如果终端没有报错,但是浏览时出现500、502等错误,就去项目目录查看nginx日志和uWSGI日志,解决错误。

自己在部署时,遇到很多坑,网上的教程大多附带virtualenv和supervisor的部署,但是连最基本的部署都说不明白,部署出来的东西性能再好也没指导意义。基于自己踩坑脱坑的过程,写下此文。

正如以上所说,我只是用单独的一个conf文件,在nginx上部署了一个工程,没有说明部署多个工程的问题;也没有使用virtualenv开发环境、使用supervisor来管理进程等。请根据个人爱好和需要去实践扩展。

原文地址:https://www.cnblogs.com/HYanqing/p/12009968.html

时间: 2024-10-12 00:25:23

【转】uWSGI+django+nginx的工作原理流程与部署历程的相关文章

uWSGI+django+nginx的工作原理流程与部署历程

一.前言献给和我一样懵懂中不断汲取知识,进步的人们. 霓虹闪烁,但人们真正需要的,只是一个可以照亮前路的烛光 二.必要的前提2.1 准备知识 django一个基于python的开源web框架,请确保自己熟悉它的框架目录结构.1uWSGI一个基于自有的uwsgi协议.wsgi协议和http服务协议的web网关1nginx常用高性能代理服务器1wsgi.pydjango项目携带的一个wsgi接口文件如果项目名叫destiny的话,此文件就位于[destiny/destiny/wsgi.py]122.

[转自SA]浅谈nginx的工作原理和使用

nginx apache 简单对比 nginx 相对 apache 的优点: 轻量级,同样起web 服务,比apache 占用更少的内存及资源 抗并发,nginx 处理请求是异步非阻塞的,而 apache 则是阻塞型的,在高并发下 nginx 能保持低资源低消耗高性能 高度模块化的设计,编写模块相对简单 社区活跃 配置简洁 apache 相对nginx 的优点: rewrite ,比 nginx 的 rewrite 强大 模块超多 少 bug ,nginx 的 bug 相对较多 超稳定 配置复杂

Nginx的工作原理和配置详解

一.Nginx简介 Nginx (pronounced engine-x) is a free, open-source, high-performance HTTP server and reverse proxy, as well as an IMAP/POP3 proxy server. Igor Sysoev started development of Nginx in 2002, with the first public release in 2004. Nginx now hos

uwsgi+django+nginx

首先安装nginx和uwsgi,nginx用源码安装,uwsgi用pip install uwsgi安装,环境为centos6.8,python为2.7.开始前,确保项目在python manage.py runserver下能正常运行. uwsgi支持ini.xml等多种配置方式,本文简单介绍两种方式:ini和xml. ini方式 [[email protected] ~]# cat /etc/uwsgi9000.ini  [uwsgi] socket = 127.0.0.1:9000 mas

uWSGI+Django+nginx(下)

在上篇文章 说的uWSGI和Django都已没问题的情况下 找到 nginx的配置文件 我的是:/etc/nginx/nginx.conf 修改这个文件 在http{}里加入 下面的 server { listen 80;  server_name 123.206.62.46;          //这个可以是域名也可以是外网访问IP location / { include /etc/nginx/uwsgi_params;      /我的uwsgi_params文件是在该目录下.这个文件是n

django接口的工作原理

1.创建应用程序有两种方法,第一种就是在新建项目的时候,在最初使的时填入应用程序名称,第二种就是进入目录下面,输入 python manage.py startapp appName 就会自动生成一个文件夹,里面有一些文件 首先,需要了解一下他的逻辑: 1.在settings里面,项目名称都是自动生成的('appName.apps.AppnameConfig',已经被注释),我们可以自己添加项目名称(“appName”),那么第一步就是要把我们的项目添加进去 2.url映射方法 urls里面的内

MapReduce工作原理流程简介

在MapReduce整个过程可以概括为以下过程: 输入 --> map --> shuffle --> reduce -->输出 输入文件会被切分成多个块,每一块都有一个map task map阶段的输出结果会先写到内存缓冲区,然后由缓冲区写到磁盘上.默认的缓冲区大小是100M,溢出的百分比是0.8,也就是说当缓冲区中达到80M的时候就会往磁盘上写.如果map计算完成后的中间结果没有达到80M,最终也是要写到磁盘上的,因为它最终还是要形成文件.那么,在往磁盘上写的时候会进行分区和排

ESXI 5.5工作原理以及安装部署ESXI

一.虚拟化概述 1.什么是虚拟化? 虚拟化就是把硬件资源从物理方式转变为逻辑方式,打破原有物理架构,使用户可以灵活管理这些资源,并且允许1台物理机上同时运行多个操作系统,以实现资源利用率最大化和灵活管理的一项技术. 2.虚拟化的优势 减少服务器数量,降低硬件采购成本:资源利用率最大化:降低机房空间.散热.用电消耗的成本:硬件资源可动态调整,提高企业IT业务灵活性:高可用性:在不中断服务的情况下进行物理硬件调整:降低管理成本:具备更高效的灾备能力: 二.什么是vSphere? vSphrer是VM

PHP Opcache工作原理

虽然是在疫情期间,但是我们还是要不断投资自己的大脑,这样才能在今后的职场道路中让自己更值钱. PHP工作原理 首先,我们先了解下解释型语言PHP的工作原理,这有利于我们了解PHP Opcache. 对于PHP,我们常用的是cli模式和php-fpm模式.下面我们拿cli模式来描述下php执行脚本的运行过程: php初始化执行,启动zend引擎,加载已注册的扩展模块 读取脚本文件,zend引擎对脚本进行词法分析.语法分析.生成语法生成树 zend引擎编译语法树,生成opcode中间代码 zend引