OpenStack 源码系列前言

2017-06-08

一直以来，我都相信，好记性不如烂笔头，特别是对我这种记性还不好的人…另外，把自己所学所想记录下来，本身就是一个学习和进步的过程，尤其在加强自己系统理解某一块领域方面用处特别大。

对于 OpenStack 而言，所涉及的知识千千万万，如果能啃下来，我想，进步一定不小。

鉴于以上原因，是时候开始 OpenStack 的源码（如无特别说明，我们选用 Ocata 版的 OpenStack 源码）之旅了。希望能够在今年年底之前把 OpenStack 的一些主要模块（目前最新 Ocata 版的 Keystone/Nova/Neutron/Cinder/Ceilometer/Glance/Swift/Magnum）的源码都走读、理解一遍。

当然，个人目前所学到的也只是皮毛，所以定有不周之处，望多多包涵！

就让我们开始这激动人心之旅吧！！！

more >>

展开全文 >>

Routes

2017-05-20

按照官方介绍，Routes 是 Rails routes 的 Python 版，用于将不同的 URL 映射到对应的应用上，这对于开发 Restful URL 非常便利：

Routes is a Python re-implementation of the Rails routes system for mapping URLs to application actions, and conversely to generate URLs. Routes makes it easy to create pretty and concise URLs that are RESTful with little effort.

注：关于 REST API，可参考以下优秀博文：

REST API 作者的博文论文：Architectural Styles and the Design of Network-based Software Architectures （中文版）
Best Practices for Designing a Pragmatic RESTful API （中文版）

基本使用

对于 Routes，我们平常使用得比较多的就是其 Mapper 工具了。可以看看官方提供的样例：

# Setup a mapper
from routes import Mapper
map = Mapper()
map.connect(None, "/error/{action}/{id}", controller="error")
map.connect("home", "/", controller="main", action="index")

# Match a URL, returns a dict or None if no match
result = map.match('/error/myapp/4')
# result == {'controller': 'error', 'action': 'myapp', 'id': '4'}

more >>

展开全文 >>

PasteDeploy

2017-05-20

不知不觉已经写了几篇有关 WSGI 的博文了，继续坚持。嗯，再来一篇，哈哈！

在以前博文 WSGI 和 Webob 中我们已经知道可以用原始或者装饰器的方法来实现应用的串联（中间件加应用）。这种方式应付比较简单的情况还可以，但如果出现多个中间件加应用的情况，这种方式就会有点力不从心了，代码逻辑的维护估计也是够呛。这时，PasteDeploy 的出现就可以解决我们的问题。PasteDeploy 利用配置文件就可以配置各种中间件和应用，让我们不用考虑中间件与中间件之间、中间件与应用之间的对接问题。这样一来，我们就可以专注实现各种中间件和应用的逻辑。

关于 PasteDeploy 的详细介绍，可参考以下几个资料：

本文就不打算重新说一遍了，而是重点关注一些值得注意的地方。

另外，PasteDeploy 会用到 paste 其他组件，所以如果我们要研究源码，可以同时下载这两者的代码：

这两者都是使用 Mercurial 进行源码管理，如果要 clone 的话要安装 Mercurial 工具。

more >>

展开全文 >>

Webob

2017-05-19

在上一篇文章 WSGI 中我们提到的例子都是自己处理请求和响应、提供应用程序入口给服务端调用等。这样对我们学习 WSGI 本身是很好的，但如果我们每次在写应用逻辑的时候还要处理这些东西，就显得没有必要了，而且我们的处理方式不一定正确。这时 Webob 这类包的出现就很有意义了——让我们专注应用逻辑。

Webob 也是 OpenStack 里边用的比较多的包。本文主要介绍其 Request、Response、异常（webob.exc）及 WSGIfy 装饰器（webob.dec.wsgify）。

基本对象

Request

基本概念

官方对 Request 有一个简要的定义：

The request object is a wrapper around the WSGI environ dictionary.

也即，Request 是对 WSGI 中环境变量 environ 的一个封装。我们可以通过 req.environ 查看这些环境变量：

from webob import Request
from pprint import pprint

req = Request.blank('/')
pprint(req.environ)

# Results
# {'HTTP_HOST': 'localhost:80',
#  'PATH_INFO': '/',
#  'QUERY_STRING': '',
#  'REQUEST_METHOD': 'GET',
#  'SCRIPT_NAME': '',
#  'SERVER_NAME': 'localhost',
#  'SERVER_PORT': '80',
#  'SERVER_PROTOCOL': 'HTTP/1.0',
#  'wsgi.errors': <open file '<stderr>', mode 'w' at 0x030CD0D0>,
#  'wsgi.input': <_io.BytesIO object at 0x036A3F30>,
#  'wsgi.multiprocess': False,
#  'wsgi.multithread': False,
#  'wsgi.run_once': False,
#  'wsgi.url_scheme': 'http',
#  'wsgi.version': (1, 0)}

more >>

展开全文 >>

WSGIRef

2017-05-15

在上一篇文章 WSGI 的例子中我们多次利用了 wsgiref 来提供一个简单的 HTTP 服务器，但对其如何实现对 WSGI 应用的调用却没有深入了解。本文正是基于此点出发，以加深对 WSGI 的理解。

WSGIRef 本身很简单，在对 HTTPServer 的封装的基础上，实现了服务端的 WSGI 协议。其源代码量也是好少，很容易看懂。

本文打算用前文的例子来说清楚服务端是如何调用 WSGI 应用的：

# -*- coding: utf-8 -*-

from wsgiref.simple_server import make_server


# Application: with params environ and start_response (and optional one exc_info)
def simple_app(environ, start_response):
    """Simplest possible application object"""
    status = '200 OK'
    response_headers = [('Content-type', 'text/plain')]
    start_response(status, response_headers)
    return ['Hello World']  # !!!应用程序返回值需要为“可迭代对象”，如 list、生成器


# Server
httpd = make_server(
    '127.0.0.1',
    8051,
    simple_app
)

httpd.handle_request()

more >>

展开全文 >>