librados相关介绍

1. librados介绍

---

ceph存储集群提供的基本存储服务，使ceph能够在一个联合文件系统中独一无二的实现对象存储(object storage)、块存储(block storage)以及文件存储(file storage)。然而，你并不一定需要通过RESTful API、block API或者POSIX文件系统接口才能访问ceph存储集群。依赖于RADOS，你可以直接通过librados API来访问ceph存储集群。

librados API可以访问ceph存储集群的两类守护进程：

• Ceph Monitor: 维持cluster map的一份主拷贝
• Ceph OSD Daemon: 在存储节点上存储对象数据

2. 安装librados开发环境

---

通过librados创建的Ceph Client可以直接和OSD来进行交互来存取数据。要想和OSD进行交互，client app必须要调用librados并且连接到Ceph Monitor。一旦连接成功，librados就可以从Ceph Monitor处获得Cluster Map。当client app想要读写数据的时候，其需要创建一个IO context并且绑定到一个pool上。pool是和rule相关联的，其定义了如何将数据存入集群。通过IO Context，client向librados提供object名称，librados采用该名称及获取到的cluster map就能够计算出需要将数据存放到哪个PG和OSD。

ceph storage cluster handle封装了客户端的配置：包括

• user ID(针对rados_create())或user name(针对rados_create2())
• cephx身份认证的key
• monitor ID和IP地址
• 日志级别
• 调试级别

这样要使用librados的步骤就是：1） 创建cluster handler 2）使用cluster handler连接到存储集群。 要想连接到集群，app必须提供monitor IP，username和身份认证的key(假如启用了cephx的话）

rados提供了多种方式来设置这些值。对于monitor及身份认证的key的设置，一种简单的方法就是将它们写在配置文件中。配置文件中包含至少一个monitor IP及keyring文件路径。例如：

[global]
mon host = 192.168.1.1
keyring = /etc/ceph/ceph.client.admin.keyring

一旦你成功创建handle，你就可以读取该配置文件来配置handle。你也可以通过向你的app client传递参数，然后对应的函数来解析命令行参数例如：（rados_conf_parse_argv())，或者解析ceph环境变量（例如：rados_conf_parse_env())的方式来配置handle。一旦handle连接成功，你就可以采用该handle来操作整个ceph集群了：

• 获得集群数据信息
• 使用pool相关操作（exists,create,list,delete等）
• 获取或设置配置

创建一个IO context

---

一旦app client已经有了cluster handle并且连接上了ceph存储集群，你就可以创建一个IO Context，然后开始读写数据。IO Context将连接绑定到一个特定的pool。用户必须有适当的CAPS权限来访问该pool。IO Context功能包括：

• 读写数据和extended属性
• 遍历出对象和extended属性
• pools快照，列出快照

rados同时支持同步/异步访问集群。一旦创建了IO Context之后，只需要通过object/xatrr名称即可进行读写操作。封装在librados中的CRUSH算法使用crush map选择合适的OSD进行操作。 OSD Daemons负责复制数据的副本。

关闭sessions

---

一旦app client完成了相关操作，用户需要关闭连接和handle。针对asynchronous IO，用户也应确保该异步操作已经完成。

rados_ioctx_destroy(io);
rados_shutdown(cluster);