third_party submodule を FetchContent に移行 (P8)

[thawk105]

#37 (close 済み) から分離。元の [P4+P8+P10] のうちの P8。

進捗 (2026-05-14 時点)

• spdlog の切り出し対応 (#71 で完了、master に merge 済み) のみ完了。
• FetchContent 本体移行 (masstree/mimalloc/googletest の移行、bootstrap.sh 削除、CI ステップ削除、性能 regression 検証) は未着手*。
• third_party: 未使用の spdlog submodule を除去 (#64 の一部) #71 が残した follow-up は本 issue 末尾の「## 備考」を参照。

背景

現状の構成:

• submodule: third_party/{masstree,mimalloc,googletest} (spdlog は third_party: 未使用の spdlog submodule を除去 (#64 の一部) #71 で除去済み)
• セットアップ: build_tools/bootstrap{,_mimalloc,_googletest,_apt,_tbb}.sh を手動実行 (./build_tools/bootstrap.sh 等)
• CI: build.yml で Build third-party (masstree/mimalloc/googletest) のステップを毎回走らせている (cache hit があれば skip)

FetchContent に移行すれば:

• cmake -S . -B build && cmake --build build だけで完結 → bootstrap*.sh を削除可能
• バージョン宣言が Dockerfile / git submodule ではなく CMake で明示 され、再現性が上がる
• CI の Build third-party (...) ステップが消える (FetchContent の内部 caching に置き換わる)

提案

cmake/ThirdParty.cmake 等にまとめる:

include(FetchContent)

FetchContent_Declare(mimalloc
  GIT_REPOSITORY https://github.com/microsoft/mimalloc.git
  GIT_TAG v2.3.2)
FetchContent_MakeAvailable(mimalloc)
add_library(ccbench::mimalloc ALIAS mimalloc-static)

FetchContent_Declare(googletest
  GIT_REPOSITORY https://github.com/google/googletest.git
  GIT_TAG v1.17.0)
FetchContent_MakeAvailable(googletest)

# masstree は明示 tag が無いので commit SHA で pin
FetchContent_Declare(masstree
  GIT_REPOSITORY https://github.com/...
  GIT_TAG b3c5d054b66b08374d7a6ff5a0faeaf28b041a38)   # 現 submodule の commit
# masstree は CMake project ではないので Populate のみして手動で add_library

注意点 (重要)

ccbench は性能比較のための研究ベンチマークなので、以下を強く確認すべき:

1. mimalloc の性能特性は allocator の挙動に直結する。現 submodule の v2.3.2 と FetchContent で取得するバージョンで「全プロトコルの YCSB / TPC-C / BoMB 数値が変わらない」ことを実測で確認 (= 性能 regression がないこと)。v2.1.7 のような古い tag に下げるなら更に慎重に。
2. masstree は upstream の Kohler の repo に明示的な version tag がない (master 追従の submodule)。FetchContent でも commit SHA で pin する形で固定し、勝手に master 追従しないようにする。
3. third_party/spdlog は third_party: 未使用の spdlog submodule を除去 (#64 の一部) #71 で調査済み・除去済み。調査の結果、参照元は include/logger.h 1 ファイルのみで、その logger.h 自体がどこからも #include されていない dead code だった (submodule もそもそも init されていなかった)。CMake / CI / Dockerfile / build_tools からの参照は 0 件。third_party: 未使用の spdlog submodule を除去 (#64 の一部) #71 で .gitmodules の spdlog セクション削除 + gitlink 削除を実施済みのため、FetchContent 移行対象には含めない。
4. bootstrap_tbb.sh は third_party/tbb を参照しているが、tbb は submodule に登録されていない (CLAUDE.md の言及あり)。FetchContent 移行のついでに、tbb 関連の dead な bootstrap script も削除候補。

To-do

• spdlog の利用箇所を確認 → 未使用なら submodule からも外す (third_party: 未使用の spdlog submodule を除去 (#64 の一部) #71 で完了)
• cmake/ThirdParty.cmake 等に FetchContent_Declare をまとめる
• bootstrap_mimalloc.sh / bootstrap_googletest.sh / bootstrap.sh (masstree 用) / bootstrap_tbb.sh を削除または非推奨化
• build_tools/ubuntu.deps から関連 apt deps を削除可能か確認
• .github/workflows/build.yml から Build third-party (...) 系ステップを削除 (FetchContent の内部 cache に置き換わる)
• .github/workflows/devcontainer-image.yml で third_party をビルド済みで image に焼く部分も整理 (現状は触っていないかも)
• docs/build.md を cmake -B build だけのフローに更新
• .devcontainer/Dockerfile の bootstrap 関連の言及があれば削除 (今はおそらく無いが念のため)

完了条件

• cmake -B build && cmake --build build がスクリプトなしで成功する
• bootstrap*.sh 系が削除されている
• CI で Build third-party (...) 系ステップが消えている
• 全プロトコルのビルドが通る
• 全プロトコルの YCSB/TPC-C/BoMB 数値が submodule 版と一致する (性能 regression なし)

優先度

高 (構造改善) だが工数大。性能 regression 検証 が地味に時間がかかる (x86_64 Linux 実機が必要)。devcontainer の QEMU では数値検証できない点に注意。

備考: #71 のスコープ外として残った follow-up

#71 (spdlog submodule 除去) は submodule の除去のみを行い、以下 2 点はスコープ外として残している。本 issue の論点 (FetchContent 移行) とは別なので、別 issue で整理するのが望ましい:

• include/logger.h が dead code として残存している (どこからも #include されておらず削除候補)。
• docs/architecture_{ja,en}.md の submodule 一覧記述に spdlog がまだ残っている (現状と不整合)。

Related

• [P4+P8+P10] CMake衛生一括対応（オプション集約・FetchContent・フォーマット） #37 (close 済み、context 分割元): P8 = この issue
• third_party: 未使用の spdlog submodule を除去 (#64 の一部) #71 (merge 済み): spdlog submodule 除去 (この issue の To-do 1 項目を切り出したもの)

[thawk105]

#64 を「FetchContent 移行」という単一コンテキストとして再点検したところ、
実際には複数のコンテキスト（基盤導入 / mimalloc の性能検証 / CI・docs 仕上げ /
#71 follow-up）を抱えていることが分かったため、CLAUDE.md ハードルール#3
「1 issue = 1 context」に従い以下へ分割し、本 issue はクローズします。
（運用パターン: #29→#30-38, #37→#60-64, #27→3分割 と同じく、分割元はクローズ）

• [P8] third_party: FetchContent 基盤導入 — masstree / googletest 移行 #97: FetchContent 基盤導入 — masstree / googletest 移行
• [P8] third_party: mimalloc を FetchContent 化 + 性能 regression 検証 #98: mimalloc を FetchContent 化 + 性能 regression 検証（[P8] third_party: FetchContent 基盤導入 — masstree / googletest 移行 #97 に依存）
• [P8] third_party: bootstrap / CI / docs クリーンアップ（FetchContent 移行の仕上げ） #99: bootstrap / CI / docs クリーンアップ（[P8] third_party: FetchContent 基盤導入 — masstree / googletest 移行 #97, [P8] third_party: mimalloc を FetchContent 化 + 性能 regression 検証 #98 に依存）
• [P8] cleanup: 未使用の include/logger.h と docs の spdlog 記述を除去（#71 follow-up） #100: 未使用 logger.h と docs の spdlog 記述を除去（third_party: 未使用の spdlog submodule を除去 (#64 の一部) #71 follow-up、独立）

2026-05-14 時点の検証で確認した補足:

• spdlog submodule は third_party: 未使用の spdlog submodule を除去 (#64 の一部) #71 で除去済み（tracked submodule は masstree/mimalloc/
  googletest の3つ）。
• third_party: 未使用の spdlog submodule を除去 (#64 の一部) #71 follow-up（logger.h dead code、architecture docs の spdlog 記述）は未対応の
  まま残存 → [P8] cleanup: 未使用の include/logger.h と docs の spdlog 記述を除去（#71 follow-up） #100 に切り出し。
• MasstreeWrapperをトップレベルのindex/ディレクトリに移動する（将来的にはプラガブルなインデックス層も検討） #27（index/ プラガブル化）ステップ3が本 issue を参照していたため、MasstreeWrapperをトップレベルのindex/ディレクトリに移動する（将来的にはプラガブルなインデックス層も検討） #27 本文の
  参照は [P8] third_party: FetchContent 基盤導入 — masstree / googletest 移行 #97 に張り替えます。