ubuntn 配置webpy nginx

webpy环境搭建

在开始webpy搭建以前，有必要熟悉一下什么是fastcgi，由于搭建环境时都是使用这个模式去运行webpy程序的，具体的fastcgi描述能够参考各类百科；fastcgi协议官网（http://www.fastcgi.com/drupal/）上面描述一些基础信息，fastcgi的api、开发，fastcgi的实现程序，支持fastcgi的web服务器等等。

除了fastcgi以外还有一些其余的相关名词：cgi、fastcgi、wsgi。gi是gateway interface的缩写，因此前面3个都是属于一个大类型、一种规范；至于具体规范的谁、怎么规范的会有各自的不一样。

cgi和fastcgi规范的都是http server与对应解释程序的之间的通讯；好比apache与Python、nginx与python等。只是它们规范的方式不同；cgi是最原始的公用通讯协议，它规定的是每次有请求就会新起一个应用进程来处理，在请求结束后关闭应用进程【致使反复新起进程、关闭进程，消耗系统资源】；fastcgi是cgi的扩展，目的就是解决cgi的这种资源消耗的弊端，它规定http server启动时同时启动了若干个应用进程【应用进程数可配置】，而后常驻内存等待接收请求并处理，处理完请求后继续等待不会退出。

因为cgi是直接对接那些有标准输出的应用便可，sh、tcl等；因此使用cgi协议时能够直接调用应用程序来启动应用进程，在执行结束后得到标准输出做为返回的html内容。而fastcgi则实现了固定的通讯机制，它不能经过直接调用应用程序来执行结果，因此就须要一个支持fastcgi协议的web server/gateway来与之通讯；这样请求就会经过fastcgi进程传输给特定的web请求处理程序【flup】，这个程序会根据业务逻辑处理请求并返回结果；最终经过fastcgi返回给前端的http server。

而后再看看fastcgi和wagi的关系，其实它们没有关系，虽然都是规范，但它们规范的不是一个地方，因此没有直接可关联的，惟一可关联的就是，有些程序会同时实现了这2种协议，好比：flup

fastcgi是通讯规范，规定了通讯的方式、协议；而wsgi是接口规范，规定了函数定义、调用。

最后还有一个spawn-fcgi，这是一个fastcgi进程管理器【最初是lighttpd的子模块，lighttpd也是一个与nginx相似的http server】，做用等同于其它http server中的fastcgi模块；只不过它实现的比较好、在某些状况下的效能会比较高，因此被你们分离出来普遍使用，以至独立出来做为一个项目。【因此就有了apache+spawn-fcgi、nginx+spawn-fcgi等】

下面总结了一张图，大概覆盖了上面所说的。

一般搭建webpy都是想使用它的fastcgi模式，所以搭建webpy能够有2套方式运行：一是web服务+flup，二是web服务+spawn-fcgi+flup。又由于spawn-fcgi只有linux版本，因此windows下只能使用第一种方式搭建webpy，而linux下则可使用第二种方式。下面内容简述了这2种方式的搭建过程，web服务器使用的是nginx，官网更多webpy服务的搭建见http://webpy.org/cookbook/index.zh-cn 部署章节，里面还包括apache、lighttpd等服务器的fastcgi搭建。\

二、nginx配置熟悉
由于使用nginx服务，因此有必要先熟悉一下nginx服务器的简单配置，不然配置过程当中出现问题时就会手忙脚乱了，安装完成nginx后其默认的配置文件里会有几种默认配置和注释说明，不过是英文的，这里有一个比它更详细的中文版：http://my.oschina.net/duxuefeng/blog/34880 
注：修改前先备份一个原始的文件

flup中相关下载和配置以下：http://tool.oschina.net/uploads/apidocs/nginx-zh/PythonFlup.htm


三、环境部署
webpy官网搭建说明见：http://webpy.org/cookbook/fastcgi-nginx.zh-cn

python、webpy、flup、nginx分别默认安装便可，完成后测试各软件默认安装是否正常，若是正常则开始修改nginx配置，添加配置一个虚拟主机(在/etc/nginx/sites-available目录下新建一个文件，文件名能够自定义，如：example)，内容以下：

server{
    listen       80;
    server_name  www.test.com;
    root /path/to/web/root;
    access_log  logs/www.xx.com.access.log  main;

    location / {
        include fastcgi_params;   ##包含默认的fastcgi参数
        fastcgi_param SCRIPT_FILENAME $fastcgi_script_name;
        fastcgi_param PATH_INFO $fastcgi_script_name;
        fastcgi_pass 127.0.0.1:9002;                  ##把请求经过fastcgi传送给本机的9002端口
    }

    location /static/ {                    #配置静态文件的访问
        if (-f $request_filename) {        #若是请求文件名是一个文件
        rewrite ^/static/(.*)$  /static/$1 break;   #直接跳转到对应的资源，中断fastcgi的传输
        }
    }
}

 

完了重载nginx配置，nginx -s reload，为了保险起见，也能够以下操做：

一、先测试一下nginx.conf文件：./nginx -t   
二、没有问题在中止服务 ./nginx -s stop
三、启动服务 ./nginx

此时能够直接访问www.test.com,若是出现以下页面则表示配置nginx的fastcgi格式正确，能够继续后面的配置

新建一个py文件，好比code.py，用来接收web请求并处理之，其内容能够以下：

#!/usr/bin/env python
# -*- coding: utf-8 -*-


import web


urls = ("/.*", "hello")
app = web.application(urls, globals())


class hello:
    def GET(self):
        return 'Hello, world!'


if __name__ == "__main__":
    app.run()

运行python程序，python code.py 9002 fastcgi
注：上面的nginx配置文件里配置的是9002，这里开启的就是9002，要保持一致不然就接不上了。
经过浏览器访问localhost，看看是否是返回了Hello, world!

这里会有一些问题，还要有以下配置：

　　(1)将nginx/sites-available中自定义的文件在sites-enabled中创建一个文件映射

　　sudo ln -s /etc/nginx/sites-available/example /etc/nginx/sites-enabled/example

　　(2)删除sites-enabled中的default

　　rm /etc/nginx/sites-enabled/default

　　(3)重启nginx服务和相关应用

　　service nginx restart

上面是以方式一搭建的，若是使用方式二搭建，则还须要安装spawn-fcgi，而后修改code.py文件的内容，添加一句代码，所有内容以下：

#!/usr/bin/env python
# -*- coding: utf-8 -*-


import web


urls = ("/.*", "hello")
app = web.application(urls, globals())


class hello:
    def GET(self):
        return 'Hello, world!'


if __name__ == "__main__":
    web.wsgi.runwsgi = lambda func, addr=None: web.wsgi.runfcgi(func, addr)   ##这行是新增的
    app.run()

而后启动spawn-fcgi程序便可，即不须要直接以fastcgi方式运行code.py文件，而是经过运行spawn-fcgi程序来间接启动code.py程序，启动的命令以下：
spawn-fcgi -d /path/to/www -f /path/to/www/code.py -a 127.0.0.1 -p 9002   #端口和nginx配置里要一致
-f 指定调用FastCGI的web文件，web程序的入口文件，即code.py文件
-d 指定web程序的主目录，即code.py所在的目录
-a 绑定到地址 addr
-p 绑定到端口 port
-F 指定产生的 FastCGI 的进程数
-P 指定产生的进程的 PID 文件路径
-u 和 -g FastCGI 使用什么身份运行
能够将进程PID保存下来方便关闭进程：
kill `cat /tmp/zcut.pid`

好比：spawn-fcgi -u www -g www -p /tmp/spwn.pid -F 10 -d /path/to/www -f /path/to/www/code.py -a 127.0.0.1 -p 9002在127.0.0.1的9002端口以www身份启动webpy服务，webpy主程序路径为/path/to/www/code.py，webpy的程序主目录为/path/to/www/，总共启动了10个spawn进程，全部的进程id将存放在/tmp/spwn.pid文件里