【OpenStack】OpenStack系列13之Nova源码解析与API扩展

1. 学习思路
   1. 议程：代码结构-主干流程-分层架构-业务模型-数据库模型-消息模型

      

   2. 分布式架构：Api：横向扩展    rpc：纵向扩展
   3. 分层架构：Controller接口层、View/Manager逻辑层、DAO/Model数据库层
   4. Nova与其他组件交互

      

   5. 业务模型——数据库建模

      

   6. 消息模型

      rabbitmqctl list_queues，可以列出所有的消息队列

      或者通过web管理界面，使用guest/openstack登录可以浏览

      

   7.  
2. Nova代码结构
   1. 提纲挈领式的掌握，知道怎么定制化，知道组件之间的调用关系
   2. setup.cfg看所有的功能
   3. etc配置文件模版、nova放各个组件代码、可以通过outline查看类代码结构

      

   4. model对应数据库表结构

      

   5. db-api为业务层封装

      

   6. schedule，过滤规则、weght规则。DiskFilter继承BaseHostFilter实现host_passes，返回True还是False。在nova的配置文件里面配置实用哪些filter。

      

   7. virt目录最终nova调用底层api干活

      

3. nova主干流程
   1. 调用流程

      参考：

      http://ilearnstack.com/2013/04/26/request-flow-for-provisioning-instance-in-openstack/comment-page-1/

      http://www.google.com.hk/imgres?imgurl=http://3.bp.blogspot.com/-lgqcvaFG_ak/UyV_FNd1n_I/AAAAAAAAABU/76rpDd5Rzro/s1600/adhoc-nova-boot-havana-07192013.png&imgrefurl=http://bodenr.blogspot.com/2014/03/openstack-nova-boot-server-call-diagram.html&h=620&w=1210&tbnid=n9hgUX4EOVe52M:&zoom=1&docid=MODxLOTD5C3AIM&ei=01RtVYWxD5Dh8AWDzIPIAw&tbm=isch

      

   2. 虚拟机状态

      

   3. 虚拟机创建流程-代码-函数调用关系图示。先了解全景图，了解代码调用关系，必要的时候再去看代码细节。

      

   4.  
4. Nova-api扩展
   1. 参考：https://wiki.openstack.org/wiki/WritingRequestExtensions
   2. 代码目录

      

   3. nova/api目录扩展

      nova/db目录建数据库

      nova/tests目录放测试代码

   4. 扩展方法
      1. 扩展代码部署在/nova/nova/api/openstack/compute/contrib下，如新增documents.py模块
      2. 模块需要定义Documents类，该类继承extensions.ExtensionDescriptor
      3. 修改该类的name、alias、namespace、updated属性
      4. 重写该类的get_resources方法，返回resources对象
      5. Resources对象的构造需要DocumentsController对象
      6. DocumentsController对象中定义了具体的api，实现增删改查方法，增删改查的函数名称需要按照约定进行

      参考：

      https://wiki.openstack.org/wiki/WritingRequestExtensions

      https://github.com/yongluo2013/osf-openstack-training/blob/master/code/nova-api/my-nova-api/nova/api/openstack/compute/contrib/documents.py

   5. 代码部署
      1. 拷贝代码到发布路径，不是源码路径。

         cp nova/api/openstack/compute/contrib/documents.py /usr/lib/python2.6/site-packages/nova/api/openstack/compute/contrib/

         或者不拷贝，重新安装nova，python setup.py install，自动拷贝到目标目录：

         

      2. 拷贝/usr/bin/nova-api到/root/openstack/nova/bin目录，方便使用eclipse进行调试。
   6. 测试
      1. Token-get：

         http://10.20.0.88:5000/v2.0/tokens

         POST

         Content-Type    application/json

      {

      "auth": {

      "tenantName": "admin",

      "passwordCredentials": {

      "username": "admin",

      "password": "admin"

      }

      }

      }

      

      获取得到token以及compute的endpoint

      http://controller0:8774/v2/3edbf8dbb5234ac29831d608aa824c7e

      1. 测试扩展api加载是否成功

         http://10.20.0.88:8774/v2/3edbf8dbb5234ac29831d608aa824c7e/extensions/os-documents

         GET

         X-Auth-Token XXXXXXXXXXXX

         返回结果如下：

         {

         "extension" : {

         "updated" : "2014-10-19T00:00:00+00:00",

         "name" : "documents",

         "links" : [ ],

         "namespace" : "www.doc.com",

         "alias" : "os-documents",

         "description" : "Documents ExtensionDescriptor implementation"

         }

         }

         说明加载成功！

      2. 接口测试

         Index：

         http://10.20.0.88:8774/v2/3edbf8dbb5234ac29831d608aa824c7e/os-documents

         GET

         X-Auth-Token XXXXXXXXXXXX

         返回：{"documents": [{"id": "1001", "name": "docs1"}, {"id": "1002", "name": "docs2"}, {"id": "1003", "name": "docs3"}]}

         show：

         http://10.20.0.88:8774/v2/3edbf8dbb5234ac29831d608aa824c7e/os-documents/1002

         GET

         X-Auth-Token XXXXXXXXXXXX

         返回：{"id": "1002", "name": "docs2"}

         Create：

         http://10.20.0.88:8774/v2/3edbf8dbb5234ac29831d608aa824c7e/os-documents

         POST

         X-Auth-Token XXXXXXXXXXXX

         Content-Type    application/json

         {"document":{"id": "1004", "name": "docs4"}}

         返回：{"id": "1004", "name": "docs4"}

         再次查询，已经更新。

         Update：

         http://10.20.0.88:8774/v2/3edbf8dbb5234ac29831d608aa824c7e/os-documents/1004

         PUT

         X-Auth-Token XXXXXXXXXXXX

         Content-Type    application/json

         {"document":{"id": "1004", "name": "docs4_MOD"}}

         返回：{"id": "1004", "name": "docs4_MOD"}

         再次查询，已经更新。

         Delete：

         http://10.20.0.88:8774/v2/3edbf8dbb5234ac29831d608aa824c7e/os-documents/1004

         DELETE

         X-Auth-Token XXXXXXXXXXXX

         Content-Type    application/json

         返回：HTTP/1.1 202 Accepted

         再次查询，已经删除。

      3.  
   7.  

附录：

012.openstack 学习导图

012.request-flow1：

012.request-flow2：

012.虚拟机创建流程-代码：

012.虚拟机创建流程-整体：