感谢朋友支持本博客，欢迎共同探讨交流，由于能力和时间有限，错误之处在所难免，欢迎指正！
如有转载，请保留源作者博客信息。
如需交流，欢迎大家博客留言。
这就要了解Python 中的Routes模块。
Routes 是一个python重新实现的Rails routes system，用来将urls映射到应用具体的action上，相反的，还生成url。由于Routes是Rails routes system的python实现，并且网上关于Routes的文档很少，故从rails的routes system入手，就能很好的理解Routes库了。
首先看一个简单的例子，就明白routes的作用，
例如浏览器接收到下面的HTTP请求， GET /instances/1 Rails的路由请求则负责将此请求解析后dispatch来代码中的具体某个函数，完成调用，例如返回虚拟机的信息。
第一部分：讲解wsgi的调用入口（paste）
python中的WSGI（Web Server Gateway Interface）是Python应用程序或框架与Web服务器之间的一种接口，定义了一套借口来实现服务器与应用端的通信规范。按照一套规范，应用端 想要通信，很简单，只需要实现一个接受两个参数的，含有__call__方法并返回一个可遍历的含有零个或者多个string结果的python对象。
服务端，对于每个http请求，调用一次应用端“注册”的那个协议规定应用必须实现的对象，然后返回相应的响应消息。 WSGI Server唯一的任务就是接收来自client的请求，然后将请求传给application，最后将application的response传递给client。中间存在的一些东西，就需要中间件来处理。
Paste Deployment是用于发现和配置WSGI appliaction和server的系统。对于WSGI application，用户提供一个单独的函数（loadapp），用于从配置文件或者python egg中加载WSGI application。因为WSGI application提供了唯一的单独的简单的访问入口，所以application不需要暴露application的内部的实现细节。
Paste.Deploy主要是用来载入WSGI中的Web App使用，其核心函数是loadapp()。
以下将以openstack的nova为例讲解paste如何载入启动nova服务（即发布routes API给上层提供调用）
1、nova --debug list开始：
命令的主要目的就是发送了两个url请求：（第一个发送给keystone授权，授权通过发送给nova获取虚拟机列表）
url中包括了token以及参数值
下图说明请求url成功，返回200.
2、接下来详解，发送以下url，如何映射到后台的v2版本的nova API以及又是如何进行权限认证配置。
http://192.168.1.120
:8774/v2/c865d5a3760348a4b8a92cf657a9176d/servers/detail
3、每一个url映射都是有paste模块进行解析，paste模块具体解析模块入口就是*.ini配置文件。
以下展示了整个openstack中所有的url映射控制的paste入口配置文件。
find /etc/ | xargs grep paste --color=auto 查找到所有的paste的ini配置文件。
4、以nova的api-paste.ini配置文件讲解。
首先介绍paste配置文件中的几个概念：
一个配置文件后缀为ini，内容被分为很多段（section），paste.depoly只关心带有前缀的段，比如[app:main]或者[filter:errors]，总的来说，一个section的标识就是[type:name],不是这种类型的section将会被忽略。
一个section的内容是以键=值来标示的。#是一个注释。在段的定义中，有以下几类：
[app:main]:定义WSGI应用，main表示只有一个应用，有多个应用的话main改为应用名字
[server:main]:定义WSGI的一个server。
[composite:xxx]：表示需要将一个请求调度定向（dispatched）到多个,或者多种应用上。以下是一个简单的例子，例子中，使用了composite，通过urlmap来实现载入多应用。
[fliter:]：定义“过滤器”，将应用进行进一步的封装。
[DEFAULT]：定义一些默认变量的值。
以下将以openstack的nova为例讲解paste如何载入启动nova服务（即发布routes API给上层提供调用）
1、nova --debug list开始：
命令的主要目的就是发送了两个url请求：（第一个发送给keystone授权，授权通过发送给nova获取虚拟机列表）
url中包括了token以及参数值
下图说明请求url成功，返回200.
2、接下来详解，发送以下url，如何映射到后台的v2版本的nova API以及又是如何进行权限认证配置。
|
http://192.168.1.120
:8774/v2/c865d5a3760348a4b8a92cf657a9176d/servers/detail
|
3、每一个url映射都是有paste模块进行解析，paste模块具体解析模块入口就是*.ini配置文件。
|
find /etc/ | xargs grep paste --color=auto 查找到所有的paste的ini配置文件。
|
4、以nova的api-paste.ini配置文件讲解。
首先介绍paste配置文件中的几个概念：
一个配置文件后缀为ini，内容被分为很多段（section），paste.depoly只关心带有前缀的段，比如[app:main]或者[filter:errors]，总的来说，一个section的标识就是[type:name],不是这种类型的section将会被忽略。
一个section的内容是以键=值来标示的。#是一个注释。在段的定义中，有以下几类：
[app:main]:定义WSGI应用，main表示只有一个应用，有多个应用的话main改为应用名字
[server:main]:定义WSGI的一个server。
[composite:xxx]：表示需要将一个请求调度定向（dispatched）到多个,或者多种应用上。以下是一个简单的例子，例子中，使用了composite，通过urlmap来实现载入多应用。
[fliter:]：定义“过滤器”，将应用进行进一步的封装。
[DEFAULT]：定义一些默认变量的值。
vim /etc/nova/api-paste.ini
其中openstack_compute_api_v2的use = call:nova.api.auth:pipeline_factory表示通过访问的url，来选择具体使用哪个应用。
根据http://192.168.1.120:8774/v2/c865d5a3760348a4b8a92cf657a9176d/servers/detail，由匹配规则，接下来调用
/v2: openstack_compute_api_v2应用。
这个Application对应了三个参数：noauth，keystone和keystone_nolimit。我们可以看到这里Application具体实现的方法是pipeline_factory。我们可以看到在参数noauth，keystone和keystone_nolimit中，分别集成了多个应用，实际上每个参数最终实现的Application分别是最后一个，即osapi_compute_app_v2，osapi_compute_app_v2和osapi_compute_app_v2，其前面的Application都扮演这最后一个Application的过滤器。我们以参数keystone为例，实现参数keystone的Application为osapi_compute_app_v2，它前面的faultwrap sizelimit authtoken keystonecontext等应用都是它的过滤器，其实现过程也就是faultwrap(sizelimit(authtoken(keystonecontext(osapi_compute_app_v2))))，具体的调用过程就是osapi_compute_app_v2->keystonecontext->authtoken->sizelimit->faultwrap，前面方法的执行结果作为后面方法的输入参数，最后得到的运行结果作为参数keystone的值。可以说明，三个参数noauth，keystone和keystone_nolimit的值都是这样得到的。
详解：
后面三句分别对应配置文件中不同配置执行不通的过滤流程，最终三个都将返回osapi_compute_app_v2应用。
use = call:nova.api.auth:pipeline_factory代码：
pipeline_factory函数的目的就是读取解析配置文件（/etc/nova/nova.conf）中定义的认证策略：noauth、keystone、keystone_nolimit。
假若在配置文件nova.conf中，配置的是auth_strategy=keystone，接下来匹配：
keystone_nolimit = faultwrap sizelimit authtoken keystonecontext osapi_compute_app_v2
faultwrap sizelimit过滤器不做进一步详解，有兴趣者请自行跟进代码查看。
5、分析authtoken 过滤器：
找到对应的代码：
由上述代码可知，授权对应过滤器authtoken，具体操作在AuthProtocol类的__call__函数。授权的具体细节请自行分析以上函数，再次不做过多讲解。
注：有paste的知识可知，每一个factory，都会有一个__call__函数。调用该factory就会调用此函数。
|
vim /etc/nova/api-paste.ini
|
其中openstack_compute_api_v2的use = call:nova.api.auth:pipeline_factory表示通过访问的url，来选择具体使用哪个应用。
根据http://192.168.1.120:8774/v2/c865d5a3760348a4b8a92cf657a9176d/servers/detail，由匹配规则，接下来调用
/v2: openstack_compute_api_v2应用。
这个Application对应了三个参数：noauth，keystone和keystone_nolimit。我们可以看到这里Application具体实现的方法是pipeline_factory。我们可以看到在参数noauth，keystone和keystone_nolimit中，分别集成了多个应用，实际上每个参数最终实现的Application分别是最后一个，即osapi_compute_app_v2，osapi_compute_app_v2和osapi_compute_app_v2，其前面的Application都扮演这最后一个Application的过滤器。我们以参数keystone为例，实现参数keystone的Application为osapi_compute_app_v2，它前面的faultwrap sizelimit authtoken keystonecontext等应用都是它的过滤器，其实现过程也就是faultwrap(sizelimit(authtoken(keystonecontext(osapi_compute_app_v2))))，具体的调用过程就是osapi_compute_app_v2->keystonecontext->authtoken->sizelimit->faultwrap，前面方法的执行结果作为后面方法的输入参数，最后得到的运行结果作为参数keystone的值。可以说明，三个参数noauth，keystone和keystone_nolimit的值都是这样得到的。
详解：
后面三句分别对应配置文件中不同配置执行不通的过滤流程，最终三个都将返回osapi_compute_app_v2应用。
use = call:nova.api.auth:pipeline_factory代码：
pipeline_factory函数的目的就是读取解析配置文件（/etc/nova/nova.conf）中定义的认证策略：noauth、keystone、keystone_nolimit。
假若在配置文件nova.conf中，配置的是auth_strategy=keystone，接下来匹配：
|
keystone_nolimit = faultwrap sizelimit authtoken keystonecontext osapi_compute_app_v2
|
6、接下来分析keystonecontext 过滤器：
对应代码：
上述代码功能：在上一步授权走过滤器authtoken时候，从keystone中获取了一些必要的信息。例如X_USER_ID、X_TENANT_NAME、X_ROLES、token值等等，然后组装成一个http的request，请求对应的url信息。
从命令执行结果也可以看出authtoken、和keystonecontext两个过滤器各自功能及交互过程。
authtoken过滤器执行过程：（curl -i是发送一个url请求，INFO后面则是从keystone模块请求回来的参数，这些参数传递给keystonecontext过滤器，
keystonecontext过滤器根据这些参数，再组装出对应的http request，请求相应的url）
keystonecontext过滤器执行过程：
7、到此过滤器执行完了，接下来重点分析osapi_compute_app_v2应用：
keystone_nolimit = faultwrap sizelimit authtoken keystonecontext osapi_compute_app_v2
找到对应入口代码：
上述APIRouter类就是paste加载osapi_compute_app_v2应用，然后发布路由规则处。
class APIRouter(nova.api.openstack.APIRouter):
找到父类
nova.api.openstack.APIRouter：
8、打印router信息：
vim /usr/lib/python2.6/site-packages/nova/api/openstack/__init__.py
重启openstack-nova-api服务
service openstack-nova-api restart
tailf /var/log/nova/api.log
根据上述的routes信息，可以知道openstack nova模块发布出了哪些api开发给上层调用。（其他keystone、glance等模块发布流程类似，请自行研究。）
关于routes更多信息，请参考文章WSGI熟悉之Rails 入门（ruby-rails环境配置及简单使用）
关于如何在如何后台模块router中增加自定义api，及在前台dashboard中调用该自定义api，请参考后续文章--openstack_ice之routes自定义及调用详解。
6、接下来分析keystonecontext 过滤器：
对应代码：
上述代码功能：在上一步授权走过滤器authtoken时候，从keystone中获取了一些必要的信息。例如X_USER_ID、X_TENANT_NAME、X_ROLES、token值等等，然后组装成一个http的request，请求对应的url信息。
从命令执行结果也可以看出authtoken、和keystonecontext两个过滤器各自功能及交互过程。
authtoken过滤器执行过程：（curl -i是发送一个url请求，INFO后面则是从keystone模块请求回来的参数，这些参数传递给keystonecontext过滤器，
keystonecontext过滤器根据这些参数，再组装出对应的http request，请求相应的url）
keystonecontext过滤器执行过程：
7、到此过滤器执行完了，接下来重点分析osapi_compute_app_v2应用：
|
keystone_nolimit = faultwrap sizelimit authtoken keystonecontext osapi_compute_app_v2
|
找到对应入口代码：
上述APIRouter类就是paste加载osapi_compute_app_v2应用，然后发布路由规则处。
|
class APIRouter(nova.api.openstack.APIRouter):
|
8、打印router信息：
|
vim /usr/lib/python2.6/site-packages/nova/api/openstack/__init__.py
|
重启openstack-nova-api服务
|
service openstack-nova-api restart
tailf /var/log/nova/api.log
|
根据上述的routes信息，可以知道openstack nova模块发布出了哪些api开发给上层调用。（其他keystone、glance等模块发布流程类似，请自行研究。）
关于routes更多信息，请参考文章WSGI熟悉之Rails 入门（ruby-rails环境配置及简单使用）
关于如何在如何后台模块router中增加自定义api，及在前台dashboard中调用该自定义api，请参考后续文章--openstack_ice之routes自定义及调用详解。
扫一扫
1600
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
