एक Rust एप्लिकेशन जो कंटेनर इमेज (Docker, आदि) को Git रिपॉजिटरी में बदलता है। प्रत्येक कंटेनर लेयर को एक Git कमिट के रूप में दर्शाया जाता है, जिससे मूल इमेज का इतिहास और संरचना सुरक्षित रहती है।

विशेषताएँ

• Docker इमेज का विश्लेषण करें और लेयर जानकारी निकालें
• एक Git रिपॉजिटरी बनाएं जिसमें प्रत्येक इमेज लेयर को एक कमिट के रूप में दिखाया गया है
• खाली लेयर (ENV, WORKDIR, आदि) को खाली कमिट के रूप में समर्थन
• पूरी मेटाडेटा को Markdown फॉर्मेट में निकालना
• विभिन्न कंटेनर इंजन के लिए समर्थन हेतु एक्स्टेंसिबल आर्किटेक्चर

उपयोग के मामले

लेयर डिफिंग

जब कंटेनर समस्याओं का निवारण किया जा रहा हो, तो आप Git की शक्तिशाली डिफिंग क्षमताओं का उपयोग करके किसी भी दो लेयर के बीच में ठीक-ठीक क्या बदला, यह पता कर सकते हैं। 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

ये कमांड्स किसी भी फाइल के पूरे इतिहास को कंटेनर लेयरों में ट्रेस करना आसान बनाती हैं, बिना मैन्युअली लेयर टारबॉल्स को निकालने और तुलना करने की जटिलता के।

मल्टी-लेयर विश्लेषण

कभी-कभी सबसे महत्वपूर्ण तुलना तब मिलती है जब आप कई गैर-क्रमागत लेयरों में हुए बदलावों की जांच करते हैं। 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 के तुलना उपकरणों का उपयोग करें।

स्थापना

पैकेज प्रबंधक

#### macOS / Linux (Homebrew)

brew tap virviil/oci2git
brew install oci2git

#### डेबियन / उबुन्टू

नवीनतम रिलीज़ से .deb पैकेज डाउनलोड करें और इंस्टॉल करें:

# For amd64 (x86_64)
wget https://github.com/virviil/oci2git/releases/latest/download/oci2git_VERSION_amd64.deb
sudo dpkg -i oci2git_VERSION_amd64.deb
For arm64
wget https://github.com/virviil/oci2git/releases/latest/download/oci2git_VERSION_arm64.deb
sudo dpkg -i oci2git_VERSION_arm64.deb

#### आर्च लिनक्स (AUR)

# Using yay
yay -S oci2git-bin
Using paru
paru -S oci2git-bin
Manual installation
git clone https://aur.archlinux.org/oci2git-bin.git
cd oci2git-bin
makepkg -si

पूर्व-निर्मित बाइनरी

अपने प्लेटफ़ॉर्म के लिए उपयुक्त बाइनरी नवीनतम रिलीज़ से डाउनलोड करें:

# Linux x86_64
wget https://github.com/virviil/oci2git/releases/latest/download/oci2git-linux-x86_64.tar.gz
tar xzf oci2git-linux-x86_64.tar.gz
sudo mv oci2git-linux-x86_64 /usr/local/bin/oci2git
chmod +x /usr/local/bin/oci2git
macOS (Apple Silicon)
wget https://github.com/virviil/oci2git/releases/latest/download/oci2git-darwin-aarch64.tar.gz
tar xzf oci2git-darwin-aarch64.tar.gz
sudo mv oci2git-darwin-aarch64 /usr/local/bin/oci2git
chmod +x /usr/local/bin/oci2git

क्रेट्स.आईओ से

cargo install oci2git

स्रोत से

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

उपयोग

oci2git [OPTIONS] 

आर्ग्युमेंट्स: कनवर्ट करने के लिए इमेज नाम (जैसे, 'ubuntu:latest') या टार इंजन का उपयोग करते समय टारबॉल का पथ

विकल्प: -o, --output Git रिपोजिटरी के लिए आउटपुट डायरेक्टरी [डिफ़ॉल्ट: ./container_repo] -e, --engine उपयोग करने के लिए कंटेनर इंजन (docker, nerdctl, tar) [डिफ़ॉल्ट: docker] -h, --help मदद जानकारी प्रिंट करें -V, --version संस्करण जानकारी प्रिंट करें

पर्यावरण वेरिएबल्स: TMPDIR मध्यवर्ती डेटा प्रोसेसिंग के लिए डिफ़ॉल्ट स्थान बदलने हेतु इस पर्यावरण वेरिएबल को सेट करें। यह प्लेटफॉर्म-निर्भर है (जैसे, यूनिक्स/macOS पर TMPDIR, विंडोज़ पर TEMP या TMP)।

उदाहरण

डॉकर इंजन (डिफ़ॉल्ट) का उपयोग करते हुए:

oci2git -o ./ubuntu-repo ubuntu:latest

पहले से डाउनलोड की गई इमेज टारबॉल का उपयोग करना:

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

टार इंजन एक वैध OCI फॉर्मेट टारबॉल की अपेक्षा करता है, जिसे आमतौर पर 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

[प्रलेखन]: https://docs.rs/oci2git/

--- Tranlated By Open Ai Tx | Last indexed: 2026-01-30 ---