إمكانات Pack في Helm Chart

يضيف ملفان اختياريان إمكانات Pack إلى Helm Chart. يحدد pack-metadata.yaml المخرجات التي يستطيع Pack توفيرها، ويدير pack-migrations.yaml تغييرات ملف Pack عند ترقية Chart.

يوضع الملفان في جذر Chart بجانب Chart.yaml وvalues.yaml. لا يمنع غيابهما تثبيت Chart باستخدام Pack، وإنما لا تتوفر الميزة المرتبطة بالملف الغائب.

راجع Helm وHelm Chart لبنية Chart القياسية. تغطي هذه الصفحة العقود التي يستهلكها Pack Operator وkubit-cli مباشرة فقط.

يحدد قسم exports في pack-metadata.yaml المعلومات التي يمكن للمستخدم أو أدوات Kubit قراءتها من Pack. من الأمثلة الشائعة إصدار التطبيق وimage النهائي وعنوان الخدمة والقيم التشغيلية.

exports:
  image_repository: '{{ values.image.repository }}'
  image_tag: '{{ values.image.tag }}'
  image: '{{ exports.image_repository }}:{{ exports.image_tag }}'

  app_version:
    value: '{{ exports.image_tag }}'
    metric: true
    status: true

  endpoint:
    value: '{{ metadata.name }}.{{ metadata.namespace }}:{{ values.service.port }}'
    status: true

يمكن أن يكون export قيمة بسيطة أو كائنا يحتوي على value وخيارات إضافية. تُعالج exports بشكل تكراري، ولذلك يمكن لـ export مثل image الرجوع إلى exports أخرى.

تستخدم templates في pack-metadata.yaml صيغة Jinja نفسها المستخدمة في Pack. تتوفر السياقات التالية:

إذا كان value كله تعبير template واحدا، يبقى نوع القيمة محفوظا. وإذا كان التعبير جزءا من نص أكبر، تكون النتيجة نصا. قد يسبب المرجع الدائري بين exports أو المسار غير المعرّف خطأ في المعالجة.

يأخذ كل export قيمته من أحد المصادر التالية:

exports:
  redis_password:
    secretKeyRef:
      name: '{{ metadata.name }}'
      key: redis-password
    sensitive: true
    optional: false

  config_mode:
    configMapKeyRef:
      name: '{{ metadata.name }}-config'
      key: mode

  service_cluster_ip:
    genericRef:
      apiVersion: v1
      kind: Service
      name: '{{ metadata.name }}'
      valueFrom: spec.clusterIP

يحدد valueFrom في genericRef مسار القيمة داخل المورد. يمكن أن يكون اسم المورد والمسار ثابتين أو template. يجب أن تملك هوية التنفيذ صلاحية قراءة المورد الهدف.

مع optional: false، يؤدي غياب المورد أو key إلى فشل معالجة metadata. يعرض kubit pack exports أخطاء exports افتراضيا في ‎__errors__‎.

لا يشفّر sensitive القيمة ولا يخفيها. تعيد صيغتا dict وlist في kubit-cli هذا العلم مع المخرجات، لكن يجب ضبط الوصول إلى Pack وSecret ومخرجات الأمر. لا تحفظ القيم الحساسة في logs أو pipelines أو Git.

kubit pack exports -f redis.pack.yaml \
  --local-chartpath ./redis \
  --output dict

راجع قراءة Pack exports باستخدام kubit-cli لتفاصيل الصيغ.

يحدد pack-migrations.yaml الاختياري التغييرات اللازمة في ملف Pack عند ترقية Chart. تُختار كل migration حسب اسم المستودع واسم Chart وإصدار المصدر، وتحدّث spec.chart.version إلى الهدف ويمكنها تحويل vars أو values.

يقرأ Pack Operator الملف من Chart الهدف. لذلك يجب أن يحتوي Chart الهدف على سلسلة migration كاملة من كل إصدار قديم مدعوم. لا يمنع غياب الملف التثبيت، لكن تغيير بنية القيم بشكل غير متوافق قد يبطل اختيارات Packs القديمة.

راجع migration بين إصدارات Chart للنطاقات وsteps وtags والاختبار.

يختبر الخيار ‎--local-chartpath‎ ملف Chart محليا من دون تغيير المستودع المعرّف في Pack. يتطلب الاختبار ملف Pack حتى توفر metadata وvars وvalues سياق المعالجة الحقيقي.

kubit helm-template -f redis.pack.yaml \
  --local-chartpath ./redis

kubit helm-diff -f redis.pack.yaml \
  --local-chartpath ./redis

kubit pack exports -f redis.pack.yaml \
  --local-chartpath ./redis \
  --output dict

kubit pack migrate -f redis.pack.yaml \
  --local-chartpath ./redis

1. تحقق من مخرجات Helm باستخدام helm-template.
2. قارن تغييرات الموارد مع Helm Release الحالي باستخدام helm-diff.
3. افحص exports والأخطاء وعلامات الحساسية باستخدام pack exports.
4. نفذ pack migrate لكل مسار ترقية مدعوم على نموذج من إصدار قديم.

يقبل helm-upgrade ملف Chart محليا أيضا، لكنه يغير Helm Release مباشرة. لا تستخدمه ضمن الاختبار الأولي قبل قراءة تحذير Helm upgrade المباشر.

1. نفذ helm-template على نماذج Packs.
2. راجع تغييرات الموارد باستخدام helm-diff.
3. اختبر exports البسيطة والتكرارية والاختيارية والحساسة باستخدام pack exports.
4. قيّد الوصول المطلوب لـ secretKeyRef وconfigMapKeyRef وgenericRef.
5. لا تنشر تغييرا في بنية values إلا مع migration متوافقة وبعد تنفيذ قائمة اختبار migration.

• مرجع Pack وملف التعريف
• مفاهيم Helm وبنية Chart
• مرجع أوامر kubit-cli
• الترقية التلقائية في Pack Operator