git-2-49-features

Git 2.49+ の機能（2025）

git-backfill コマンド（2.49 の新機能）

概要： path-walk API を使用して、部分クローン内の不足しているオブジェクトを効率的にダウンロードします。

理由： 部分クローンからオブジェクトを取得する際の差分圧縮が大幅に改善され、ダウンロードサイズが小さくなり、パフォーマンスも向上します。

基本的な使い方

# Check if you have a partial clone
git config extensions.partialClone

# Download missing objects in background
git backfill

# Download with custom batch size
git backfill --batch-size=1000

# Respect sparse-checkout patterns (only fetch needed files)
git backfill --sparse

# Check progress
git backfill --verbose

使用するタイミング

シナリオ 1：--filter=blob:none を指定してクローンした後

# Clone without blobs
git clone --filter=blob:none https://github.com/large/repo.git
cd repo

# Later, prefetch all missing objects efficiently
git backfill

シナリオ 2：スパースチェックアウト＋部分クローン

# Clone with both optimizations
git clone --filter=blob:none --sparse https://github.com/monorepo.git
cd monorepo
git sparse-checkout set src/api

# Fetch only needed objects
git backfill --sparse

シナリオ 3：CI/CD の最適化

# In CI pipeline - fetch only what's needed
git clone --filter=blob:none --depth=1 repo
git backfill --sparse
# Much faster than full clone

パフォーマンスの比較

従来の部分クローンのフェッチ：

git fetch --unshallow
# Downloads 500MB in random order
# Poor delta compression

git-backfill を使用した場合：

git backfill
# Downloads 150MB with optimized delta compression (70% reduction)
# Groups objects by path for better compression

Path-Walk API（2.49 の新機能）

概要： 同じパスに存在するオブジェクトをまとめる内部 API です。これにより、差分圧縮が大幅に向上します。

仕組み： コミット順ではなく、ファイルシステムのパス順にオブジェクトを処理することで、Git がより適切な差分のベースを見つけられるようにします。

メリット：

• 部分クローンのシナリオで圧縮率が 50～70％向上
• オブジェクト転送の高速化
• ネットワーク使用量の削減
• パックファイル生成の最適化

以下を使用すると、自動的にメリットが得られます：

• git backfill
• git repack（2.49 で改善）
• サーバー側のオブジェクト転送

Path-Walk の最適化を有効にする

# For repack operations
git config pack.useBitmaps true
git config pack.writeBitmaps true

# Repack with path-walk optimizations
git repack -a -d -f

# Check improvement
git count-objects -v

zlib-ng によるパフォーマンスの向上

概要： Git 2.49 では、圧縮と展開に zlib-ng を統合し、パフォーマンスが向上しています。

メリット：

• 圧縮が 20～30％高速化
• 展開が 10～15％高速化
• パック処理中の CPU 使用量を削減
• 透過的に適用されるため、設定は不要です

以下が自動的に改善されます：

• git clone
• git fetch
• git push
• git gc
• git repack

新しい名前ハッシュアルゴリズム

概要： 差分圧縮時にオブジェクトのペアを選択するアルゴリズムが改善されました。

結果：

• より効率的なパックファイル
• 圧縮率の向上（5～10％改善）
• repack 処理の高速化

自動的に適用されるため、操作は不要です。

libgit 用 Rust バインディング

概要： Git 2.49 では、Git の内部ライブラリ向けに Rust バインディング（libgit-sys と libgit-rs）が追加されました。

関連性： 今後の Git ツールやパフォーマンスの改善では、メモリ安全性とパフォーマンスのために Rust が活用されます。

開発者向け： 公式バインディングを使用して、Rust で Git ツールを構築できるようになりました。

Promisor リモートの機能強化

概要： サーバーが promisor リモートの情報をクライアントに通知できるようになりました。

メリット：

• 部分クローンでの大容量ファイルの処理が改善
• 遅延フェッチの改善
• 不足しているオブジェクトの取得がより効率的に

設定：

# View promisor remote info
git config remote.origin.promisor
git config extensions.partialClone

# Verify promisor packfiles
ls -lah .git/objects/pack/*.promisor

Git 2.49 のワークフロー例

例 1：モノレポを超効率的にクローンする

# Clone large monorepo with maximum efficiency
git clone --filter=blob:none --sparse https://github.com/company/monorepo.git
cd monorepo

# Only checkout your team's service
git sparse-checkout set --cone services/api

# Fetch needed objects with path-walk optimization
git backfill --sparse

# Result: 95% smaller than full clone, 70% faster download

例 2：CI/CD パイプラインの最適化

# .github/workflows/ci.yml
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout with optimizations
        run: |
          git clone --filter=blob:none --depth=1 --sparse ${{ github.repositoryUrl }}
          cd repo
          git sparse-checkout set src tests
          git backfill --sparse

      - name: Run tests
        run: npm test
# 80% faster than full clone in CI

例 3：膨大な履歴を扱う

# Clone repository with massive history
git clone --filter=blob:none https://github.com/project/with-long-history.git
cd with-long-history

# Work on recent code only (objects fetched on demand)
git checkout -b feature/new-feature

# When you need full history
git backfill

# Repack for optimal storage
git repack -a -d -f  # Uses path-walk API

非推奨の機能（Git 3.0 で削除）

⚠️ 正式に非推奨になりました：

• .git/branches/ ディレクトリ（代わりにリモートを使用してください）
• .git/remotes/ ディレクトリ（代わりに git remote コマンドを使用してください）

移行：

# If you have old-style remotes, convert them
# Check for deprecated directories
ls -la .git/branches .git/remotes 2>/dev/null

# Use modern remote configuration
git remote add origin https://github.com/user/repo.git
git config remote.origin.fetch '+refs/heads/*:refs/remotes/origin/*'

Meson ビルドシステム

概要： Git の代替ビルドシステムとして、Meson の開発が引き続き進められています。

理由： ビルドの高速化と、クロスプラットフォーム対応の改善です。

状況： 実験段階です。本番環境では make を使用してください。

netrc サポートの再有効化

概要： HTTP トランスポートで認証に .netrc を使用できるようになりました。

使い方：

# ~/.netrc
machine github.com
  login your-username
  password your-token

# Git will now use these credentials automatically
git clone https://github.com/private/repo.git

Git 2.49 のベストプラクティス

1. 部分クローンでは git-backfill を使用する：

   git backfill --sparse  # Better than git fetch --unshallow
   

2. 最適化を組み合わせる：

   git clone --filter=blob:none --sparse <url>
   git sparse-checkout set --cone <paths>
   git backfill --sparse
   

3. 定期的にメンテナンスする：

   git backfill  # Fill in missing objects
   git repack -a -d -f  # Optimize with path-walk
   git prune  # Clean up
   

4. 部分クローンの状態を監視する：

   # Check promisor remotes
   git config extensions.partialClone
   
   # List missing objects
   git rev-list --objects --all --missing=print | grep "^?"
   

5. 非推奨の機能から移行する：

   # Move away from .git/branches and .git/remotes
   # Use git remote commands instead
   

トラブルシューティング

git-backfill が見つからない場合：

# Verify Git version
git --version  # Must be 2.49+

# Update Git
brew upgrade git  # macOS
apt update && apt install git  # Ubuntu

Promisor リモートの問題：

# Reset promisor configuration
git config --unset extensions.partialClone
git config --unset remote.origin.promisor

# Re-enable
git config extensions.partialClone origin
git config remote.origin.promisor true

差分圧縮の効率が悪い場合：

# Force repack with path-walk optimization
git repack -a -d -f --depth=250 --window=250

リソース

• Git 2.49 リリースノート
• Path-Walk API ドキュメント
• 部分クローンのドキュメント