Rustで開発されたアプリケーションで、コンテナイメージ（Dockerなど）をGitリポジトリへ変換します。各コンテナレイヤーはGitコミットとして表現され、元のイメージの履歴と構造を維持します。

特長

• Dockerイメージを解析し、レイヤー情報を抽出
• 各イメージレイヤーをコミットとして表現するGitリポジトリを作成
• 空のレイヤー（ENV, WORKDIRなど）も空コミットとしてサポート
• メタデータをMarkdown形式で完全抽出
• 様々なコンテナエンジンに対応可能な拡張性の高いアーキテクチャ

ユースケース

レイヤーの差分比較

コンテナの問題をトラブルシュートする際、Gitの強力な差分機能を使って任意の2つのレイヤー間で何が変更されたか正確に特定できます。git diffをコミット間で実行することで、エンジニアはどのファイルが追加・変更・削除されたかを把握でき、各Dockerfile命令の影響や問題のある変更箇所を素早く特定できます。

由来追跡

git blameを利用することで、特定のファイルやコード行がどのレイヤーで導入されたかを素早く特定できます。これは設定ファイルや依存関係の問題を診断する際に特に有用です。各レイヤーを手作業で確認することなく、ファイルの由来や対応するDockerfile命令まで即座に遡ることができます。

ファイルのライフサイクル追跡

OCI2Gitを使うことで、特定のファイルがコンテナイメージの履歴の中でどのように変遷したかを追跡できます。ファイルがいつ作成され、各レイヤーでどのように変更され、最終的に削除されたかどうかまで観察できます。この包括的な視点により、多数のレイヤー間で手作業で変更を追跡することなく、ファイルの変遷を把握できます。

コンテナイメージ内のファイルの履歴（生成・変更・削除）を追跡するには、変換後に以下のGitコマンドを利用できます。

# Full history of a file (including renames)
git log --follow -- /rootfs/my/file/path
First appearance (i.e. creation) - see which layer introduced the file
git log --diff-filter=A -- /rootfs/my/file/path
All changes made to the file (with diffs)
git log -p --follow -- /rootfs/my/file/path
When the file was deleted
git log --diff-filter=D -- /rootfs/my/file/path
Show short commit info (concise layer history)
git log --follow --oneline -- /rootfs/my/file/path

これらのコマンドにより、レイヤーのtarballを手動で抽出・比較する複雑さなしに、任意のファイルのコンテナレイヤー全体の履歴を簡単に追跡できます。

マルチレイヤー分析

時には、連続していない複数のレイヤー間の変更を調べることが最も洞察に富んだ比較をもたらします。OCI2Gitを使えば、Gitの比較ツールを利用して複数のビルドステージにわたるコンポーネントの進化を分析し、隣接するレイヤーだけを見ていると見えないパターンを特定できます。

レイヤーの探索

git checkoutを使用して任意のコミットに移動することで、そのレイヤーの時点でのコンテナファイルシステムを正確に調べることができます。これにより、開発者はイメージ作成プロセスの任意の時点でのファイルやディレクトリの正確な状態を検査でき、デバッグやコンテナの動作検証時に非常に有用なコンテキストを提供します。

マルチイメージ分析

共通の起源を持つ複数のコンテナイメージを扱う場合、OCI2Gitは実際にイメージが分岐したときのみブランチを賢く作成します。これにより、共通の履歴を保持しつつ、単一のリポジトリ内で複数の関連イメージを分析できます。

# Convert first image to create the base repository
oci2git postgres:16.9-alpine3.21 -o alp
Convert second image to the same output folder
oci2git nginx:1.28.0-alpine-slim -o alp

OCI2Gitは、イメージ間の共有レイヤーを自動的に検出し、それらの共通のベースを反映したブランチ構造を作成します。Gitの履歴には以下が表示されます：

• すべての共有レイヤーを含む共通の幹
• イメージが実際に異なる場合にのみ分岐する個別のブランチ
• イメージが共通の祖先を共有する部分と、独自の部分が明確に視覚化される
• 賢い重複処理：まったく同じイメージが二度処理された場合、最終的なメタデータコミットの前にこれを検出し、重複したブランチの作成をスキップ

このアプローチは特に次の点で有用です：

• イメージファミリー分析：異なるバージョン、アーキテクチャ、または構成など、イメージの異なるバリアントが互いにどのように関連しているかを理解する
• ベースイメージの影響：ベースイメージの変更が複数の派生イメージにどのように影響するかを正確に把握する
• 最適化の機会：イメージバリアント間でより良く活用できる共有コンポーネントを特定する

追加のユースケース

• セキュリティ監査：脆弱なパッケージや設定が正確にいつ導入されたかを特定し、特定のビルド指示に遡ることができる。
• イメージ最適化：レイヤー構造を分析して冗長な操作や統合可能な大きなファイルを見つけ、イメージサイズの削減に役立てる。
• 依存関係管理：依存関係がイメージ履歴のどの時点で追加、アップグレード、または削除されたかを監視する。
• ビルドプロセスの改善：レイヤー構成を検証してDockerfileの指示を最適化し、キャッシュ効率とイメージサイズの縮小を図る。
• クロスイメージ比較：複数の関連イメージをGitリポジトリに変換し、Gitの比較ツールを使って差異と共通点を分析する。

インストール

ソースからのインストール

# Clone the repository
git clone https://github.com/virviil/oci2git.git
cd oci2git
Install locally
cargo install --path .

Crates.ioからの入手方法

cargo install oci2git

使用方法

oci2git [OPTIONS] 

引数: 変換するイメージ名（例: 'ubuntu:latest'）またはtarエンジン使用時のtarボールのパス

オプション: -o, --output Gitリポジトリの出力ディレクトリ [デフォルト: ./container_repo] -e, --engine 使用するコンテナエンジン（docker、nerdctl、tar） [デフォルト: docker] -h, --help ヘルプ情報を表示 -V, --version バージョン情報を表示

環境変数: TMPDIR 中間データ処理に使用されるデフォルトの場所を変更するためにこの環境変数を設定します。これはプラットフォーム依存です（例: Unix/macOSではTMPDIR、WindowsではTEMPまたはTMP）。

例

Dockerエンジン使用（デフォルト）:

oci2git -o ./ubuntu-repo ubuntu:latest

すでにダウンロードされたイメージtarballを使用する場合：

oci2git -e tar -o ./ubuntu-repo /path/to/ubuntu-latest.tar

tarエンジンは有効なOCIフォーマットのtarボールを期待しており、これは通常docker saveで作成されます：

# Create a tarball from a local Docker image
docker save -o ubuntu-latest.tar ubuntu:latest
Convert the tarball to a Git repository
oci2git -e tar -o ./ubuntu-repo ubuntu-latest.tar

これにより、./ubuntu-repo に以下を含むGitリポジトリが作成されます：

• Image.md - 画像に関する完全なメタデータをMarkdown形式で記述
• rootfs/ - コンテナからのファイルシステムの内容

Gitの履歴はコンテナのレイヤー履歴を反映します：

• 最初のコミットは完全なメタデータを含む Image.md ファイルのみ
• 以降の各コミットは元のイメージのレイヤーを表す
• コミットメッセージにはDockerfileのコマンドが含まれる

リポジトリ構成

repository/
├── .git/
├── Image.md     # Complete image metadata
└── rootfs/      # Filesystem content from the container

必要条件

• Rust 2021 エディション
• Docker CLI（Docker エンジン対応）
• Git

ライセンス

MIT

[documentation]: https://docs.rs/oci2git/

--- Tranlated By Open Ai Tx | Last indexed: 2025-12-12 ---