Helm / متوسط: عقود التأليف ودورة الحياة / الدرس 10

الملفات والإعدادات وحدود الأسرار

ضمن إعدادات صغيرة مغلفة بأمان مع الفصل بين القوالب والترميز والتحكم في الوصول وإعادة تحميل التطبيق.

وقت القراءة التقريبي: 4 دقيقةتاريخ مراجعة المحتوى 2026-10-28

في هذه الصفحة

أهداف الدرس

شرح الملفات المتاحة عبر الكائن Files.
تضمين إعداد متعدد الأسطر بإزاحة مقصودة.
فصل تمثيل base64 عن السرية وملكية دورة الحياة.

افهم الوصول إلى ملفات الحزمة

يقرأ الكائن Files الملفات المؤهلة الموجودة ضمن الحزمة. ليس قارئا عاما لنظام الملفات ولا يسحب ملفات المضيف الاعتباطية أثناء التصيير. لا تعد القوالب والملفات المستثناة والملفات خارج حدود التابعة مدخلات Files عادية. ضع أصل إعداد افتراضيا صغيرا تحت مسار مقصود مثل files/catalog.ini ثم تحقق من تضمينه. الوصول ووجود الملف مسألتان مختلفتان؛ فقد ينتج الأصل المفقود أو المستثنى محتوى فارغا وConfigMap يبدو مقبولا. أضف عقدا صريحا للمحتوى ولا تعتمد على الألفة البصرية.

ضمن محتوى متعدد الأسطر

يسمح المؤشر النصي متعدد الأسطر في YAML بأن يصبح الملف قيمة واحدة في ConfigMap.data. يحتفظ |- بفواصل الأسطر داخل المحتوى ويحذف السطر النهائي. وتضبط nindent إزاحة كل سطر تحته. يفترض المقطع الأول ملف إعدادات افتراضية غير سرية ووجود بيانات ConfigMap المحيطة. ما زال التطبيق بحاجة إلى فهم نحو INI المضمن. لا تثبت صحة YAML الخارجية صحة ملف الإعداد الداخلي. حين يهم التنسيقان راجع البايتات المضمنة وعقد التطبيق المستقبل منفصلين.

gotemplate مقطع data في ConfigMap

data:
  catalog.ini: |-
    {{- .Files.Get "files/catalog.ini" | nindent 4 }}

لملف يحتوي mode=demo ثم pageSize=5، ينتمي السطران إلى قيمة نصية واحدة. لم يصير مقطع الحزمة.

عامل tpl كتقييم قالب

تعيد Files.Get المحتوى دون تقييم صيغة قالب مضمنة فيه. تستطيع tpl تقييم نص كقالب بسياق مختار، لكن ذلك يغير حد الثقة؛ فيصبح النص القابل للضبط مدخلا يشبه الشيفرة. لا تطبق tpl تلقائيا على إعداد يتحكم به مستخدم عشوائي. راجع الدوال والكائنات المتاحة وهل يحتاج التطبيق إلى توليد ديناميكي فعلا. في ملف إعداد كتالوج صغير وثابت يكون الإدراج الحرفي أبسط وأسهل للإعادة. وإذا لزم التصيير فوثق الصيغة المقبولة واختبر الفشل عمدا بدلا من مفاجأة المستهلكين بتعبيرات غير موثوقة.

الترميز لا يحقق السرية

تستخدم data في Kubernetes Secret تمثيل base64، وهو لا يشفر القيمة. يرمز المثال الثاني كلمة synthetic ويفكها في الذاكرة بالكامل ليوضح قابلية عكس التمثيل. تعتمد السرية الفعلية على التحكم في الوصول والنقل وحماية التخزين والتعرض في سجلات الإصدار والممارسات التشغيلية. لا تضمن بيانات اعتماد حقيقية في حزمة عامة ولا تطبعها في debug. يستطيع مدخل existingSecret فصل مراجع التطبيق عن إنشاء السر، لكنه لا يمنح الحمل صلاحية قراءته ولا يضمن وجود الكائن في النطاق الهدف.

python ترميز افتراضي قابل للعكس

import base64
text = "synthetic"
encoded = base64.b64encode(text.encode()).decode()
print(encoded)
print(base64.b64decode(encoded).decode())

الناتج المتوقع

c3ludGhldGlj
synthetic

لا يستخدم البرنامج بيانات اعتماد. يعيد الفك الكلمة العامة الأصلية ويوضح لماذا لا يعد الترميز تشفيرا.

صمم عقود التحديث وإعادة التحميل

لا يعني تغير ConfigMap تلقائيا أن كل عملية تقرأ الإعداد الجديد. تُلتقط متغيرات البيئة عند بدء العملية، وللملفات المركبة توقيت تحديث خاص، وقد يخزن التطبيق الإعداد مؤقتا. يمكن لبصمة في قالب Pod تشغيل طرح عند تغير الإعداد المغلف، لكنها لا تتحقق من المحتوى الجديد أو تضمن التوفر وحدها. وضح هل يتوقع العقد إعادة تشغيل أو تحميلا حيا أو إدارة خارجية. أبق الملفات المغلفة صغيرة وراجع حدود تخزين الكائن والإصدار؛ فحزم Helm ليست وسيلة لتوزيع مجموعات بيانات كبيرة أو تطبيقات ثنائية.

الأخطاء الشائعة وإصلاحها

فراغ ملف الإعداد المغلف أثناء التصيير

لماذا يحدث؟: المسار خاطئ أو استُثني الأصل من الحزمة.
كيف تصلحه؟: افحص الحزمة المراجعة وصحح عقد الملف قبل تغيير شيفرة التطبيق.
كيف تتجنب تكراره؟: تحقق من وجود الملف المتوقع ومحتواه الافتراضي غير الفارغ.

اعتبار base64 سرا آمنا للنشر

لماذا يحدث؟: اختلط الترميز بالتشفير والتحكم في الوصول.
كيف تصلحه؟: أزل الاعتماديات الحقيقية واستخدم تصميما لإدارة الأسرار مصرحا به بشكل مستقل.
كيف تتجنب تكراره؟: استخدم قيما افتراضية وراجع مسارات تعرضها في الإصدار وdebug.

تغير الإعداد مع احتفاظ العملية بالقيم القديمة

لماذا يحدث؟: افتقرت الحزمة إلى آلية تحميل أو إعادة تشغيل موثقة.
كيف تصلحه؟: نسق سلوك إعادة التحميل مع استراتيجية تغيير قالب Pod.
كيف تتجنب تكراره؟: أدرج انتقال الإعدادات ضمن معايير قبول التطبيق.

اختبر فهمك

1. تحتوي قيمة في ملف مدرج على {{ .Release.Name }}. هل تقيّمها Files.Get؟

اعرض الحل المشروح

لا، تعيد Files.Get محتوى الملف حرفيا. يتطلب التقييم استدعاء tpl مقصودا بسياق ممرر، وهو يوسع الثقة والتعقيد. اسأل أولا هل يحتاج التطبيق إلى نص ديناميكي. قد يكون الإدراج الحرفي عقدا أوضح وأنسب، خصوصا حين يقدم المستخدم الإعداد أو يجب إعادة إنتاجه بدقة.

2. لماذا يفشل مرجع existingSecret رغم نجاح تصيير الحزمة؟