リポジトリー

どのようなものか

リポジトリーは、会話ではほぼ常にrepoと略されます。バージョン管理シス
テムがプロジェクトの全記録を保持する場所であり、各ファイルの記録済み
のすべての状態、誰が何のために変更したか、そしてその履歴にたどり着く
ための名前を含みます。編集する作業ファイルは、その一つの見え方にすぎ
ません。リポジトリーは、その背後にあるものすべてです。

Git自身の用語集は、リポジトリーを「参照の集合と、それらの参照から到
達可能なすべてのオブジェクトを含むオブジェクトデータベースを合わせた
もの」と、厳密に定義しています。二つの部分をそれぞれ見てみましょう。
オブジェクトデータベースは内容を保持します。ファイルの各バージョン、
各ディレクトリーの内容一覧、各コミットがオブジェクトとして保存され、
その内容のハッシュを名前にします。Gitの解説書は、これをコンテンツア
ドレス型ファイルシステムと呼んでいます。値からキーを計算するキーバ
リューストアです。同じ内容の二つのファイルは一つのオブジェクトにな
り、どれほど小さな変更でも新しい名前を生みます。参照は、人が履歴を扱
うための仕組みです。ブランチやタグという短い名前が、それぞれ一つのコ
ミットを指し、履歴への入り口を作ります。

普段作業するリポジトリーの多くには、作業ツリーが付いています。エディ
ターで開くファイルはプロジェクトのディレクトリーに置かれ、リポジト
リー自体は、その隣の隠しディレクトリー`.git`にあります。ベアリポジト
リーには、作業ツリーがまったくありません。ディレクトリー名は慣例とし
て`.git`で終わり、履歴だけを保持します。サーバーが保持するのはこの形
式です。そこでは誰もファイルを編集せず、利用者はそこへプッシュし、そ
こからフェッチするためです。Gitの用語集も、公開リポジトリーの提供者
は通常ベア形式を公開すると説明しています。Gitの解説書は、既存のプロ
ジェクトから`git
clone --bare my_project my_project.git`で作る方法を示しています。

クローンには、Gitの設計がよく表れます。クローンは、サーバーにあるほ
ぼすべてのデータを受け取ります。既定では、プロジェクトの全履歴にわた
る、全ファイルの全バージョンを取得します。そのため、各クローンは完全
なリポジトリーとなり、サーバーを失っても代わりになれます。引き継がれ
ないものは少数ですが重要で、Gitの解説書も挙げています。サーバー側の
フックや、それに類する設定は引き継がれません。

よく使われる形態が二つあります。`--depth`を指定してクローンした浅い
リポジトリーは、最近のコミットだけを保持します。用語集は、それより古
い親コミットが「焼き切られている」と表現しており、後からフェッチして
履歴を深くできます。サブモジュールは、別のリポジトリーの中に置かれる
リポジトリーで、独自の履歴を持ち、外側のリポジトリーから特定の一つの
コミットに固定されます。

なぜ重要なのか

リポジトリーはプロジェクトの記憶です。あるコード行がおかしく見えると
き、履歴を調べれば、それがいつ、どのコミットで、どのような説明ととも
に入ったか分かります。ただし、それが役立つかは、書かれたコミットの質
次第です。そのため、履歴を大切にするチームは、コミットメッセージに規
則を定め、善意に任せずフックで強制します。

また、ほとんどのツールが扱う単位でもあります。アクセス権はリポジト
リー単位で付与され、フックはリポジトリー単位で実行され、継続的インテ
グレーションも通常は一つのリポジトリーから始まります。リポジトリーの
境界を決めることは、一回のレビュー、一回の検査、一つの権限が及ぶ範囲
を決めることでもあります。

リポジトリーは、渡されたものを保持します。ファイルを削除するコミット
は新しい状態を追加するだけで、それ以前の状態は、すでに保持しているす
べてのクローンに、そのまま残ります。その永続性こそバージョン管理の目
的であり、両面があります。古いバージョンはいつでも復元できますが、
誤ってコミットしたパスワードも同じです。

さらに、リポジトリーに保持できるものは、アプリケーションのコードに限
りません。インフラストラクチャーの定義、文書、設定も、同じように履
歴、レビューの段階、既知の状態を再構築する手段を得られます。構成がリ
ポジトリーに収められたサーバーは、一度も見たことのない人でも再構築で
きます。

実際の活用例

一人が18か月かけて構築した四つのリポジトリーでは、コミットに共通の基
準を使っています。変更の種類を示す慣例的な接頭辞、スコープ、所定の文
字数未満の件名を使い、絵文字も帰属を記すトレーラーも付けません。作業
に使う各リポジトリーのコミットメッセージ用フックが、違反を拒否しま
す。基準を守るかどうかが、コミットする人ではなく、リポジトリーの性質
になるわけです。その履歴から、何に取り組んだかも分かります。記録され
た2026年7月の実装段階で、最大のリポジトリーの履歴は、機能追加156件、
修正133件、文書128件、保守作業81件、リファクタリング26件、スタイル20
件、性能関連の変更5件、テスト3件でした。ただし、フックが検査するのは
形式までです。内容の品質は検査しません。

自社のインフラストラクチャー、デプロイ済みの公開サービス、その他の構
成要素の設定については、人の頭の中ではなく、リポジトリーに記述するこ
とが要件でした。記録された実装には12,065行のYAMLがあり、19のプレイ
ブックと34のロールに分かれていました。この数値は、その段階を示すもの
で、現在のリポジトリーの規模ではありません。バックアップとメールの自
動化も設定されていますが、運用上の有効化は別の段階です。構成一式はリ
ポジトリーから再現できます。ホストは層別のグループに属し、グループの
変数が、そのホストで実行するロールを宣言します。収束済みのホストは変
更ゼロを報告します。変更には、サーバー上で直接編集するより時間がかか
り、後には収束処理の前に事前検査のプレイも追加されました。

リポジトリーは、注意が他へ向いていた間に入ったものも保持します。別の
会社の作業が、リポジトリーの再編を経ても残っていました。そこには有効
な認証情報を平文で含む作業用ログもあり、リポジトリーの履歴の大半にわ
たり、どの検査にも見つからずツリーに残っていました。どれも実行され
ず、まさにそのために残りました。対策は、リポジトリーの指示の冒頭に、
この会社のインフラストラクチャーだけを扱うというスコープの規則を置
き、削除せず隔離することでした。履歴を読める状態に保ちつつ、秘密情報
スキャナー、ボールトの検査、絵文字の検査は、隔離したファイルも引き続
き読みます。

問題が起きるところ

  * 一度コミットした秘密情報は、削除後も残ります。
次のコミットでファイルを削除しても、前のコミットと、それ以降に作られ
たすべてのクローンに残ります。認証情報は公開されたものとして扱い、ま
ず更新してから、コピーを持つ全員に混乱を起こしてまで履歴を書き換える
価値があるか判断します。

  * チェックアウト中のブランチにプッシュします。
ベア形式ではないリポジトリーで、現在のブランチを更新するプッシュを受
けると、作業ツリーと履歴が食い違います。そのためGitは、既定では
`receive.denyCurrentBranch`によって拒否します。プッシュ先にするリポ
ジトリーは、ベア形式にします。

  * 浅いクローンで、履歴の一部から履歴について答えます。
`--depth`で作ったクローンは最近のコミットだけを保持するため、
`git log`、`git
blame`、最後のタグからバージョンを求めるスクリプトも、その範囲しか見
ません。過去が必要なビルドやリリースのジョブでは、全履歴をフェッチし
ます。

  * ローカルのフックは、次のクローンには届きません。
クライアント側のフックは`.git/hooks`にあり、Gitの解説書も、クローン
ではコピーされないと明記しています。そこでだけ強制する方針は、誰かが
新たにクローンした日に効かなくなります。フックのスクリプトをリポジト
リーで追跡し、`core.hooksPath`でそこを指定するか、サーバー側の
`pre-receive`で規則を強制します。

  * 大きなバイナリーは、すべてのクローンをいつまでも膨らませます。
クローンは全ファイルの全バージョンを保持するため、大きなバイナリーを
差し替えるたびに、古いコピーが履歴に残り、新しいクローンは毎回それら
をすべてダウンロードします。

  * どこからも実行されないファイルは、読まれなくなります。
無効なタスク、古いインベントリー、作業用ログもすべてのクローンに残り
ますが、テスト、ビルド、デプロイのどれも触れないため、レビューから漏
れます。リポジトリーの内容は、そのプロジェクトが責任を負うものに合わ
せ、それ以外は削除するか、検査からは見える場所に分けて置きます。

参考資料

  * gitglossary：リポジトリー —
Git自身による定義です。ベアリポジトリー、作業ツリー、浅いリポジト
リー、サブモジュールの項目も隣にあります。

  * Gitリポジトリーの取得 —
ディレクトリーから新たに始める方法とクローンする方法の二つ、それにク
ローンが何を取得するかを説明します。

  * Gitのオブジェクト — オブジェクトデータベースが、内容のハッシュを
キーにして保存する仕組みです。

  * gitrepository-layout — リポジトリー内の各ファイルやディレクト
リーの役割を説明します。

  * サーバーでのGitの利用 — 既存のリポジトリーをベア形式にして、共有
する方法です。

  * Gitフック — クライアント側とサーバー側のフック、およびクローンが
クライアント側のフックを引き継がない理由を説明します。

hこのページのウェブ版	URL:https://engineer.company/ja/glossary/repository/	engineer.company	70
