Chart.yaml: البيانات الوصفية والإصدارات

يحتوي كل مخطط على ملف Chart.yaml في جذره. وهو ملف البيانات الوصفية الذي يوضح لـHelm ماهية المخطط وكيفية التعامل معه. 🪪

يشير الحقل apiVersion إلى تنسيق المخطط. تستخدم مخططات Helm 3 الحديثة القيمة v2، التي تدعم التصريح عن التبعيات داخل هذا الملف مباشرةً.

يحدد name طريقة الإشارة إلى المخطط وكيفية ظهوره في المستودع. وينبغي أن يتكون من أحرف صغيرة وشرطات.

تمثل version رقم SemVer الخاص بالمخطط. زِد قيمته كلما تغيرت قوالب المخطط أو قيمه الافتراضية.

يسجل appVersion إصدار البرنامج الذي ينشره المخطط. وهو حقل معلوماتي، ولا يلزم أن يطابق إصدار المخطط.

احرص على التمييز بينهما: تتغير قيمة version عند تغير الحزمة، بينما تتغير appVersion عند تغير التطبيق الأساسي.

يمثل description الاختياري ملخصًا من سطر واحد يعرضه Helm عند سرد المخططات أو البحث عنها.

تكون قيمة type إما application أو library. وتُعد application القيمة الافتراضية والنوع الوحيد الذي يمكنك تثبيته مباشرةً.

يمكنك إضافة keywords وmaintainers وhome URL وicon. وهذا يثري طريقة ظهور المخطط في الفهارس.

في الإصدار v2، تسرد قائمة dependencies المخططات الفرعية التي يحتاج إليها المخطط، مع إصدار ومستودع مصدر لكل منها.

تتيح إدارة الإصدارات بوضوح للمستخدمين تثبيت مخطط معروف والترقية عن قصد. وهي أساس عمليات النشر القابلة لإعادة الإنتاج. 🎯

تأكد من وضوح حقلي الإصدار.

يحتوي Chart.yaml على apiVersion وname وversion وappVersion. يتتبع version إصدار المخطط، بينما يتتبع appVersion إصدار التطبيق الذي يوزّعه. ✅