com.imgpkg

موقع الكتروني: https://carvel.dev/imgpkg
الركود: #carvel في Kubernetes Slack
المستندات مع مثال لسير العمل وتفاصيل أخرى
التثبيت: احصل على الثنائيات المعدة مسبقًا من صفحة الإصدارات أو اضغط على Homebrew Carvel
Backlog: تعرف على ما نحن عليه.

imgpkg (تنطق: "حزمة الصور") هي أداة تسمح للمستخدمين بتخزين مجموعة من الملفات العشوائية كصورة OCI. إحدى حالات الاستخدام الدافعة هي تخزين تكوين Kubernetes (YAML العادي، وقوالب ytt، وقوالب Helm، وما إلى ذلك) في سجل OCI كصورة.

المفهوم الأساسي لـ imgpkg هو الحزمة، وهي عبارة عن صورة OCI تحتوي على 0+ ملفات عشوائية و0+ مراجع لصور OCI التابعة. باستخدام هذا المفهوم، يستطيع imgpkg نسخ الحزم والصور التابعة لها عبر السجلات (سواء عبر الإنترنت أو دون الاتصال بالإنترنت).

$ imgpkg push -b your-user/app1-config:0.1.1 -f config/
$ imgpkg copy -b your-user/app1-config:0.1.1 --to-repo other-user/app1
$ imgpkg pull -b your-user/app1-config:0.1.1 -o /tmp/app1-config
$ imgpkg tag ls -i your-user/app1-config

سمات:

يسمح بدفع حزمة تحتوي على مجموعة من الملفات، وقائمة من الصور التي تعتمد عليها
يسمح بسحب حزمة واستخراج نفس مجموعة الملفات وقائمة مراجع الصور
يسمح بنسخ حزمة بشكل كثيف (أي صورة الحزمة + جميع الصور المشار إليها) إلى الريبو أو كرة القطران
دعم البيئة ذات الفجوة الهوائية عبر أمر النسخ
يسمح بإدراج علامات الصور المدفوعة
يستخدم نوع وسائط طبقة Docker للعمل مع السجلات الموجودة
يستخدم أذونات الملفات الحتمية والطوابع الزمنية لجعل الصور قابلة للتكرار (نفس الملخص إذا لم يتغير شيء)

انضم إلى المجتمع واجعل Carvel أفضل

Carvel أفضل بسبب المساهمين والمشرفين لدينا. بفضلك يمكننا تقديم برامج رائعة للمجتمع. يرجى الانضمام إلينا خلال اجتماعات المجتمع عبر الإنترنت. يمكن العثور على التفاصيل على موقع كارفيل الخاص بنا.

يمكنك الدردشة معنا على Kubernetes Slack في قناة #carvel ومتابعتنا على Twitter على @carvel_dev.

تحقق من المنظمات التي تستخدم وتساهم في قائمة Carvel: Adopter

تطوير

قم ببناء الكود باستخدام

./hack/build.sh

اختبار

تشغيل كل اختبار باستخدام سجل محلي (يتطلب Docker)

./hack/test-all-local-registry.sh 5000

إذا كنت ترغب في استخدام سجل وكيل لسحب الصور لتجنب تقييد المعدل من dockerhub، فقم بتعيين متغير البيئة DOCKERHUB_PROXY على هذا الوكيل، على سبيل المثال:

 export DOCKERHUB_PROXY= < my-registry.local.sometld/my-dockerhub-proxy > && ./hack/test-all-local-registry.sh 5000

تغييرات كود المصدر

للحفاظ على تحديث وثائق الكود المصدري، يستخدم imgpkg godoc. لتوثيق نوع أو متغير أو ثابت أو دالة أو حزمة، اكتب تعليقًا عاديًا يسبق إعلانه مباشرة والذي يبدأ باسم العنصر الذي يصفه. راجع حزمة التسجيل للحصول على مثال. عند المساهمة بكود مصدر جديد عبر العلاقات العامة، سيضمن GitHub Action linter تضمين godocs في التغييرات.

لعرض المستندات

تثبيت godoc: go install golang.org/x/tools/cmd/godoc@latest
ابدأ تشغيل الخادم: godoc -http=:6060 وقم بزيارة http://localhost:6060/pkg/carvel.dev/imgpkg/ .

يوسع

معلومات إضافية