探索 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