HN 日本語サマリー

← 一覧へ戻る
インフラ・DevOps

OCIイメージをコンテナまたはFirecrackerマイクロVMとして実行可能に

You can now run same OCI images as containers or Firecracker microVMs (github.com)

30 pointsby pullrun8 コメント

要約

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
プラットフォーム提供されるもの
macOSbrew tap pullrun/tap && brew install pullrun → ネイティブバイナリ、Xcode不要
LinuxAPTパッケージまたは直接ダウンロード、systemdサービス(コンテナにはrunc、VMには/dev/kvmが必要)
Windowspullrun.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を生成できる唯一のランタイム
バックエンド分離レベルPullrunDockerPodman
Linuxコンテナ (runc)プロセス✅✅✅
FirecrackerマイクロVMVMごとカーネル✅❌❌
Apple Silicon VMVMごとカーネル✅❌❌
Windows WSL2コンテナプロセス✅✅❌
Windows Firecracker VMVMごとカーネル✅❌❌

同じイメージで、あらゆる分離レベルに対応。 VMイメージのビルドステップは不要です。OCIマニフェストがVMのルートFSとなります。

🧬 コンテンツアドレス指定されたDAGストア

Pullrunのストアはrkyvとmmap上に構築されています。OCIレイヤーは一度だけ保存され、コンテンツハッシュで重複排除され、直接mmap()されます — tar展開、オーバーレイFS、データ所有権を持つdockerdプロセスは不要です。

sha256:ダイジェストはグローバルに一貫しています。alpine:3.18をプルしたすべてのノードは、ディスク上にバイト同一のファイルを保存します。これにより、P2P同期が容易になります。ブロックはコンテンツハッシュで検証され、差分のみ転送され、クラスタ全体で重複排除されます。

📊 数字で見る
メトリックPullrunDocker
最初のalpine:3.18プル968ミリ秒約2秒
コンテナ実行レイテンシ約400ミリ秒約800ミリ秒
Apple Virt VM起動約160ミリ秒N/A
Firecracker VMコールドブート約500ミリ秒N/A
Firecracker VMウォームプール約200ミリ秒N/A
アイドルデーモンRSS24.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マイクロVMVMごとカーネル (KVM)Linux x86_64, Windows (WSL2 x86_64)コールド時約500ミリ秒 / ウォームプール時約200ミリ秒マルチテナント、信頼できないワークロード、コンプライアンス、高速リサイクルサンドボックス
🍎 Apple VirtualizationVMごとカーネル (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🦀 RustDAGストア、rkyvラウンドトリップ、op-locks
pullrun-runtime🦀 RustgRPCサービス、イベント、メトリクス、ポリシー統合
pullrun-vm🦀 Rustネットワーク、ext4、OCIカーネル、Apple Virt + Firecracker*
pullrun-net🦀 RustIPAM、ファイアウォール、プロキシ、DNS、ループバック
pullrun-policy🦀 Rustcosign、SBOM、ゲート
pullrun-oci🦀 Rustdockerfileパーサー、プル、コンバーター、レイアウト
pullrun-gc🦀 RustDAGガベージコレクション
pullrun-sync🦀 RustP2Pブロック同期、ブルーム、差分
pullrun-vsock🦀 Rustvsockトランスポート
pullrun-exec🦀 Rustseccomp、rootless
pullrun-init + build-initramfs🦀 Rustゲストエージェント、initramfs
pullrun-cri🐹 GoCRIシムライフサイクル、ファイルストア
pullrun-compose🐹 Gocompose解析、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.mdDAGストア設計、Executorトレイト、ネットワークモデル
docs/OPERATIONS.mdデプロイ、監視、トラブルシューティング
docs/POLICY.mdポリシーエンジン(cosign、SBOM、CVSS、ライセンス)
docs/WINDOWS.mdWindows/WSL2セットアップ、Firecracker、既知の問題
docs/ALL_MCP.mdMCPサーバーリファレンス(AIエージェント統合)
docs/cross-node-dag-sync.mdP2Pブロック同期設計

📄 技術レポート

アーキテクチャを説明する技術レポートが/paperで入手可能で、Zenodoにもアーカイブされています:https://doi.org/10.5281/zenodo.20679669


📄 ライセンス

Apache 2.0 — LICENSEを参照。貢献はCLA.mdに従います。


Rust 🦀とGo 🐹で構築