تثبيت مخطط باستخدام Helm

تُنشَر مخططات QuenchWorks إلى GHCR كأدوات OCI. لا يوجد مستودع Helm لإضافته ولا حساب لإنشائه. تحتاج إلى Helm 3.8 أو أحدث (دعم OCI مفعّل افتراضيًا منذ 3.8.0).

التثبيت

ثبّت مخططًا عبر مرجع OCI الخاص به. استبدل redis بأي مخطط والإصدار المعروض في صفحته:

helm install my-redis oci://ghcr.io/quenchworks/charts/redis

ثبّت إصدار المخطط ليكون الترقية شيئًا تفعله عن قصد لا مفاجأةً:

helm install my-redis oci://ghcr.io/quenchworks/charts/redis --version 0.0.5

الضبط

المصادقة مفعّلة افتراضيًا. يولّد المخطط كلمة مرور داخل Secret عند أول تثبيت. لضبط كلمة المرور الخاصة بك، أو لإنشاء قاعدة بيانات للتطبيق حيثما يدعم المخطط ذلك، مرّر القيم:

helm install my-redis oci://ghcr.io/quenchworks/charts/redis \
  --set auth.password='change-me'

لأي شيء يتجاوز قيمة أو اثنتين، استخدم ملفًا:

helm install my-redis oci://ghcr.io/quenchworks/charts/redis -f my-values.yaml

يأتي كل مخطط مع ملف values.schema.json، فيتحقّق Helm ممّا تمرّره قبل أن يصيّر أي شيء. راجع الضبط لمفاتيح الاستمرارية والموارد والجدولة وسياق الأمان التي يتشاركها كل مخطط.

افحص قبل أن تثبّت

اسحب القيم والبيانات المُصيَّرة دون أن تلمس العنقود:

helm show values oci://ghcr.io/quenchworks/charts/redis --version 0.0.5
helm template my-redis oci://ghcr.io/quenchworks/charts/redis --version 0.0.5

تحقّق قبل أن تثبّت

المخططات أدوات OCI، فيتحقّق منها cosign عبر الوسم بالطريقة نفسها التي يتحقّق بها من صورة:

cosign verify ghcr.io/quenchworks/charts/redis:0.0.5 \
  --certificate-identity-regexp 'https://github.com/quenchworks/.+' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

النتيجة الصالحة تطبع مسار العمل الذي بنى المخطط ومدخل سجلّ Rekor الخاص به. للتحقّق من بناء معيّن بدلًا من الوسم، مرّر بصمة @sha256:.... راجع التحقّق من توقيع والتثبيت بالبصمة الرقمية.

الترقية والتراجع

رقِّ إلى إصدار مخطط أحدث بالمرجع نفسه:

helm upgrade my-redis oci://ghcr.io/quenchworks/charts/redis --version 0.0.6

إن بدا شيء خاطئًا، تراجع إلى المراجعة السابقة:

helm rollback my-redis

إلغاء التثبيت

helm uninstall my-redis

يترك Helm كائنات PersistentVolumeClaims خلفه عن قصد لتبقى بياناتك بعد إعادة التثبيت. احذفها يدويًا إن أردت استرجاع التخزين.

الخطوات التالية

• الضبط: الاستمرارية والموارد والجدولة وسياق الأمان.
• التثبيت بالبصمة الرقمية: شغّل بالضبط ما جرى فحصه وتوقيعه.
• التثبيت في بيئة معزولة: انقل المخططات والصور إلى سجلّ خاص.