OCIイメージをコンテナまたはFirecrackerマイクロVMとして実行可能に
You can now run same OCI images as containers or Firecracker microVMs (github.com)
要約
Pullrunは、同じOCIイメージをコンテナ、FirecrackerマイクロVM、Apple Silicon VM、Kubernetesワークロード、AIエージェントタスクなど、多様な実行ターゲットで動作させる新しいツールです。デーモン不要で、コンテンツアドレス指定のDAGストアとP2Pイメージ配布により、インフラストラクチャの複雑さを解消し、ストレージの効率化とセキュリティ向上を実現します。
全文翻訳
⚡ Pullrunとは?
Pullrunは、同じOCIイメージをコンテナまたはVMとして実行します。コンテンツアドレス指定されたDAG(Directed Acyclic Graph)にレイヤーを保存し(オーバーレイFSなし)、ブロックをピアツーピアで同期し、約14MBのCLIと約6MBのランタイムデーモンとして提供されます。
これが重要な理由: 現代のインフラストラクチャは、Docker(開発用)、containerd(本番用)、Firecracker(分離用)、CRI(Kubernetes用)、MCPエージェント(AI用)など、多くの実行エンジンを使用しています。これらはすべて同じOCIイメージを実行しているにもかかわらず、それぞれ独自のイメージフォーマット、ストレージ、運用モデルを持っています。Pullrunはこれらのレイヤーを1つのランタイムに統合します。
主な差別化要因:
- 同じイメージからコンテナとVMを作成可能 — 別途VMのビルドステップやVMイメージフォーマットは不要です。
- コンテンツアドレス指定されたDAGストア — コンテンツハッシュによる重複排除、ノード間のバイト同一性、ゼロコピーのmmap読み込みを実現します。
- P2Pイメージ配布 — クラスタあたり1回のレジストリプルで済み、残りはLAN速度でピアツーピア同期されます。
- 約14MBのCLI + 約6MBのランタイムデーモン(ストリップ済み) — デフォルトではデーモンは不要です(CLIのみの
pullrun run)。バックグラウンドサービス用のデーモンはオプションです。
その他含まれる機能: Kubernetes CRIシム(ベータ版)、Docker Composeサポート、AIエージェント用MCPサーバー、ポリシーエンジン(Cosign、SBOM、seccomp)、P2P同期レイヤー、AES-256-GCM暗号化シークレット — これらすべてが同じバイナリに含まれています。
# Apple Silicon VM (macOSデフォルト) — 3秒
pullrun run alpine:3.18 --cmd "echo" --cmd "hello pullrun" --attach -t
# FirecrackerマイクロVM (Linux) — 400ミリ秒
pullrun run alpine:3.18 --backend vm --cmd "echo" --cmd "hello pullrun" --attach -t
# コンテナ (Linux) — 400ミリ秒
pullrun run alpine:3.18 --cmd "echo" --cmd "hello pullrun"
# Windows WSL2 — 同じイメージ、同じコマンド、同じストア
pullrun.exe run alpine:3.18 --cmd "echo" --cmd "hello pullrun"
📦 インストール
# 1コマンド、あらゆるプラットフォームで
curl -fsSL https://github.com/pullrun/pullrun/raw/main/install.sh | bash
| プラットフォーム | 提供されるもの |
|---|---|
| macOS | brew tap pullrun/tap && brew install pullrun → ネイティブバイナリ、Xcode不要 |
| Linux | APTパッケージまたは直接ダウンロード、systemdサービス(コンテナにはrunc、VMには/dev/kvmが必要) |
| Windows | pullrun.exe + WSL2自動プロビジョニング、runc + Firecracker |
手動インストールオプション
# macOS (Homebrew — 事前ビルド済み、ビルド依存なし)
brew tap pullrun/tap && brew install pullrun
# ソースから
make build && export PATH="$PWD/bin:$PATH"
# Windows CLIのクロスコンパイル
cd cli/pullrun && GOOS=windows GOARCH=amd64 CGO_ENABLED=0 go build -o pullrun.exe .
🚀 クイックスタート
# ── 任意のOCIイメージをプル ──────────────────────────────────────────
pullrun pull alpine:3.18 # 968ミリ秒 — hack/bench.sh でベンチマークスクリプトを実行
# ── コンテナとして実行 (Linux) ─────────────────────────────────
pullrun run alpine:3.18 --cmd "echo" --cmd "hello pullrun"
# ── マイクロVMとして実行 (macOS/Linux) ─────────────────────────────
pullrun run alpine:3.18 --backend vm --cmd "echo" --cmd "hello" --attach -t
# ── デタッチ可能なインタラクティブシェル ──────────────────────────────
pullrun run alpine:3.18 --tty --attach --cmd /bin/sh
# Ctrl-P Ctrl-Q → デタッチ(ワークロードは実行を継続)
# pullrun exec <id> -t /bin/sh → 再アタッチ
# ── バックグラウンドワークロード ────────────────────────────────────────
pullrun run alpine:3.18 --cmd /bin/sleep --cmd 3600
# ── ビルドとプッシュ (Dockerデーモン不要) ─────────────────────────────
pullrun build ./Dockerfile . -t myapp:latest
pullrun build ./Dockerfile . -t myapp:latest --platform linux/amd64,linux/arm64
pullrun push <root-digest> ghcr.io/myorg/myimg:latest
# ── エアギャップ環境用のエクスポート/インポート ───────────────────────────────
pullrun save <digest> -o myimage.tar
pullrun load -i myimage.tar
# ── Compose (別バイナリ) ────────────────────────────────
pullrun-compose up -f myapp/compose.yml # コンテナ(Linuxではデフォルト)
pullrun-compose up -f myapp/compose.yml --backend vm # 同じComposeでVM分離
pullrun-compose logs -f
pullrun-compose down
# ── ライフサイクル ──────────────────────────────────────────────────
pullrun list # すべてのワークロード(保留中/実行中/終了済み)
pullrun stop <id>
pullrun exec <id> /bin/echo hello
# デタッチされたワークロードへの再アタッチ(新しいPTYを割り当てます)
pullrun exec <id> -t -- /bin/sh
# または、新しいシェルなしで双方向I/Oストリーミングの場合:
pullrun workload run <id>
# ── イメージ管理 ──────────────────────────────────────────
pullrun images # ローカルDAGストア内のプル済みイメージ一覧
pullrun rmi alpine:3.18 # イメージを削除、到達不能なレイヤーを連鎖削除
pullrun rmi sha256:abc... # ダイジェストでも機能します
# ── GC (DAGストアのガベージコレクション) ─────────────────────────────
pullrun gc # ドライラン — 削除されるものをレポート
pullrun gc --apply # 実際に到達不能ノードを削除
pullrun gc --apply --force # 90%の安全ガードをバイパス
# ── イベントと統計情報 ─────────────────────────────────────────────
pullrun events --types=WORKLOAD_STARTED,POLICY_DENIED
pullrun stats <id>
# ── ネットワーク ────────────────────────────────────────────────────
pullrun network create my-net --subnet 10.43.1.0/24
pullrun run alpine:3.18 --net bridge
# ── シークレット ────────────────────────────────────────────────────
pullrun secret create db_password - # 標準入力から
pullrun run myapp:latest --secret db_password
# ── 設定 ────────────────────────────────────────────────────
pullrun config create nginx.conf ./nginx.conf # ファイルから
pullrun config create nginx.conf - # 標準入力から
pullrun run nginx:latest --config nginx.conf
# ── Diff & Inspect ─────────────────────────────────────────────
pullrun diff <id>
pullrun inspect <id>
pullrun commit <id> myapp:snapshot
# ── ログイン ──────────────────────────────────────────────────────
pullrun login ghcr.io
pullrun logout
# ── MCP (AIエージェント) ────────────────────────────────────────────
pullrun mcp # stdioモード(opencode、Claude Code用)
pullrun mcp --sse :8080 # SSEモード(リモートエージェント用)
🎯 なぜPullrunなのか?
🏗️ アーキテクチャこそ全て
Dockerのoverlayfsストアはファイルシステムオーバーレイであり、overlayfsの脆弱性(CVE-2023-0386、CVE-2023-32629)により、コンテナがホストにエスケープする可能性があります。Pullrunのコンテンツアドレス指定されたDAGストアは、レイヤーをそのままコンテンツハッシュで検証して保存します。オーバーレイFSはなく、エスケープの心配もありません。
Pullrunは、ストレージバックエンドに関係なく、すべてのコンテナに影響を与える共有カーネルのクロスコンテナリスク(例: CVE-2026-31431 "Copy Fail"のようなカーネルページキャッシュのバグ)も軽減します。VMごとのカーネル分離(Firecracker、Apple Virtualization)は、これらを完全に封じ込めます。DAGストアにより、VMパスはゼロコストになります。同じイメージで、VMのビルドステップは不要です。
Pullrunはデフォルトでrootlessです — sudoは不要で、TCPソケットでリッスンするデーモンもなく、中央のdockerdからの攻撃対象領域もありません。
🔥 同じイメージからコンテナとVMを生成できる唯一のランタイム
| バックエンド | 分離レベル | Pullrun | Docker | Podman |
|---|---|---|---|---|
| Linuxコンテナ (runc) | プロセス | ✅ | ✅ | ✅ |
| FirecrackerマイクロVM | VMごとカーネル | ✅ | ❌ | ❌ |
| Apple Silicon VM | VMごとカーネル | ✅ | ❌ | ❌ |
| Windows WSL2コンテナ | プロセス | ✅ | ✅ | ❌ |
| Windows Firecracker VM | VMごとカーネル | ✅ | ❌ | ❌ |
同じイメージで、あらゆる分離レベルに対応。 VMイメージのビルドステップは不要です。OCIマニフェストがVMのルートFSとなります。
🧬 コンテンツアドレス指定されたDAGストア
Pullrunのストアはrkyvとmmap上に構築されています。OCIレイヤーは一度だけ保存され、コンテンツハッシュで重複排除され、直接mmap()されます — tar展開、オーバーレイFS、データ所有権を持つdockerdプロセスは不要です。
sha256:ダイジェストはグローバルに一貫しています。alpine:3.18をプルしたすべてのノードは、ディスク上にバイト同一のファイルを保存します。これにより、P2P同期が容易になります。ブロックはコンテンツハッシュで検証され、差分のみ転送され、クラスタ全体で重複排除されます。
📊 数字で見る
| メトリック | Pullrun | Docker |
|---|---|---|
最初のalpine:3.18プル | 968ミリ秒 | 約2秒 |
| コンテナ実行レイテンシ | 約400ミリ秒 | 約800ミリ秒 |
| Apple Virt VM起動 | 約160ミリ秒 | N/A |
| Firecracker VMコールドブート | 約500ミリ秒 | N/A |
| Firecracker VMウォームプール | 約200ミリ秒 | N/A |
| アイドルデーモンRSS | 24.6 MiB | 約90 MiB |
| バイナリサイズ(ストリップ済み) | 約20MB (CLI + ランタイム) | 約75MB |
| デフォルトrootless | ✅ | ❌ (dockerdはrootで実行) |
| 中央デーモン | オプション | 必須 |
ベンチマーク: シングルノード、コールドキャッシュ、Apple M3(macOS 16)上でのalpine:3.18(Pullrun vs Docker Desktop 4.27)。コンテナ実行レイテンシはrunコマンド終了からワークロードPID生存までの時間で測定。Apple VM起動はインタラクティブなexecプロンプトまでの時間で測定。Firecracker測定はLinux x86_64でKVMを使用。ウォームプールは--vm-warm-pool-size 4で設定。PullrunデーモンRSSはpullrun pull alpine:3.18 + pullrun run alpine:3.18 --tty --attach --cmd /bin/sh実行後、デタッチした状態で測定。Docker RSSはdocker run -d --name idle alpine:3.18 sleep 3600で測定。
hyperfine(10回以上のイテレーション、平均±標準偏差を報告)でベンチマーク。ベンチマークスクリプトはhack/bench.shにあります — ご自身で実行して数値を再現してください。
✨ 機能
🏃 ワークロードライフサイクル
pull, run, stop, exec, attach, list, logs, stats, events, inspect, prune, rmi, gc に加えて:
commit— 実行中のコンテナの現在のファイルシステムから新しいイメージレイヤーを作成します。DAGストアは元のイメージとの差分を計算し、コンテンツアドレス指定されたレイヤーを生成します。diff— 実行中のワークロードとその元のイメージとの間のファイルレベルの変更を表示します。ストアはDAGツリーを比較して、追加/変更/削除のリストを生成します。update— ワークロードを再起動せずに、ライブでリソース制限(CPUミリコア、メモリバイト)を変更します。cp— ホストとワークロードパス間の双方向ファイルコピー。save/load— エアギャップ環境用のOCI互換単一ファイルtarballエクスポート/インポート。再インポートすると同一のコンテンツハッシュが生成されます。login/logout— プライベートOCIレジストリ用のベアラートークン認証。
🔧 ビルド
コンテンツアドレス指定されたレイヤーキャッシュ(命令ハッシュによる)を備えたネイティブDockerfileビルダー(FROM, RUN, COPY, ADD, WORKDIR, ENV, CMD, ENTRYPOINT)。RUNにはDockerデーモンなしでruncを直接使用します。 --platform linux/amd64,linux/arm64によるマルチプラットフォームビルド。
🏗️ OCIカーネルイメージ
カーネルバイナリはファーストクラスのOCIコンテンツです。pullrun kernel installは、OCIレジストリからvmlinuxをDAGストアにダウンロードします。--kernel-imageフラグを使用すると、任意のワークロードがカスタムカーネルをOCI参照で指定できます — 同じストアベース、コンテンツアドレス指定されたパイプライン:ダイジェストで検証され、永続的にキャッシュされ、任意のレジストリにプッシュ可能です。
🐳 Compose
完全なDocker Compose互換ワークフロー:up, down, logs, ps, build。依存関係の順序付け(トポロジカルソート)、ポートマッピング、環境変数、ボリューム(バインドマウント)、リソース制限(CPU/メモリ)、ラベル、および分離用のプロジェクトごとのブリッジネットワークをサポートします。compose-spec/compose-goライブラリを介して標準のdocker-compose.ymlファイルを解析します。
各サービスはコンテナまたはVMとして実行できます — --backend vmを使用して、同じComposeファイルからすべてのサービスをFirecrackerマイクロVMとして起動できます。変更は不要です。
☸ Kubernetes CRI
cri/pullrun-cri/にドロップインCRIシムがあり、Kubernetes CRI APIのRuntimeServiceとImageServiceを実装しています。Podサンドボックスをpullrunワークロードにマッピングし、RuntimeClass(pullrun-container / pullrun-vm)、イメージ/CPU/メモリオーバーライド用のPodアノテーション、およびストリーミング(exec、attach、port-forward)をサポートします。
control-plane/にはネイティブのコントロールプレーンスタブがあります:pullrun-controller(スケジューラ)+ pullrun-agent(ノードごとのデプロイ担当)がgRPCで通信します。これはetcd、.pullrun.local DNS、アドミッションコントロールを計画中のv1 WIPですが、ワイヤープロトコルは今日でも安定しています。
🤖 MCP AI統合
ネイティブのModel Context Protocolサーバーが、15のランタイム操作をMCPツールとして公開します — run, stop, exec, list, get, inspect, logs, stats, pull_image, list_images, build, push, prune, compose_up, compose_down に加えてMCPリソース(pullrun://workload/{id}, pullrun://workload/{id}/logs, pullrun://store/info, pullrun://images)。stdioモード(opencode、Claude Code、Cursor用)またはSSEモード(HTTP経由のリモートエージェント用)で動作します。
🔐 ポリシーエンジン
ワークロードを実行前にゲートします — 以下を組み込みサポート:
- Cosign署名検証(Ed25519キーペア、キーIDマッチング)
- SBOM評価(CVSSスコアリング、ライセンスによる禁止)
- Seccompプロファイル(
defaultで約50のシステムコールを許可、unconfined、またはカスタムJSON) - 読み取り専用ルートFS — ランタイム改ざんを防ぎます(
--volumeマウントにのみ書き込み可能)。 no_new_privileges—setuidおよびcapsetのエスカレーションをブロックします。- ポリシーは宣言的です:
required_signature: true,max_cvss_score: 7.0,deny_licenses: ["GPL-3.0"]
これら4つをすべて組み合わせる:--require-signature --readonly-rootfs --no-new-privileges --seccomp-profile default。
🌐 P2Pイメージ配布
ノードはgRPC + Bloomフィルターを介してイメージブロックをピアツーピアで共有します。1つのノードがレジストリからプルし、残りは互いに差分同期します。機能:mDNS/ディスカバリによるゼロコンフィグのLANピア検索、冗長転送を回避するためのブルームフィルターキャッシュ、ピア状態のためのゴシッププロトコル、差分計算、ピア追跡用のレジストラーサービス。
📡 ネットワーク
IPAM、インバウンド/アウトバウンドポートフォワーディング、DNS解決、iptables統合を備えたユーザー定義ブリッジネットワーク。ワークロードごとに4つのモード(--net経由):isolated(コンテナのデフォルト、10.42.0.1上のホストプロキシによるループバックのみ)、bridge(共有pullrun-br0ブリッジ、ワークロード間通信)、slirp(VMのデフォルト、slirp4netnsによるユーザースペースNAT — ブリッジなし、iptablesなし)、host(ホスト名前空間を共有)、none(ネットワークなし)。分離はワークロードごとのVLANではなく、プロキシによって強制されます。
🗝️ 暗号化されたシークレット
ディスク上ではAES-256-GCMで暗号化され、ランタイム時にワークロードのtmpfsに復号化されます。pullrun secret create/get/ls/inspect/rm — データはディスク上で暗号化されたままですが、ランタイムプロセスのみが復号化できます。
🔄 エクスポート/インポート
エアギャップ環境用の単一ファイルOCI互換tarballエクスポート。再インポートすると同一のコンテンツハッシュが生成されます。
📊 イベントとオブザーバビリティ
pullrun events経由のリアルタイムイベントストリーム — IMAGE_PULLED, WORKLOAD_STARTED, POLICY_DENIEDなど。CPU/メモリを含むワークロードごとのstats。デーモンに組み込まれたPrometheusメトリクスエクスポーター。deploy/内のPrometheusRuleアラート設定。
🧹 DAGストアのガベージコレクションと参照カウント付きrmi
pullrun rmiは、タグまたはダイジェストでイメージを削除し、到達不能なサブツリーノードを即座に連鎖削除します。ノードごとの参照カウント(node.refcountサイドファイル)は共有レイヤーを保持します — 他のイメージによって参照されているレイヤーは、最後の参照イメージが削除されるまで削除されません。デーモン起動時のクラッシュリカバリとしてrecompute_all_refcountsが、すべてのタグ付きイメージとワークロードのルートから参照カウントを再構築します。
pullrun gcは、タグ付きイメージまたは実行中のワークロードから到達不能になったDAGノード(孤立したレイヤー、マニフェスト、ブロブ)を回収します。機能:デフォルトでドライラン(レポートのみ)、--applyで実際に削除、--forceで90%の安全ガードをバイパス、インフライト操作のop-lock保護、kernel_image_digestによるVMカーネルイメージのピン留め。ストアは無限に成長しなくなります。
🖥️ インタラクティブシェル
Ctrl-P Ctrl-Qによるデタッチ/再アタッチ機能を備えた完全なTTYサポート。すべてのバックエンド(コンテナ、Firecracker VM、Apple VM)で動作します。デタッチされたワークロードは実行を継続します — pullrun exec --tty <id> /bin/shで再アタッチします。終了したワークロードでも動作します(デーモンが新しいスリープコンテナを開始します)。
❤️ ヘルスチェックと再起動ポリシー
pullrun run --health-cmd 'curl -f http://localhost:80' — 設定可能な間隔、タイムアウト、リトライ回数を持つ定期的なヘルスチェック。--restart on-failure|always|unless-stoppedは、終了時の自動再起動を制御します。ヘルス状態はpullrun inspectおよびpullrun eventsで表示されます。
🗄️ VM状態の永続化
停止したVMは、ハイバネートされたマシンと同様に動作します — すべての書き込みは保持され、オンデマンドでexecにより再起動されます。バックエンド固有:Apple VirtのルートFSはVirtioFS経由で永続化され、Firecrackerはext4イメージを保持し、コンテナ(runc)のルートFSは一時的です(--volumeマウントのみが生存します)。再プルは不要です。
🔐 プライベートレジストリ
ベアラートークン認証用のpullrun login <registry>。デーモンは、HTTPのみのミラーおよびエアギャップLANキャッシュ用に--insecure-registryを受け入れます。
☸ Kubernetes
Pullrunはcri/pullrun-cri/にCRIシムを提供し、Kubernetes Container Runtime Interfaceを実装しています。Podサンドボックスをpullrunワークロードにマッピングし、以下をサポートします:
RuntimeClass— runcコンテナの場合はpullrun-container、Firecracker VMの場合はpullrun-vm。- Podアノテーション:
pullrun.io/image,pullrun.io/cpu-millicores,pullrun.io/memory-bytes。 - ストリーミング:exec、attach、port-forward。
- DAGストアを介したイメージ管理。
deploy/のマニフェストを使用してDaemonSetとしてデプロイします:
kubectl apply -f deploy/runtime-daemon.yaml
kubectl apply -f deploy/serviceaccount.yaml
kubectl apply -f deploy/servicemonitor.yaml
🤖 MCP AI統合
任意のMCP互換AIエージェント(opencode、Claude Code、Cursor)は、自然言語でPullrunを制御できます:
# MCPサーバーを開始
pullrun mcp
# opencodeまたはClaude Codeで、エージェントは以下を実行できます:
# "alpineをプルしてVMとして実行して"
# "私のアプリにexecしてログを確認して"
# "実行中のワークロードをすべて表示して"
# "プロジェクトからdocker-compose upを実行して"
MCPサーバーは15のツールと4つのリソースタイプを公開します。リモートエージェント用のSSEモード:pullrun mcp --sse :8080。
🌐 P2Pイメージ配布
# ノードA — シード
pullrun-runtime daemon --sync-addr 0.0.0.0:9500
# ノードB — ノードAから差分ブロックをプル
pullrun-runtime daemon --sync-addr 0.0.0.0:9501 \
--sync-peers node-a.example.com:9500
受け入れ前に各ブロックはコンテンツハッシュで検証されます — 信頼は不要です。
🔧 バックエンド比較
| バックエンド | 分離レベル | プラットフォーム | 起動時間 | 最適な用途 |
|---|---|---|---|---|
| 🐧 Linuxコンテナ (runc) | プロセス(名前空間) | Linux, macOS, Windows (WSL2) | 約400ミリ秒 | 開発、CI/CD、高密度パッキング |
| 🔥 FirecrackerマイクロVM | VMごとカーネル (KVM) | Linux x86_64, Windows (WSL2 x86_64) | コールド時約500ミリ秒 / ウォームプール時約200ミリ秒 | マルチテナント、信頼できないワークロード、コンプライアンス、高速リサイクルサンドボックス |
| 🍎 Apple Virtualization | VMごとカーネル (Hypervisor.framework) | macOS Apple Silicon | 約160ミリ秒 | macOS開発、Apple Silicon CI |
🏗️ アーキテクチャ
pullrun (Go CLI)
pull · run · build · compose · inspect
events · stats · network · secret · mcp
│
│ gRPC (UDS or TCP)
▼
┌─────────────────────────────────────┐
│ pullrun-runtime │
│ ┌──────────┐ ┌──────────────────┐ │
│ │ Store │ │ Executor │ │
│ │ (DAG) │ │ runc / VM │ │
│ │ └ rkyv │ │ └ VmPool (warm) │ │
│ │ └ mmap │ │ │ │
│ │ └ DashMap│ │ │ │
│ └────┬─────┘ └──────┬───────┘ │
│ │ │ │
│ ┌────┴────────────────┴────┐ │
│ │ Network │ │
│ │ IPAM · Proxy · DNS │ │
│ └──────────────────────────┘ │
│ │
│ Sync · Policy · Secrets · Metrics │
└──────────────────────────────────────┘
│
┌──────────┴──────────┐
│ Kubernetes │
│ CRI shim · Runtime │
│ Class · Prometheus │
└─────────────────────┘
ストアはロックフリーの同時読み込みのためにDashMap<Digest, Arc<Mmap>>を使用します — 最初のリーダーはmmap()とページフォールトのコストを負担し、それ以降のリーダーは単一のアトミックロードで済みます。Rustワークスペースは11個のクレート(store, oci, exec, vm, net, dns, vsock, sync, policy, runtime, init)で構成され、Go側はCLI、CRIシム、compose、コントロールプレーンスタブです。
📁 プロジェクトレイアウト
proto/ # Protobuf定義(単一の真実の源)
runtime/ # Rustワークスペース — コアデータプレーン
pullrun-store/ # ゼロコピーDAGストア(rkyv + mmap + DashMap同時キャッシュ)
pullrun-oci/ # OCIクライアント + DAGコンバーター
pullrun-exec/ # Executorトレイト + runcラッパー
pullrun-vm/ # Firecracker + Apple Virtバックエンド、ウォームVMプール(pool.rs)、pullrun-initゲストエージェント
pullrun-net/ # IPAM、プロキシ、DNS、iptables、slirp4netns
pullrun-dns/ # ワークロード解決用のインプロセスDNSサーバー
pullrun-vsock/ # VMゲスト-ホスト通信用のVsockトランスポートレイヤー
pullrun-sync/ # P2Pブロック同期(Bloom、mDNS、ゴシップ)
pullrun-policy/ # Cosign、SBOM、seccompゲート
pullrun-runtime/ # gRPCデーモン
cli/pullrun/ # Go CLI (cobra) — 30以上のコマンド
cri/pullrun-cri/ # Kubernetes CRIシム
control-plane/ # マルチノードオーケストレーションスタブ: pullrun-controller + pullrun-agent (v1 WIP)
cmd/pullrun-compose/ # Docker Compose互換CLI
deploy/ # K8sマニフェスト、Prometheusルール、アラート
docs/ # アーキテクチャ、運用、ポリシー、MCP
tools/ # スタンドアロンの煙テストワークスペース(apple-virt-exec、firecracker-smokeなど)
🧪 テスト
247テスト、0失敗 — すべてのコミットは完全なスイート(
cargo fmt --check、cargo test、go test ./...、golangci-lint)によってゲートされています。
| スイート | スタック | 対象 |
|---|---|---|
pullrun-store | 🦀 Rust | DAGストア、rkyvラウンドトリップ、op-locks |
pullrun-runtime | 🦀 Rust | gRPCサービス、イベント、メトリクス、ポリシー統合 |
pullrun-vm | 🦀 Rust | ネットワーク、ext4、OCIカーネル、Apple Virt + Firecracker* |
pullrun-net | 🦀 Rust | IPAM、ファイアウォール、プロキシ、DNS、ループバック |
pullrun-policy | 🦀 Rust | cosign、SBOM、ゲート |
pullrun-oci | 🦀 Rust | dockerfileパーサー、プル、コンバーター、レイアウト |
pullrun-gc | 🦀 Rust | DAGガベージコレクション |
pullrun-sync | 🦀 Rust | P2Pブロック同期、ブルーム、差分 |
pullrun-vsock | 🦀 Rust | vsockトランスポート |
pullrun-exec | 🦀 Rust | seccomp、rootless |
pullrun-init + build-initramfs | 🦀 Rust | ゲストエージェント、initramfs |
pullrun-cri | 🐹 Go | CRIシムライフサイクル、ファイルストア |
pullrun-compose | 🐹 Go | compose解析、up/downフロー |
pullrun CLI | 🐹 Go | ワークロード実行、コマンド |
control-plane | 🐹 Go | コントローラーストア |
| 合計 | 247 |
- Firecrackerハードウェアテスト2件は
#[ignore](/dev/kvmが必要) — 手動で実行:cargo test -p pullrun-vm --test firecracker_boot -- --include-ignored --nocapture
cargo test # Rustワークスペース: 194テスト
go test ./... # Goモジュール (cri, cli, compose, control-plane): 53テスト
cargo fmt --all --check && golangci-lint run ./... # CIゲート
エンドツーエンドのCRI動作(exec stdinストリーミング、終了コード伝播、Podティアダウン)は、ライブcrictlサンドボックスをVM内で検証しています — 完全なライフサイクルチェックリストについては、AGENTS.mdリリースノートを参照してください。
📚 ドキュメント
| ドキュメント | 内容 |
|---|---|
| docs/PULLRUN_GUIDE.md | 全プラットフォーム向け完全ユーザーガイド |
| docs/ARCHITECTURE.md | DAGストア設計、Executorトレイト、ネットワークモデル |
| docs/OPERATIONS.md | デプロイ、監視、トラブルシューティング |
| docs/POLICY.md | ポリシーエンジン(cosign、SBOM、CVSS、ライセンス) |
| docs/WINDOWS.md | Windows/WSL2セットアップ、Firecracker、既知の問題 |
| docs/ALL_MCP.md | MCPサーバーリファレンス(AIエージェント統合) |
| docs/cross-node-dag-sync.md | P2Pブロック同期設計 |
📄 技術レポート
アーキテクチャを説明する技術レポートが/paperで入手可能で、Zenodoにもアーカイブされています:https://doi.org/10.5281/zenodo.20679669
📄 ライセンス
Apache 2.0 — LICENSEを参照。貢献はCLA.mdに従います。
Rust 🦀とGo 🐹で構築