إنشاء فهرس مستودع باستخدام helm repo index
ولّد index.yaml الذي يحتاجه المستودع
إنشاء فهرس مستودع باستخدام helm repo index درس مجاني في Helm Academy على CoddyKit. هذا هو الدرس 2 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Helm Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Helm Academy 4 دروس في المجموع.
المستودع مجرد ملفات
مستودع Helm التقليدي ليس معقدًا: فهو مجلد يضم أرشيفات .tgz بالإضافة إلى ملف فهرس خاص واحد. وهذا الفهرس هو index.yaml.
أهمية index.yaml
لا يسرد Helm محتويات مجلد عن بُعد، بل ينزّل index.yaml لمعرفة charts والإصدارات الموجودة ومكان جلب كل منها.
إنشاؤه بأمر واحد
وجّهوا helm repo index إلى المجلد الذي يحتوي على charts المُنشأة، فيفحص كل ملفات .tgz وينشئ الفهرس تلقائيًا.
helm repo index ./distمحتويات الفهرس
يسرد index.yaml المُنشأ اسم كل chart وإصداره وdigest الخاص به وعنوان URL للتنزيل. ويستخدم Helm هذه الإدخالات لحل عمليات التثبيت.
entries:
mychart:
- version: 0.2.0
urls:
- mychart-0.2.0.tgzعيّنوا عنوان URL العام
يعيد الخيار --url كتابة رابط التنزيل لكل إدخال ليشير إلى العنوان الذي ستُعرض منه الأرشيفات فعليًا، وليس إلى مسار محلي.
helm repo index ./dist --url https://charts.example.comلكل chart بصمة digest
يسجّل الفهرس قيمة digest باستخدام SHA-256 لكل أرشيف. ويتحقق Helm منها عند التنزيل، فيكتشف أي ملف تالف أو مستبدل.
digest: sha256:9f86d08...دمج charts جديدة
قد يؤدي إنشاء الفهرس من الصفر إلى فقدان السجل السابق. يدمج الخيار --merge الأرشيفات الجديدة في فهرس موجود، مع الحفاظ على إدخالات الإصدارات الأقدم.
helm repo index ./dist --merge ./dist/index.yamlترتيب العمليات
أنشئوا الحزمة أولًا ثم الفهرس دائمًا. فالفهرس لا يرى إلا الأرشيفات الموجودة مسبقًا، ولذلك يجب أن يكون ملف .tgz الجديد موجودًا قبل بدء الفهرسة.
helm package ./mychart -d ./dist
helm repo index ./dist --url https://charts.example.comتتعايش إصدارات متعددة
يمكن لاسم chart واحد أن يضم إدخالات لإصدارات متعددة. ويتيح الاحتفاظ بملفات .tgz القديمة للمستخدمين تثبيت أي إصدار منشور أو الرجوع إليه.
يوضع الفهرس بجانب الأرشيفات
ضعوا index.yaml النهائي في الدليل الذي ستعرضونه. يجلبه Helm من جذر المستودع، ثم يحل عناوين URL الخاصة بـ charts نسبةً إليه.
أعيدوا إنشاء الفهرس عند كل نشر
الفهرس لقطة ثابتة وليس فهرسًا حيًا. عند إضافة chart، يجب إعادة إنشاء index.yaml أو دمجه، وإلا فلن يراه العملاء.
تحقّق سريع
أنشأتم فهرسًا، لكن عناوين التنزيل تشير إلى مسارات محلية. ما الخيار الذي يصلح عناوين URL؟
مراجعة: إنشاء الفهرس
نفّذتم helm repo index لفهرسة أرشيفاتكم، وعيّنتم عنوان URL العام، واستخدمتم --merge للحفاظ على الإصدارات القديمة. وأصبح للمستودع خريطته الآن. 🗂️
الأسئلة الشائعة
هل درس «إنشاء فهرس مستودع باستخدام helm repo index» مجاني؟
نعم — نص درس «إنشاء فهرس مستودع باستخدام helm repo index» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Helm Academy، انتقل إلى CoddyKit PRO. تتضمن دورة Helm Academy 4 دروس في المجموع.
ماذا ستتعلم في «إنشاء فهرس مستودع باستخدام helm repo index»؟
ولّد index.yaml الذي يحتاجه المستودع تتمرن على Helm Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.
هل أحتاج إلى خبرة سابقة لأبدأ Helm Academy؟
لا تُشترط خبرة سابقة. Helm Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 2 من أصل 4.
كم من الوقت يستغرق درس «إنشاء فهرس مستودع باستخدام helm repo index»؟
معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.
هل يمكنني كتابة وتشغيل أكواد في درس Helm Academy هذا؟
نعم. كل درس في Helm Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.
جميع الدروس في هذه الدورة
- تجميع أرشيف Release باستخدام helm package
- إنشاء فهرس مستودع باستخدام helm repo index
- استضافة مستودع Chart
- دفع Charts إلى OCI Registry