开发者指南（快速）

本指南将描述如何为开发构建和测试 Ceph。

开发

The run-make-check.sh脚本将安装 Ceph 依赖项，

./run-make-check.sh

可选地，如果您想针对 Ceph 的特定组件工作，

Example:

./install-deps.sh
./do_cmake.sh -DWITH_MANPAGE=OFF -DWITH_BABELTRACE=OFF -DWITH_MGR_DASHBOARD_FRONTEND=OFF

您还可以关闭构建与您的开发无关的一些核心组件：

./do_cmake.sh ... -DWITH_RBD=OFF -DWITH_KRBD=OFF -DWITH_RADOSGW=OFF

最后，构建 ceph：

cmake --build build [--target <target>...]

Omit--target...如果您想进行完整构建。

运行开发部署

Ceph 包含一个名为vstart.sh (see also 部署开发集群) 的脚本，它允许开发人员使用简单的开发系统部署快速测试

cd build
../src/vstart.sh -d -n

您还可以配置vstart.sh仅使用一个监控器和一个元数据服务器，使用以下方法：

env MON=1 MDS=1 ../src/vstart.sh -d -n -x

集群的大部分日志都可以在build/out.

系统在启动时创建两个池：cephfs_data_a和cephfs_metadata_a。让我们获取当前池的一些统计数据：

$ bin/ceph osd pool stats
*** DEVELOPER MODE: setting PATH, PYTHONPATH and LD_LIBRARY_PATH ***
pool cephfs_data_a id 1
  nothing is going on

pool cephfs_metadata_a id 2
  nothing is going on

$ bin/ceph osd pool stats cephfs_data_a
*** DEVELOPER MODE: setting PATH, PYTHONPATH and LD_LIBRARY_PATH ***
pool cephfs_data_a id 1
  nothing is going on

$ bin/rados df
POOL_NAME         USED OBJECTS CLONES COPIES MISSING_ON_PRIMARY UNFOUND DEGRADED RD_OPS RD WR_OPS WR
cephfs_data_a        0       0      0      0                  0       0        0      0  0      0    0
cephfs_metadata_a 2246      21      0     63                  0       0        0      0  0     42 8192

total_objects    21
total_used       244G
total_space      1180G

创建一个池并对它运行一些基准测试：

bin/ceph osd pool create mypool
bin/rados -p mypool bench 10 write -b 123

将文件放入新池：

bin/rados -p mypool put objectone <somefile>
bin/rados -p mypool put objecttwo <anotherfile>

列出池中的对象：

bin/rados -p mypool ls

完成后，键入以下内容以停止开发 ceph 部署：

../src/stop.sh

重置你的 vstart 环境

vstart 脚本创建 out/ 和 dev/ 目录，其中包含集群的状态。如果您想快速重置环境，

../src/stop.sh
rm -rf out dev
env MDS=1 MON=1 OSD=3 ../src/vstart.sh -n -d

运行 RadosGW 开发环境

Set the RGW在运行 vstart.sh 时设置环境变量以启用 RadosGW。

cd build
RGW=1 ../src/vstart.sh -d -n -x

您现在可以使用 swift python 客户端与 RadosGW 通信。

swift -A http://localhost:8000/auth -U test:tester -K testing list
swift -A http://localhost:8000/auth -U test:tester -K testing upload mycontainer ceph
swift -A http://localhost:8000/auth -U test:tester -K testing list

运行单元测试

测试位于src/tests。运行它们的命令是：

(cd build && ninja check)

由 Ceph 基金会带给您

Ceph 文档是一个社区资源，由非盈利的 Ceph 基金会资助和托管Ceph Foundation. 如果您想支持这一点和我们的其他工作，请考虑加入现在加入.