tpl: تصيير السلاسل من القيم

تتضمن إحدى القيم في values.yaml أحيانًا صيغة قالب. ويتعامل Helm معها افتراضيًا كسلسلة نصية عادية ولا يقيّمها مطلقًا.

تأخذ الدالة tpl سلسلة نصية وسياقًا، ثم تعرض تلك السلسلة كقالب Go في موضع استدعائها.

الوسيط الثاني للدالة tpl هو النطاق المستخدم أثناء العرض. ويتيح تمرير root dot للسلسلة الوصول إلى Values وRelease.

يمكن للمستخدم الآن تخزين سلسلة نصية ديناميكية في values، مثل اسم مضيف يُبنى من اسم الإصدار، ثم توسيعها وقت العرض.

في القالب، مرّروا ذلك الحقل عبر tpl مع سياق الجذر لتحويل العنصر النائب المخزّن إلى قيمة فعلية.

تطبع الإشارة المباشرة الأقواس المعقوفة الخام كنص. أما tpl وحدها فتقيّم التوجيهات المضمّنة داخل السلسلة المخزّنة فعليًا.

يمكنكم أيضًا تمرير محتوى الملفات إلى tpl، مما يتيح لملف إعدادات مضمن تضمين عناصر نائبة خاصة بالإصدار.

لا يلزم أن يكون السياق هو الجذر. مرروا أي dict لكي ترى السلسلة المعروضة المتغيرات التي تختارونها بالضبط.

تتيح المخططات غالبًا إنشاء قوالب لمضيفي ingress أو التعليقات التوضيحية بهذه الطريقة، مع إبقاء الإعدادات المرنة في values بدلًا من القوالب.

إذا احتوت السلسلة المخزنة على خطأ مطبعي، يفشل tpl وقت العرض، لذا اختبروا باستخدام helm template بعد إضافة قيم تحتوي على قوالب.

بما أن المضيف الذي يحتوي على قالب قد يتضمن نقاطًا أو نقطتين، مرروا نتيجة tpl إلى quote حتى تظل قيمة YAML النهائية سلسلة نصية آمنة.

تحقق سريع من سلوك tpl.

تعلمتم أن tpl يقيّم سلاسل القوالب المخزنة في القيم أو الملفات، باستخدام سياق توفرونه مثل النقطة الجذرية. 🎉