Timestamp GIT

← All posts

2026-11-13

Docker ComposeでGitタイムスタンプをセルフホストする

Docker ComposeでGitタイムスタンプをセルフホストする
timestamp git blockchain proof

Docker Compose による Git タイムスタンプのセルフホスト

手動のタイムスタンプ運用は、毎回同じように失敗します。誰かがランブックを書き、別の誰かがそれをスクリプト化し、スクリプトは3週間動き続け、ディスクがいっぱいになるかトークンが失効し、18か月前にリポジトリが特定の状態だったという証拠を弁護士が求めてくるその日まで、誰も気づきません。

アンカリング自体は難しい部分ではありません。難しいのはその周りのパイプラインです。コミットの検出、ハッシュのバッチ処理、再起動をまたいだ状態の維持、レシートの配信、そして何年も後に全体を検証可能に保つこと。まさにそれが、セルフホストの Compose スタックで得られるものなのです。つまり、自動化が自分のネットワーク上で動き、データディレクトリを自分で所有する、再現可能で検査可能なデプロイです。

この記事では、Timestamp GIT をオンプレミスに Docker Compose でデプロイし、GitHub App を一度接続し、自動化された夜間ワーカーにコミットハッシュを Bitcoin へアンカリングさせる手順を順を追って説明します。まず概念的な背景を知りたい場合は、暗号学的先行技術: パテントトロールに対するスタートアップの盾をお読みください。

なぜ Git タイムスタンプをセルフホストするのか?

タイムスタンプのステップを手作業で実行するということは、リポジトリごとに3つの雑務を覚えておくことを意味します。コミットハッシュをスタンプさせること、生成された証明ファイルを収集すること、そしてそれらを耐久性があり監査可能な場所に保存すること。1つでも漏らせばチェーンに穴が空きます。保存のステップを漏らせば、誰も見つけられないレシートができあがります。

セルフホスティングは、別の種類の要件に対応します。

  • データレジデンシー。 コンプライアンスチームは、コミットメタデータがどこで処理されるかを知りたがります。Docker イメージなら、答えは「自分たちのホスト上」です。
  • 制限されたネットワーク。 ベンダーが何を約束しようと、ソースリポジトリへの SaaS の読み取りアクセスを一切(読み取り専用であっても)許可しないチームもあります。
  • エアギャップに近いデプロイ。 イメージは内部ホスト上で実行できます。外部へのアクセスが必要なのは、公開 OpenTimestamps カレンダーへのアンカリングのステップだけです。
  • 運用上の制御。 更新の頻度、バックアップのスケジュール、セットアップウィザードにアクセスできる人を自分で決められます。

Docker Compose が適しているのは、システム全体が2つのコンテナで構成されるからです。アプリケーションと、インメモリのハッシュキューとして使われる Valkey インスタンスです。pull を1回、up -d を1回実行すればインスタンスが起動します。./data ボリュームが再起動をまたいで状態を保持し、更新は docker compose pull && docker compose up -d で行います。

重要なのは、Docker イメージがホスト版製品と同じ自動化であるという点です。GitHub App によるコミット検出、夜間の Bitcoin アンカリング、リポジトリへプッシュバックされる .ots レシート。それが自分のインフラ上で動くだけです。

初回セットアップ: Docker Compose と GitHub App

前提条件

  • Compose プラグイン付きの Docker Engine。
  • 安定した稼働時間と外部インターネットアクセスを持つホスト(公開 OpenTimestamps カレンダー経由の Bitcoin アンカリングに必要)。
  • 対象リポジトリにインストールできる GitHub App、および証明ブランチを書き込める対象リポジトリ(またはシャドウリポジトリ)。
  • インスタンス用のライセンスファイル。

Compose ファイル

クイックスタート用の Docker Compose 構成は次のようになります。

services:
  timestampgit:
    image: rue1401/timestampgit:prod
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/data
    restart: unless-stopped

  valkey:
    image: valkey/valkey:8
    restart: unless-stopped

先に進む前に2点注意があります。./data:/app/data のバインドマウントはインスタンスの永続状態です。キャッシュではなく、重要なデータとして扱ってください。そして restart: unless-stopped は、ここでは通常以上に重要です。真夜中のワーカーは真夜中に生きている必要があります。

スタックを起動します。

docker compose pull
docker compose up -d
docker compose logs -f timestampgit

起動後、アプリケーションは http://localhost:8080 で利用できます。

初回起動

初回起動時には、セットアップウィザードが GitHub App の接続とインスタンスの設定を案内します。クリックして進む前に、権限を計画しておきましょう。

  • スタンダードモード。 GitHub App は監視対象の各リポジトリの HEAD コミットハッシュのみを読み取り、証明を対象リポジトリへ書き込みます。GitHub の権限モデルでは、ソースリポジトリへの少なくとも読み取り専用アクセスと、対象リポジトリへの読み書きアクセスが必要です。
  • エンタープライズ ZK モード。 12行の GitHub Action が自分のインフラ上で実行され、コミットハッシュのみを API へプッシュします。対象リポジトリへの読み書きアクセスが必要で、ソースへの読み取りアクセスは不要です。

2026年に、すでにホスト版の GitHub App ワークフローを標準化しているチームでこれを評価しているなら、セットアップ手順は馴染み深く感じられるでしょう。その方法については GitHub App で Git コミットのタイムスタンプを自動化するをご覧ください。

ライセンス

評価用の期間限定デモライセンスは、Docker License ページのリクエストフォームに名前、会社名、メールアドレス、任意で電話番号を入力して申請できます。期間限定のデモライセンスファイルをダウンロードし、エンタープライズのセットアップ中にアップロードできます。

インスタンスが localhost 以外から到達可能な場合は、TLS 終端のリバースプロキシの背後に置き、ネットワーク層でアクセスを制限してください。セットアップウィザードは管理用の画面です。

自動化パイプライン: コミットから Bitcoin 証明まで

GitHub App が接続されると、パイプラインは自動で動きます。

  1. コミット検出。 GitHub App が新しいコミットの webhook を受信します。あるいはエンタープライズ ZK モードでは、GitHub Action がコミットハッシュを API へプッシュします。
  2. ハッシュキュー。 コミットハッシュは、バッチ処理に使われるインメモリのキーバリューストアである Valkey に入ります。
  3. 真夜中の cron ワーカー。 毎晩、ワーカーが保留中のすべてのハッシュをグループ化し、リポジトリごとにマニフェスト .txt を書き出し、Merkle ツリーを構築し、公開 OTS カレンダーを使って OpenTimestamps 証明を作成し、Merkle ルートを Bitcoin へアンカリングします。
  4. 証明の配信。 マニフェストと .ots レシートファイルは、専用の timestamps ブランチまたはシャドウリポジトリとしてリポジトリへプッシュバックされます。
  5. 確認。 Bitcoin の承認には数時間(通常は約3時間)かかるため、証明の書き込みはバッチ実行の数時間後に完了します。

ゼロ知識の性質はポリシーの宣言ではなく、構造的なものです。処理されるのはコミットハッシュのみです。スタンダードモードでもエンタープライズ ZK モードでも、ソースコードがネットワークの外に出ることはありません。Docker デプロイは、ハッシュ処理のステップも自分の境界の内側へ移すだけです。

Merkle ルートは OpenTimestamps 経由で Bitcoin ブロックにアンカリングされるため、承認されればタイムスタンプは不変になります。ベンダーを含め、あなた自身を含め、どの主体もそれを改変したり偽造したりすることはできません。

監視と障害対応

タイムスタンプのパイプラインは静かに失敗します。コミットハッシュがキューに溜まり、エラーは何も出ず、監査のときにギャップに気づくのです。監視はデプロイの一部と考えてください。

コンテナとキューの健全性。 最も有用なチェックは、既知のリポジトリに対するアプリケーション自身のステータスです。稼働監視をそこに向けましょう。

#!/usr/bin/env bash
set -euo pipefail
BASE="http://localhost:8080"
USER="acme"
REPO="platform"

docker compose ps --status running --quiet timestampgit >/dev/null \
  || { echo "timestampgit container is not running"; exit 1; }

curl -fsS "$BASE/api/statusLast/$USER/$REPO" | jq .

GET /api/statusLast/{user}/{repo} は、最後にアンカリングされた Bitcoin ブロックの情報を返します。そのブロックが進まなくなったら、ワーカーが止まっています。

公開検証バッジ。 監視対象の各リポジトリについて、バッジウィジェットは README に埋め込める Shields.io の markdown を生成します。スニペットは GET /api/badgeLink/{user}/{repo}(認証あり)で提供され、おおよそ次のようになります。

[![Timestamped in Bitcoin](https://img.shields.io/endpoint?url=https://timestampgit.dev/api/statusSummary/acme/platform)](https://timestampgit.dev/status/acme/platform)

誰でもリンクをたどってウェブサイト経由でタイムスタンプを検証できます。プライベートリポジトリの場合、ステータス URL にはサーバーインスタンス固有の暗号化された HMAC が含まれるため、許可されたユーザーだけがステータスを読めます。

監査とレポート。 台帳はオンデマンドではなく、スケジュールで取得しましょう。

curl -fsS -o audit-$(date +%F).csv  "$BASE/api/audit/$USER/$REPO"
curl -fsS -o report-$(date -d yesterday +%F).pdf \
  "$BASE/api/report/$USER/$REPO/$(date -d yesterday +%F)"

これで CSV の監査台帳と日付ごとの PDF 証明書が得られ、法務やコンプライアンスのチームが自分で API を触らずに保管できます。

承認の遅延。 アンカリングは通常約3時間で確定します。遅延は起こります。ワーカーはリトライし、アンカーが承認されると .ots 証明を配信します。短い遅延ではなく、「マニフェストは書かれたが24時間経ってもレシートがない」という条件でアラートを出してください。そうしないと、通常の Bitcoin ブロックのばらつきで自分を呼び出し続けることになります。

バックアップとリストア。 ./data をスケジュールでバックアップし、キューのハッシュをコンテナの再作成後も残したい場合は Valkey の /data ディレクトリに名前付きボリュームをマウントしてください。Valkey は設計上インメモリストアです。失っても失うのは一晩分のバッチであり、既存の証明ではありません。配信済みの証明は timestamps ブランチに存在するからです。

セルフホスト型タイムスタンプのベストプラクティス

  • ホストを専用にする。 ワーカーは真夜中に動き、安定した稼働時間と外部への接続性が必要です。騒がしいビルドファームとホストを共有するのは、バッチの取りこぼしを招く行為です。
  • データボリュームをエフェメラルストレージに置かない。 ./data を永続ディスクにバインドマウントし、バックアップのローテーションに含めましょう。
  • 管理画面を制限する。 ウィザードと認証付き API は、強力な認証を備えた VPN またはリバースプロキシの背後に置いてください。ポート 8080 をパブリックインターネットに公開しないでください。
  • 計画的に更新する。 自分で管理するスケジュールで docker compose pull を実行し、新しい :prod イメージを取得する前に変更履歴を読みましょう。
  • 権限が争点になる場合はエンタープライズ ZK モードを選ぶ。 セキュリティチームがソースリポジトリへの読み取りアクセスを許可しない場合、GitHub Action の方法なら自動化を変えずに要件を満たせます。
  • 監査人向けにプロセスを文書化する。 インスタンスがどこで動き、誰が管理し、バックアップがどう検証され、.ots レシートがどこに保存されるかを書き留めましょう。証明は暗号学的ですが、保管の連鎖にはやはり一段落の説明が必要です。
  • 検証を1件、エンドツーエンドでテストする。 紛争の最中ではなく、必要になる前に、アンカリング済みの日付を1つ選んで検証フローをたどりましょう。法的な枠組みについては、Bitcoin タイムスタンプは証拠として許容されるか? コンプライアンスガイドをご覧ください。

FAQ

ソースコードを Timestamp GIT に公開する必要はありますか? いいえ。Timestamp GIT はコミットハッシュのみを処理します。スタンダードモードでは GitHub App が HEAD コミットハッシュを読み取り、エンタープライズ ZK モードでは GitHub Action が自分のインフラからハッシュのみをプッシュします。ソースコードがネットワークの外に出ることはありません。

Bitcoin の承認が予想より長くかかった場合はどうなりますか? 真夜中の cron ワーカーは、OpenTimestamps 経由で Merkle ルートを Bitcoin へアンカリングします。承認には通常約3時間かかります。承認が遅れた場合、ワーカーはリトライし、承認後に .ots 証明を配信します。

エアギャップ環境で使えますか? はい、Docker イメージはエアギャップ環境で実行できますが、公開 OpenTimestamps カレンダー経由の Bitcoin アンカリングには外部インターネットアクセスが必要です。ネットワークアクセスはそれに応じて設定できます。

タイムスタンプを独立して検証するにはどうすればよいですか? .ots ファイルをダウンロードし、標準の OpenTimestamps 検証ツールで Bitcoin ブロックチェーンに対して検証できます。あるいは、Timestamp GIT が提供する検証ページを使うこともできます。このページはブラウザ内でローカル検証を行うため、何を検証しているかを誰にも見られません。

まとめ

Git タイムスタンプのセルフホスティングは、ベンダーへの不信感の問題ではありません。コンプライアンスチームがすでに受け入れている境界の内側に、自動化された監査可能なパイプラインを置くことです。2つのコンテナ、1つのライセンスファイル、1つの GitHub App。あとは真夜中のワーカーが繰り返しの作業をこなし、あなたは .ots レシートでいっぱいのリポジトリと公開ステータスページを手に入れます。

まず Docker License ページでデモライセンスを申請し、ステージングホストで Compose スタックを起動し、アンカリング済みの1日をエンドツーエンドで検証してください。インフラを省きたい場合は、マネージドの Timestamp GIT GitHub App がセットアップ不要で同じ夜間アンカリングを提供します。後からリポジトリに入るものを変えずにセルフホストへ移行することもできます。

関連記事

EU label: AI-generated content