nova创建虚拟机源码分析系列之六 api入口create方法

openstack 版本：Newton

注：博文图片采用了很多大牛博客图片，仅作为总结学习，非商用。
该图全面的说明了nova创建虚机的过程，从逻辑的角度清晰的描述了前端请求创建虚拟机之后发生的一系列反应。

上图是以逻辑的关系说明虚机创建的流程，并没有涉及到真正的代码，下面这张图则是从代码的角度来看虚机的创建过程。两张逻辑图相辅相成，能够快速对nova创建虚机流程有一个认识。

上一篇博文已经将nova创建虚机的流程分析到restful调用具体的函数。如下图所示，本篇将从该函数开始分析，展开nova服务的代码文件。

上图的create函数是nova api的入口函数，所有nova api的调用都是从该函数开始的。

从该函数开始到nova调用底层驱动创建虚拟机，要经过的调用流程如下：

 nova.api.openstack.compute.servers.py::Controller：create
->nova.compute.api.py::API:create
->nova.compute.api.py::API:_create_instance
->nova.comductor.ComputeTaskAPI.py::build_instances
->nova.conductor.rpcapi.py::ComputeTaskAPI:build_instances
->nova.conductor.manager.py::ComputeTaskAPI.py:build_instances
->nova.compute.rpcapi.ComputeManager.py::build_and_run_instance
->nova.compute.manager.py::ComputeManager:_do_build_and_run_instance
->nova.compute.manager.py::ComputeManager:_build_and_run_instance
->driver

nova.api.openstack.compute.servers.py:: Controller:create  指该create函数的所在路径是nova文件夹下的/nova/api/openstack/compute/servers.py中的create方法

同理：nova.compute.api.py::API:create 指该create方法在/nova/compute/api.py中的create方法。

所以这个调用的顺序就是如下图所示：

那么接下来就详细分析create()函数方法。

想要搞明白create函数做了什么，就要弄清楚函数传入的参数是什么。create传入了三个参数，分别是self，req，body。

其中self是类方法的标识，如果java类中函数的 "this" 字段。那么req、body分别是什么呢？使用python中print打印到文件的方法，输出了req与body的内容。

req

POST /v2.1/servers HTTP/1.0
Accept: application/json
Accept-Encoding: gzip, deflate
Connection: keep-alive
Content-Length: 323
Content-Type: application/json
Host: 192.168.252.134:8774
User-Agent: python-novaclient
X-Auth-Project-Id: 836c0b02b549489eac82733267830e60
X-Auth-Token: 31475f46361e41d49c3aa519531192c2
X-Domain-Id: None
X-Domain-Name: None
X-Identity-Status: Confirmed
X-Is-Admin-Project: False
X-Project-Domain-Id: default
X-Project-Domain-Name: Default
X-Project-Id: 836c0b02b549489eac82733267830e60
X-Project-Name: demo
X-Role: Member,anotherrole
X-Roles: Member,anotherrole
X-Service-Catalog: [{"endpoints": [{"adminURL": "http://192.168.252.134:8774/v2.1", "region": "RegionOne", "internalURL": "http://192.168.252.134:8774/v2.1", "publicURL": "http://192.168.252.134:8774/v2.1"}], "type": "compute", "name": "nova"}, {"endpoints": [{"adminURL": "http://192.168.252.134:8774/v2/836c0b02b549489eac82733267830e60", "region": "RegionOne", "internalURL": "http://192.168.252.134:8774/v2/836c0b02b549489eac82733267830e60", "publicURL": "http://192.168.252.134:8774/v2/836c0b02b549489eac82733267830e60"}], "type": "compute_legacy", "name": "nova_legacy"}, {"endpoints": [{"adminURL": "http://192.168.252.134:8776/v2/836c0b02b549489eac82733267830e60", "region": "RegionOne", "internalURL": "http://192.168.252.134:8776/v2/836c0b02b549489eac82733267830e60", "publicURL": "http://192.168.252.134:8776/v2/836c0b02b549489eac82733267830e60"}], "type": "volumev2", "name": "cinderv2"}, {"endpoints": [{"adminURL": "http://192.168.252.134:9696/", "region": "RegionOne", "internalURL": "http://192.168.252.134:9696/", "publicURL": "http://192.168.252.134:9696/"}], "type": "network", "name": "neutron"}, {"endpoints": [{"adminURL": "http://192.168.252.134/identity_v2_admin", "region": "RegionOne", "internalURL": "http://192.168.252.134/identity", "publicURL": "http://192.168.252.134/identity"}], "type": "identity", "name": "keystone"}, {"endpoints": [{"adminURL": "http://192.168.252.134:8776/v1/836c0b02b549489eac82733267830e60", "region": "RegionOne", "internalURL": "http://192.168.252.134:8776/v1/836c0b02b549489eac82733267830e60", "publicURL": "http://192.168.252.134:8776/v1/836c0b02b549489eac82733267830e60"}], "type": "volume", "name": "cinder"}, {"endpoints": [{"adminURL": "http://192.168.252.134:8080", "region": "RegionOne", "internalURL": "http://192.168.252.134:8080/v1/AUTH_836c0b02b549489eac82733267830e60", "publicURL": "http://192.168.252.134:8080/v1/AUTH_836c0b02b549489eac82733267830e60"}], "type": "object-store", "name": "swift"}, {"endpoints": [{"adminURL": "http://192.168.252.134:8776/v3/836c0b02b549489eac82733267830e60", "region": "RegionOne", "internalURL": "http://192.168.252.134:8776/v3/836c0b02b549489eac82733267830e60", "publicURL": "http://192.168.252.134:8776/v3/836c0b02b549489eac82733267830e60"}], "type": "volumev3", "name": "cinderv3"}, {"endpoints": [{"adminURL": "http://192.168.252.134:9292", "region": "RegionOne", "internalURL": "http://192.168.252.134:9292", "publicURL": "http://192.168.252.134:9292"}], "type": "image", "name": "glance"}]
X-Tenant: demo
X-Tenant-Id: 836c0b02b549489eac82733267830e60
X-Tenant-Name: demo
X-User: demo
X-User-Domain-Id: default
X-User-Domain-Name: Default
X-User-Id: ac86920aec8c443f9fad33283599a17c
X-User-Name: demo

{"server": {"name": "demo", "imageRef": "ec8f8b10-beb4-4802-9158-7b3ca8357d16", "availability_zone": "nova", "flavorRef": "1", "OS-DCF:diskConfig": "AUTO", "max_count": 1, "min_count": 1, "networks": [{"uuid": "cf8411d0-85b4-4534-9b7c-aed9dbecaafe"}], "security_groups": [{"name": "2a2f7994-a555-45be-9909-3bb06b1f4811"}]}}

req是http报文的全部内容，包括报文头，报文内容。其中很熟悉的字段：X-Auth-Token是已经获得的token，还有获得Token时返回的服务列表Catalog。会不会有人好奇为什么发送的不是账号和密码？而是Token？在登陆上openstack dashboard时账号和密码都被验证，后面的操作全都是基于Token来操作的。

报文内容中包含一个server字典，这是我们填写的创建虚机的数据。可以看到下面的代码中有在创建虚机时必填的参数，name，镜像，flavor，network等。

{"server":
    {
        "name": "demo",
        "imageRef": "ec8f8b10-beb4-4802-9158-7b3ca8357d16",
        "availability_zone": "nova",
        "flavorRef": "1",
        "OS-DCF:diskConfig": "AUTO",
        "max_count": 1,
        "min_count": 1,
        "networks": [{"uuid": "cf8411d0-85b4-4534-9b7c-aed9dbecaafe"}],
        "security_groups": [{"name": "2a2f7994-a555-45be-9909-3bb06b1f4811"}]
    }
}

再来看body中的内容是什么

{
    u'server':
     {
         u'name': u'demo', 
         u'imageRef': u'ec8f8b10-beb4-4802-9158-7b3ca8357d16', 
         u'availability_zone': u'nova', 
         u'flavorRef': u'1', 
         u'OS-DCF:diskConfig': u'AUTO', 
         u'max_count': 1, 
         u'min_count': 1, 
         u'networks': [{u'uuid': u'cf8411d0-85b4-4534-9b7c-aed9dbecaafe'}], 
         u'security_groups': [{u'name': u'2a2f7994-a555-45be-9909-3bb06b1f4811'}]
     }
}

可以看到body中的内容是req内容的一部分，是post方法的内容。

搞清楚了传入的数据，下面就是函数处理过程。

这里是该函数最重要的调用。调用了compute/api.py中的create方法去创建虚机。

总结来说，该函数主要做的工作：

/nova/api/openstack/compute/server.py::create()  
1 获取客户端传入的虚拟机参数
2 获取虚拟机名并检查是否合理
3 检查API版本
4 构造用户id，项目id，可用域字典
5 获取可用域
6 块设备映射
7 获取虚机的磁盘镜像uuid
8 获取客户端需求的网络
9 获取续集规格ID
10 调用compute_api.create()
11 将虚拟机信息转化为字典
12 添加访问当前虚拟机资源的url

主要任务是从传递过的req中获取各种创建虚拟机所需要的参数信息，做简单必要验证，然后将获取的一系列参数（image_uuid,name,insts_type等）

作为nova/compute/api.py中的API类的create()方法参数，最后将返回的信息处理。那么下一节的内容就是要探究调用函数/nova/compute/api.py中的create()函数

完成了什么样的工作。