Helm يملأ chart من values.yaml. Kustomize يصحح YAML يمكنك قراءتها بالفعل. كلاهما ينتج manifests و كلاهما يمكنه تعيين نفس replica count و image tag. هذه الصفحة توضح تلك التغييرات كلا الاتجاهين ثم عندما chart أو overlay أو كلاهما هو المالك الصحيح.
الجواب المختصر
اختر Helm عندما وحدة التسليم هي إصدار: tarball أو artifact OCI أو تاريخ مراجعة و أمر واحد يثبّت أو يعيد تشغيل كل كائن. اختر Kustomize عندما الوحدة هي دليل و كل بيئة هي patch على base. kubectl 1.30 بالفعل يشمل Kustomize، إذًا kubectl apply -k و kubectl diff -k و kubectl kustomize تحتاج بلا تثبيت إضافي.
Helm templates هي Go templates. يمكنه تخطي مستند مع if أو فشل الإنتاج عندما قيمة مفقودة. Kustomize بلا لغة template. كائن اختياري هو ملف مدرج فقط في overlay يحتاجها.
جنبًا إلى جنب
| Helm 3 | Kustomize | |
|---|---|---|
| المدخلات | Chart (Chart.yaml و values.yaml و templates/) |
دليل مع kustomization.yaml |
| كيف البيئات تختلف | ملف values آخر أو --set |
Overlay: images و replicas و patches و namespace |
| تشغيل جاف | helm template أو helm upgrade --dry-run |
kubectl kustomize أو kubectl diff -k |
| تطبيق | helm upgrade --install |
kubectl apply -k |
| التاريخ | مراجعات في Secret في namespace الإطلاق | تاريخ git بالإضافة إلى Deployment rollout history |
| عكس المجموعة الكاملة | helm rollback <release> <revision> |
طبّق commit أقدم |
| عكس Deployment واحد | ممكن لكن الترقية التالية قد تعكسها | kubectl rollout undo |
| مشاركة مع فريق آخر | Chart repo أو OCI registry | انسخ دليل أو أشر إلى base بعيد |
| مدمج في kubectl | لا | نعم (-k / kubectl kustomize) |
kubectl diff -k exits 1 عندما الكائنات الحية تختلف من البناء. ذاك diff وليس ملف ثنائي كسر. حسابها في CI قبل معاملة exit code كفشل.
نفس التغيير كلا الطريقين
الهدف هو ثلاث نسخ API و الوسم 1.4.2.
قيم Helm:
replicaCount: 3
image:
repository: example/api
tag: "1.4.2"
Template يحل فقط ما يتغيّر. required يوقف إنتاج يطبع replica count فارغ خلافه:
spec:
replicas: {{ required "replicaCount is required" .Values.replicaCount }}
template:
spec:
containers:
- name: api
image: "{{ .Values.image.repository }}:{{ .Values.image.tag }}"
helm lint ./chart
helm upgrade --install api ./chart -n demo --create-namespace -f values/prod.yaml --wait --timeout 3m
helm history api -n demo
--wait يحجب حتى Deployment متاح أو --timeout يضرب. --atomic يعيد ترقية فاشلة و ينزّل تثبيت أول فاشل.
Kustomize base يسرد manifests سادة. overlay الإنتاج لا ينسخها:
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
- ../../base
namespace: prod
replicas:
- name: api
count: 3
images:
- name: example/api
newTag: "1.4.2"
patches:
- path: memory.yaml
target:
kind: Deployment
name: api
newTag يحرّر YAML. إنه لا يبني صورة. images.name هو repository بدون الوسم. في الـ patch أدناه container name هو مفتاح الدمج:
apiVersion: apps/v1
kind: Deployment
metadata:
name: api
spec:
template:
spec:
containers:
- name: api
resources:
requests:
memory: 256Mi
limits:
memory: 512Mi
kubectl kustomize overlays/prod
kubectl diff -k overlays/prod
kubectl apply -k overlays/prod
-k هو الراية المدمجة على apply و diff و delete. kubectl kustomize فقط يطبع البناء.
فضّل labels عندما لا تريد rewriting الـ selectors. commonLabels لا يزال يكتب على selectors التي مؤلمة للتغيير لاحقًا.
labels:
- pairs:
app.kubernetes.io/part-of: shop
includeSelectors: false
متى تختار Helm
اختر Helm لـ ingress-nginx أو cert-manager أو أي chart لا تريد fork. ثبّت إصدار. HTTP repositories لا تزال تعمل:
helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx
helm repo update
helm search repo ingress-nginx/ingress-nginx --versions
helm show values ingress-nginx/ingress-nginx
helm show values يطبع المفاتيح التي chart تشرّف. إذا إعداد مفقود الإنتاج لاحقًا patch. لا تفرّع chart لـ حد الذاكرة من سطر واحد.
انشر تطبيقك الخاص كـ artifact OCI. رابط الدفع بلا chart name و بلا إصدار. Helm يقرأ كليهما من tarball. رابط التثبيت يشمل chart name.
helm package ./chart
helm registry login ghcr.io -u myuser
helm push shop-0.1.0.tgz oci://ghcr.io/example/charts
helm upgrade --install shop oci://ghcr.io/example/charts/shop --version 0.1.0 -n demo --create-namespace
helm package يسمّي الملف من Chart.yaml (name بالإضافة إلى version). apiVersion: v2 هو Helm 3 chart API. helm registry login يأخذ مضيف (ghcr.io) وليس رابط مع scheme أو مسار.
استخدم template if عندما مستند موجود فقط في بعض البيئات. احفظ template رقيقة حتى المراجعون قد يرون الـ YAML لا تزال.
متى تختار Kustomize
اختر Kustomize عندما كل بيئة نفس Deployment مع وسم مختلف أو namespace أو replica count. Base تبقى YAML صحيحة. Overlays لا تحلقة. الـ git diff هو cluster diff.
configMapGenerator و secretGenerator تختبر اسم الكائن و إعادة كتابة المراجع في تلك kustomization إذًا data change يلف Pods. ضع generatorOptions.disableNameSuffixHash: true فقط عندما المتصل خارج overlay يحتاج اسم ثابت. أنت ثم تملك rollout.
جرّب overlay على عنقود محمول من kind vs minikube vs k3d قبل أن تشير إلى عنقود مشترك API. app-shaped Compose-to-manifest الانتقال مغطى في Docker Compose vs Kubernetes.
عندما تستخدم كلاهما
مالك واحد. later helm upgrade يكتب فوق الحقل التي صححت مع kubectl. إذا طبّقت YAML مرسومة وأبدًا ثبّت إطلاق helm rollback بلا شيء يستعيد.
أنتج ثم صحّح. هذه شكل العمل من “helm template ثم kustomize”. kubectl apply -k يقرأ دليل وليس pipe إذًا اكتب الإنتاج إلى ملف overlay يسرد:
helm template shop ./chart -n prod -f values/prod.yaml > overlays/prod/all.yaml
kubectl apply -k overlays/prod
عكس بتطبيق all.yaml أقدم أو kubectl rollout undo deployment/api -n prod لـ Deployment فقط. المزيد kubectl الأنماط في kubectl cheat sheet.
ملخّص chart داخل Kustomize. helmCharts يشغّل helm template كـ subprocess. Helm يجب أن يكون على PATH (--helm-command إذا الملف الثنائي اسم شيء آخر). --enable-helm موجود على kubectl kustomize و موجود ليس على kubectl apply إذًا -k أخطاء عندما helmCharts موجود.
helmCharts:
- name: ingress-nginx
repo: https://kubernetes.github.io/ingress-nginx
version: X.Y.Z
releaseName: ingress-nginx
namespace: ingress-nginx
valuesFile: values.yaml
بدّل X.Y.Z بـ إصدار من helm search repo ingress-nginx/ingress-nginx --versions. ثم:
kubectl kustomize --enable-helm overlays/prod | kubectl apply -f -
لا يزال بلا إطلاق Helm. Chart فقط مصدر YAML.
الأسرار
Helm يخزن كل مراجعة في Secret سمّي sh.helm.release.v1.<release>.v<revision> (نوع helm.sh/release.v1) في namespace الإطلاق. الحمل يشمل القيم. أي شخص يستطيع get Secrets هناك يستطيع استعادتهم. التشفير في الراحة هو إعداد etcd وليس علم Helm.
أشر chart في Secret يوجد بالفعل (existingSecret هو مفتاح قيم شائع وليس حقل عام). أنشئه خارج git:
kubectl create secret generic app-secret -n demo --from-literal=POSTGRES_PASSWORD="$POSTGRES_PASSWORD"
secretGenerator literal plaintext في git. kubectl apply -k ينشئ Secret و لا يفكّك أي شيء. فكّك قبل تطبيق إذا احتجت تلك. Exec generators ليست جزء plain -k تشغيل.
helm.sh/resource-policy: keep يخبر helm uninstall اترك ذاك الكائن. إنه لا يخفي أو يشفّر ذاك.
مسار الهجرة
Helm release إلى Kustomize. التقط الإنتاج ثم اجعل الكائنات بحيث uninstall تتركها ثم طبّق الدليل.
helm get manifest api -n demo > base/all.yaml
helm get values api -n demo > values-used.yaml
kubectl -n demo annotate deploy,svc,cm,secret,pvc -l app.kubernetes.io/instance=api helm.sh/resource-policy=keep --overwrite
helm uninstall api -n demo
kubectl apply -k overlays/prod
Helm 3 يضع app.kubernetes.io/instance إلى اسم الإطلاق ما لم chart بدّل labels. إذا نوع واحد بلا مطابقات اسقطها و ضع annotations مجددًا. Uninstall يحذف أي شيء بدون helm.sh/resource-policy: keep. أزل annotation لاحقًا مع trailing dash: kubectl annotate ... helm.sh/resource-policy-.
Kustomize directory إلى Helm release. Diff أولاً. Helm 3.2 و later يرفض الكائنات الموجودة حتى تحمل metadata الملكية.
kubectl kustomize overlays/prod > /tmp/before.yaml
helm template api ./chart -n demo -f values/prod.yaml > /tmp/after.yaml
diff -u /tmp/before.yaml /tmp/after.yaml
عندما الباقي diff فقط labels تقبل اجعل الكائنات و ثبّت:
kubectl -n demo annotate deployment/api svc/api cm/app-config secret/app-secret \
meta.helm.sh/release-name=api meta.helm.sh/release-namespace=demo --overwrite
kubectl -n demo label deployment/api svc/api cm/app-config secret/app-secret \
app.kubernetes.io/managed-by=Helm --overwrite
helm upgrade --install api ./chart -n demo -f values/prod.yaml
كرّر ذاك لكل كائن chart ينتج.
helm rollback api 2 -n demo --wait
أسقط المراجعة للعودة للسابق. kubectl rollout undo deployment/api -n demo فقط تعيد ملف عرض Pod. استخدم helm rollback عندما الزيارة السيئة spanned Ingress و ConfigMap و Deployment معًا.
الأسئلة الشائعة
هل يجب أن أستخدم Helm أم Kustomize؟
استخدم Helm عندما تنشر حزمة مصدرة أو تثبّت chart لشخص آخر. استخدم Kustomize عندما تملك YAML والبيئات تختلف بـ image tag أو replica count أو namespace أو patch صغير. kubectl يشغّل Kustomize بالفعل. Helm هو ملف ثنائي منفصل.
هل يمكنني استخدام Helm و Kustomize معًا؟
نعم إذا واحد فقط منهم يملك apply. أنتج مع helm template و صحّح مع Kustomize و kubectl apply -k النتيجة. أو أنتج chart مع kubectl kustomize --enable-helm و طبّق تلك المخرجات. لا تشغّل helm upgrade على كائنات Kustomize أيضًا تصحيحها. الترقية التالية تضع نسخة chart مرة أخرى.
كيف أعيد تشغيل إطلاق Helm مقابل تطبيق Kustomize؟
helm rollback <release> <revision> يستعيد كل كائن من تلك المراجعة. Kustomize ليس لديها كائن release. طبّق overlay أقدم من git أو شغّل kubectl rollout undo deployment/<name> لـ Deployment واحد. undo لا يعكس Services و ConfigMaps أو أي شيء آخر في overlay.
أين يجب أن تعيش كلمات مرور قاعدة البيانات؟
في Secret أنشئت خارج repo git و مرجعية باسم. Helm ينسخ القيم إلى release Secret في نفس namespace إذًا كلمة مرور في values.yaml قابلة للقراءة من قبل أي شخص يستطيع get Secrets. Kustomize secretGenerator literals plaintext في git. لا أداة واحدة هي secret store.
كيف تم التحقق من هذا الدليل
كُتب يدويًا من الوثائق الرسمية، وأُعيد فحص كل أمر، ثم رُوجع مرة ثانية قبل النشر. آخر مراجعة في .
المصادر الرسمية التي قُرئت لهذا المقال

