Helm Academy · درس

كائن Values والوصول المتداخل

اقرأ إعدادات المستخدم عميقًا داخل الشجرة

كائن Values والوصول المتداخل درس مجاني في Helm Academy على CoddyKit. هذا هو الدرس 1 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Helm Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Helm Academy 4 دروس في المجموع.

تعرّفوا على كائن Values

داخل القالب، يحتفظ .Values بكل إعدادات values.yaml الخاصة بالمخطط، بالإضافة إلى أي تجاوزات مررتموها. إنه شجرة الإعدادات الخاصة بكم.

قراءة مفتاح من المستوى الأعلى

يصبح مفتاح المستوى الأعلى مثل replicaCount هو .Values.replicaCount. ويطابق مسار النقاط بنية YAML تمامًا. 🌳

# values.yaml
replicaCount: 3

# template
replicas: {{ .Values.replicaCount }}

التعمق في الخرائط المتداخلة

عندما تتداخل القيم، تصلون بينها باستخدام النقاط. ويمكن الوصول إلى خريطة الصورة التي تحتوي على مفتاح tag باستخدام .Values.image.tag، بمقطع واحد لكل مستوى.

# values.yaml
image:
  repository: nginx
  tag: "1.27"

# template
image: {{ .Values.image.repository }}:{{ .Values.image.tag }}

المفاتيح حساسة لحالة الأحرف

يجب أن تطابق مقاطع المسار محارف مفتاح YAML حرفيًا. فـ.Values.Image ليست مثل .Values.image، وستُصيَّر فارغة.

تُصيَّر المفاتيح المفقودة فارغة

لا يُعد طلب قيمة غير موجودة خطأً افتراضيًا. إذ إن Helm لا يصيّر شيئًا، مما قد ينتج YAML غير صالح بصمت.

المفاتيح التي تحتوي على شرطات تحتاج إلى index

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

# values.yaml
service-port: 8080

# template
port: {{ index .Values "service-port" }}

مصدر القيم الافتراضية

يوفر مؤلف المخطط القيم الافتراضية المناسبة في values.yaml. ويتاح كل مفتاح هناك ضمن .Values ما لم يتجاوز المستخدم قيمته.

كيفية وصول التجاوزات إلى .Values

يُدمج خيار --set أو الملف -f الخاص بالمستخدم فوق القيم الافتراضية قبل التصيير. وبحلول وقت القالب، يكون .Values هو شجرة القيم النهائية المدمجة.

helm install web ./mychart --set replicaCount=5

توجد القوائم ضمن .Values أيضًا

تتحول قائمة YAML إلى slice ضمن .Values. وتستخدمون range للتصيير المتكرر للعناصر بدلًا من قراءتها بمسار نقاط واحد. 🔁

# values.yaml
ports:
  - 80
  - 443

وضع علامات الاقتباس حول القيم بأمان

تُصيَّر الأرقام والقيم المنطقية كما هي، مما قد يفسد YAML. ضعوا سلاسل المستخدمين داخل الدالة quote لتظل نصًا صالحًا.

tag: {{ .Values.image.tag | quote }}

افحصوا الشجرة قبل استخدامها

شغّلوا helm show values على مخطط لطباعة شجرة القيم الكاملة. ويكون شكل الناتج هو البنية الدقيقة التي تخاطبونها باستخدام .Values.

helm show values ./mychart

تحقق سريع

تحتاجون إلى مفتاح قيم باسم service-port يحتوي على شرطة.

مراجعة: شجرة Values

تعلمتم أن .Values هي شجرة الإعدادات المدمجة، ويُشار إليها بمسارات منقوطة مع مراعاة حالة الأحرف، وتُستخدم معها index للمفاتيح غير المعتادة. افحصوها باستخدام helm show values.

الأسئلة الشائعة

هل درس «كائن Values والوصول المتداخل» مجاني؟

نعم — نص درس «كائن Values والوصول المتداخل» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Helm Academy، انتقل إلى CoddyKit PRO. تتضمن دورة Helm Academy 4 دروس في المجموع.

ماذا ستتعلم في «كائن Values والوصول المتداخل»؟

اقرأ إعدادات المستخدم عميقًا داخل الشجرة تتمرن على Helm Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ Helm Academy؟

لا تُشترط خبرة سابقة. Helm Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 1 من أصل 4.

كم من الوقت يستغرق درس «كائن Values والوصول المتداخل»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس Helm Academy هذا؟

نعم. كل درس في Helm Academy يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

← العودة إلى Helm Academy