语料库结构

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/foo:

rm -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

如果一切看起来都很好，更新子模块主分支，并在 ceph.git 中提交子模块：

由 Ceph 基金会带给您

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