探索 OpenStack 之（10）：深入镜像服务Glance

0.2 Glance REST API的版本V1和V2

0.2.1功能差别

Glance有两个版本的REST API V1 和 V2，两者之间还是有蛮大的不同：

（1）. V1只提供了基本的image和member操作功能：镜像创建、删除、下载、列表、详细信息查询、更新，以及镜像tenant成员的创建、删除和列表。

（2）. V2除了支持V1的所有功能外，主要是增加了如下功能：

镜像 location 的添加、删除和修改等操作
metadata namespace 操作
image tag 操作

（3）.V1 和V2对 image store 的支持是相同的。

0.2.2 实现差别

V1的实现上，有glance-api和glance-registry两个WSGI 服务，都提供REST API，只不过glance-API的REST API对外使用，glance-registry的API只由glance-api使用。



而 V2在实现上，把 glance-registry 的功能合并到了 glance-api 中，减少了一个中间环节。

1. V1版本的代码实现

1.1 代码模块

从上图也可以看出，Glance V1主要是三个模块：

glance/common/
wsgi.py -- WSGI server,开启glance-(api|registry)服务，接受请求，比如GET /images/bb8838d5-06b5-4f7e-b6ef-87c908f04cc7 HTTP/1.1

glance-api：提供对外REST API，同时调用glance-registry进行数据库操作，以及调用glance-store进行store操作

images.py -- 实现image-* 操作
memebers.py --实现 member-* 操作
router.py -- 将WSGI 收到的 HTTP 操作映射到 glance-api 模块的 Controller 类的方法.

glance-registry：向 glance-api 提供元数据数据库操作 REST API，默认在端口9191监听。 主要文件：

client/v1/

api.py -- registry API 入口，调用client.py中的函数
client.py --调用 images.py 和 members.py 中的function

api/v1/
images.py -- 调用 glance/db/sqlalchemy/api.py 实现 images 数据库相关操作
memebers.py --调用 glance/db/sqlalchemy/api.py 实现 members数据库表的相关操作

glance/db/sqlalchemy/
api.py -- db操作api入口
models.py -- 数据库表模型，每个表对应一个类

glance-store：这部分代码不是在 glance github 代码项目中，不理解为什么不是在一起，cinder也是类似的架构，但是cinder的所有代码都是在一个github项目中。

glance-store 向 glance-api 提供文件 backend.py 作为 store 操作的统一入口。主要函数包括：

create_stores：调用store.configure_add，glance-api服务启动的时候根据用户配置调用该函数来注册各个store
get_from_backend：调用store.get，从store中获取data chunks
get_size_from_backend：调用store.get_size，从store中获取image size
delete_from_backend：调用store.delete，从store中删除image data
store_add_to_backend：调用store.add，添加image到store
set_acls：调用store.set_acls，设置image的读写权限

glance-store 提供一个需要各个 store vendor 实现的基类Store，定义了几个需要实现的操作：

configure_add：根据用户配置来配置该 backend store
get：获取 image chunk data
get_size：获取image大小
add： 添加 image 到store中
delete： 从 store 中删除 image chunk data
set_acls： 设置 image 的读写权限

目前支持的 backend store 见上图。各backend store所支持的功能差别很大，比如

cinder.py 只实现了方法 get_size，因为目前的 Glance 不支持 upload image 到 Cinder volume 中。
http.py 只实现了 get 和 get_size， 因此只能从http store download image 和查询 image size。
swift.py 的实现可以说是最全的，filesystem 次之。

image 存在于不同store 中时不同的 Location url 格式

cinder://volume-id https://user:pass@example.com:80/images/some-id http://images.oracle.com/123456
swift://example.com/container/obj-id

swift://user:account:pass@authurl.com/container/obj-id

wift+http://user:account:pass@authurl.com/container/obj-id

s3://accesskey:secretkey@s3.amazonaws.com/bucket/key-id

file:///var/lib/glance/images/1

s3+https://accesskey:secretkey@s3.amazonaws.com/bucket/key-id

使用 backend store

默认使用的 store 由配置文件 glance-api.conf 的配置项 default_store=<STORE> 指定
可以使用的 stores 有配置文件 glance-api.conf 的配置项 stores=<STORES> 指定
在Glance Cli image-create 中可使用参数 --store 指定目标backend store