注意
本文档适用于 Ceph 的开发版本。
Corpus structure
ceph.git/ceph-object-corpus 是一个子模块。
bin/ # misc scripts
archive/$version/objects/$type/$hash # a sample of encoded objects from a specific version
您还可以使用以下方式标记版本之间已知或故意的兼容性问题
archive/$version/forward_incompat/$type
文件的存在表明新版本的代码无法解码跨越该 $version 的旧对象（这通常是常态）。
如何生成对象语料库
我们可以使用 script/gen-corpus.sh 脚本为特定版本的 ceph 生成对象语料库，或者按照以下说明操作
检出干净的仓库（最好不要在您通常工作的地方进行此操作）
git clone ceph.git cd ceph git submodule update --init --recursive --progress
使用标志构建以将对象转储到
/tmp/foorm -rf /tmp/foo ; mkdir /tmp/foo do_cmake.sh -DCMAKE_CXX_FLAGS="-DENCODE_DUMP_PATH=/tmp/foo" cd build make
通过 vstart 启动
cd build MON=3 MGR=2 OSD=3 MDS=3 RGW=1 ../src/vstart.sh -n -x
尽可能多地使用集群功能，以锻炼尽可能多的对象编码器方法
bin/ceph osd pool create mypool bin/rados -p mypool bench 10 write -b 123 bin/ceph osd out 0 bin/ceph osd in 0 bin/init-ceph restart osd.1 for f in ../qa/workunits/cls/*.sh ; do PATH="bin:$PATH" $f ; done PATH="bin:$PATH" ../qa/workunits/rados/test.sh bin/ceph_test_librbd bin/ceph_test_libcephfs bin/init-ceph restart mds.a ../qa/workunits/rgw/run-s3tests.sh
停止
../src/stop.sh
导入语料库（这将需要几分钟）
../src/test/encoding/import.sh /tmp/foo `bin/ceph-dencoder version` ../ceph-object-corpus/archive ../src/test/encoding/import-generated.sh ../ceph-object-corpus/archive
修剪它！将有无数个各种对象的副本，我们只需要一个有代表性的样本。
pushd ../ceph-object-corpus bin/prune-archive.sh popd
验证测试通过
ctest -R readable.sh
将其提交到语料库仓库并推送
pushd ../ceph-object-corpus git checkout -b wip-new git add archive/`../build/bin/ceph-dencoder version` git commit -m `../build/bin/ceph-dencoder version` git remote add cc git@github.com:ceph/ceph-object-corpus.git git push cc wip-new popd
去测试一下
cd my/regular/tree cd ceph-object-corpus git fetch origin git checkout wip-new cd ../build ctest -R readable.sh
如果一切看起来不错，请更新子模块 master 分支，并在 ceph.git 中提交子模块。