Helm / متقدم: التوافق والثقة ودليل التسليم / الدرس 14
هوية أصول OCI وإثبات المنشأ
قيّم توزيع الحزم بهوية أصل دقيقة ومنشأ متحقق ومحتوى مراجع دون الخلط بين البصمة أو التوقيع وسلامة التطبيق.
في هذه الصفحة
أهداف الدرس
- تمييز مسارات المستودعات ونسخ الحزم وهوية المحتوى الثابتة.
- شرح اصطلاحات مراجع OCI وملفات إثبات المنشأ.
- تحديد قرارات الثقة منفصلة عن فحوص السلامة.
افصل الموقع عن الهوية
يخبر موقع المستودع العميل أين يطلب الأصل، وتحدد نسخة الحزمة إصدار التغليف، وتحدد البصمة محتوى دقيقا ضمن تمثيله المعني. تجيب الحقول عن أسئلة مختلفة. لا يثبت اسم سجل مألوف موثوقية الناشر أو الاعتماد المحدد. احتفظ بأرشيف الحزمة المراجع وهويته ودليل اعتماده. والصورة المشار إليها أصل آخر له هويته. يترك تثبيت الحزمة مع اختيار صورة متغير سلوك التطبيق معتمدا على مدخل خارجي متبدل.
اقرأ اصطلاحات OCI
في نموذج OCI الخاص بـHelm 3 هنا يستخدم المرجع المخطط oci، وتقيد تسمية الحزمة ونسختها الدلالية الأسماء والوسوم. تحذف وجهة push اسم الحزمة والوسم لأن Helm يستنتجهما من بيانات الأصل، بينما تتضمن مراجع الاسترجاع اسم الحزمة. المثال الأول مقارنة مراجع مكتوبة بنطاق محجوز، وليس أمر رفع أو سحب ولا يتصل بسجل. ميّز هذه الاصطلاحات عن أمثلة OCI التجريبية الأقدم التي تختلف أوامرها وسلوكها عن توثيق Helm 3 المعتمد.
package: catalog-0.4.0.tgz
package metadata: name=catalog, version=0.4.0
OCI push destination concept: oci://registry.example.test/learning
OCI retrieval reference concept: oci://registry.example.test/learning/catalog
requested version concept: 0.4.0
كل المراجع نص غير قابل للتشغيل بنطاق محجوز. لا تحدث مصادقة سجل أو عملية نقل أو نشر أصل.
افهم دليل سلامة المحتوى
قد تبين مقارنة البصمات تطابق البايتات مع قيمة متوقعة، لكن يجب أن تأتي القيمة المتوقعة من قناة موثوقة. يبصم المثال الثاني نصين عامين صغيرين ويقارن النتيجة دون عرض بصمة حزمة زائفة. يكشف الاختلاف تغير البايتات، ولا يثبت التطابق من اعتمد المحتوى أو خلوه من صلاحيات مفرطة. السلامة مدخل مفيد لمراجعة أوسع. لا تضعف التحقق من النقل أو تقبل بصمة جديدة لمجرد إنجاح الفحص؛ بل افحص اختلاف الهوية والثقة أولا.
import hashlib
approved = hashlib.sha256(b"catalog package A").digest()
received = hashlib.sha256(b"catalog package B").digest()
print(approved == received)
print(hashlib.sha256(b"catalog package A").digest() == approved)
False
True
تكشف False النص العام المختلف وتؤكد True النص المكرر. ليست هذه بصمات حزمة أو OCI manifest أو صورة.
افصل إثبات المنشأ عن الثقة
يربط إثبات منشأ Helm الحزمة ببيانات موقعة في ملف .prov مرافق. يشمل التحقق الأصل والتوقيع وسياسة مفتاح عام موثوق. لا يعد توقيع صحيح رياضيا من هوية غير معتمدة موافقة مؤسسية، وقد ينشر موقع موثوق حزمة خاطئة. وضح تفويض الموقع ودورة حياة المفتاح ومراجعة المحتوى. لا ينفذ الدرس توقيعا أو تصدير مفاتيح أو أمرا للتحقق ولا يصل إلى حلقة مفاتيح. يشرح الدليل المطلوب لمسار المنشأ دون ادعاء أن سطر توقيع معروضا يمثل نتيجة تحقق فعلية.
راجع السلسلة كاملة
قد يجمع الإصدار حزمة أب وتوابع وصورا وملفات مضمنة واعتماديات تشغيل خارجية. اسرد كل مصدر للسلوك أو الإعداد وكيف ثُبت واعتُمد. لا يتحقق توقيع الحزمة تلقائيا من كل حسم لاحق لوسم صورة أو سكربت بعيد تستدعيه حاوية. لا تعتمد على شارة خضراء واحدة. احتفظ في المراجعة المحلية بجرد مدخلات افتراضي وسم الفحوص غير المنفذة. ينبغي أن تستخدم الترقية البايتات المراجعة نفسها بدلا من إعادة البناء من مصدر ضعيف القيود وافتراض التكافؤ.
الأخطاء الشائعة وإصلاحها
إصلاح اختلاف البصمة باستبدال القيمة المتوقعة
- لماذا يحدث؟
- عومل الفحص كعقبة لا كدليل.
- كيف تصلحه؟
- افحص هوية الأصل ومصدره واعتماده قبل قبول البايتات الجديدة.
- كيف تتجنب تكراره؟
- احم جرد الاعتماد بمسار مراجعة موثوق.
افتراض سلامة كل الصور لأن الحزمة موقعة
- لماذا يحدث؟
- مُدد إثبات منشأ التغليف إلى أصول تشغيل غير مرتبطة.
- كيف تصلحه؟
- راجع هويات الصور ودليل الثقة بها مستقلا.
- كيف تتجنب تكراره؟
- احصر كل المدخلات التنفيذية في سلسلة الإصدار.
تضمين الاسم والوسم زائدا في مرجع رفع OCI
- لماذا يحدث؟
- نُسخ نحو الاسترجاع إلى مفهوم وجهة الرفع.
- كيف تصلحه؟
- استخدم اصطلاح الوجهة الموثق لنسخة Helm المختارة.
- كيف تتجنب تكراره؟
- قيد أمثلة التوزيع بالنسخة وميّز الرفع عن الاسترجاع.
اختبر فهمك
1. اعتُمد أرشيف الحزمة لكن وسم الصورة متغير. ما الذي يبقى غير قابل لإعادة الإنتاج؟
اعرض الحل المشروح
قد تتغير بايتات الصورة المختارة لاحقا مع ثبات الحزمة. سجل هوية صورة معتمدة واستخدم واجهة البصمة الموثقة حين تناسب العقد، وأبق دليل سياسة الصورة مستقلا. تشمل قابلية الإعادة كل مدخل ينتج سلوكا لا الحزمة المولدة لمرجع الصورة فقط.
2. نجح التحقق بمفتاح عام غير معروف. هل اعتُمدت الحزمة؟
اعرض الحل المشروح
لا يثبت ذلك وحده الاعتماد. أثبت هل الهوية والمفتاح مفوضان عبر سياسة موثوقة وهل مر محتوى الحزمة الدقيق بالمراجعة المطلوبة. تجيب الصحة التشفيرية وتفويض الموقع وسلامة التطبيق عن أسئلة مختلفة وينبغي تسجيلها كأدلة منفصلة.
أهم ما تعلمته
- للمواقع والنسخ والبصمات وهويات الموقعين معان مختلفة.
- تحتاج الثقة بالأصل هويات معتمدة ومراجعة محتوى عبر سلسلة الإصدار.