اقرأ باللغة الإنجليزية

مشاركة عبر

تعرف على المزيد حول تثبيت التطبيقات باستخدام Helm في ⁧خدمة Azure Kubernetes Service⁧⁩.

  • مقالة

Helm أداة تعبئة مفتوحة المصدر تساعدك على تثبيت دورة حياة تطبيقات Kubernetes وإدارتها. على غرار مديري حزم Linux، مثل APT وYum، يمكنك استخدام Helm لإدارة مخططات Kubernetes، وهي حزم من موارد Kubernetes التي تم تكوينها مسبقا.

توضح هذه المقالة كيفية تكوين Helm واستخدامه في مجموعة Kubernetes على خدمة Azure Kubernetes (AKS).

قبل البدء

  • تفترض هذه المقالة أن لديك مجموعة AKS موجودة. إذا كنت بحاجة إلى نظام مجموعة AKS، قم بإنشاء مجموعة باستخدام Azure CLI أو Azure PowerShell أو مدخل Azure.
  • تحتاج مجموعة AKS الخاصة بك إلى ACR متكامل. للحصول على تفاصيل حول إنشاء نظام مجموعة AKS باستخدام ACR متكامل، راجع المصادقة باستخدام Azure Container Registry من Azure Kubernetes Service.
  • تحتاج أيضًا إلى تثبيت Helm CLI، وهو العميل الذي يتم تشغيله على نظام التطوير الخاص بك. فهو يسمح لك ببدء التطبيقات وإيقافها وإدارتها باستخدام Helm. في حال كنت تستخدم Azure Cloud Shell، يكون Helm CLI مثبتًا بالفعل. للحصول على إرشادات التثبيت على النظام الأساسي المحلي، راجع تثبيت Helm.

هام

يهدف Helm إلى التشغيل على عقد Linux. إذا كان لديك عقد Windows Server في نظام المجموعة، يجب التأكد من جدولة Helm pods فقط للتشغيل على عقد Linux. تحتاج أيضًا إلى التأكد من جدولة أي مخططات Helm تقوم بتثبيتها أيضًا للتشغيل على العقد الصحيحة. تستخدم الأوامر الواردة في هذه المقالة محددات العقدة للتأكد من جدولة pods إلى العقد الصحيحة، ولكن ليس كل مخططات Helm قد تعرض محدد عقدة. يمكنك أيضا التفكير في استخدام خيارات أخرى على نظام المجموعة، مثل العيوب.

تحقق من إصدار Helm

  • helm version استخدم الأمر للتحقق من تثبيت Helm 3.

    Console 
    helm version

    يظهر إخراج المثال التالي إصدار Helm 3.0.0 المثبت:

    Output 
    version.BuildInfo{Version:"v3.0.0", GitCommit:"e29ce2a54e96cd02ccfce88bee4f58bb6e2a28b6", GitTreeState:"clean", GoVersion:"go1.13.4"}

تثبيت التطبيق باستخدام Helm v3

إضافة مستودعات Helm

  • أضف مستودع ingress-nginx باستخدام أمر helm repo.

    Console 
    helm repo add ingress-nginx https://kubernetes.github.io/ingress-nginx

البحث عن مخططات helm

  1. ابحث عن مخططات Helm التي تم إنشاؤها مسبقا باستخدام أمر بحث helm.

    Console 
    helm search repo ingress-nginx

    يظهر إخراج المثال التالي بعض مخططات Helm المتوفرة للاستخدام:

    Output 
    NAME                            CHART VERSION   APP VERSION     DESCRIPTION                                       
ingress-nginx/ingress-nginx     4.7.0           1.8.0           Ingress controller for Kubernetes using NGINX a...

  2. قم بتحديث قائمة المخططات باستخدام أمر تحديث helm repo.

    Console 
    helm repo update

    يظهر إخراج المثال التالي تحديث مستودع ناجح:

    Output 
    Hang tight while we grab the latest from your chart repositories...
...Successfully got an update from the "ingress-nginx" chart repository
Update Complete. ⎈ Happy Helming!⎈

استيراد صور مخطط Helm إلى ACR الخاص بك

تستخدم هذه المقالة مخطط Helm لوحدة تحكم دخول NGINX، والذي يعتمد على ثلاث صور للحاوية.

  • استخدم az acr import لاستيراد صور وحدة تحكم دخول NGINX إلى ACR الخاص بك.

    Azure CLI 
    REGISTRY_NAME=<REGISTRY_NAME>
CONTROLLER_REGISTRY=registry.k8s.io
CONTROLLER_IMAGE=ingress-nginx/controller
CONTROLLER_TAG=v1.8.0
PATCH_REGISTRY=registry.k8s.io
PATCH_IMAGE=ingress-nginx/kube-webhook-certgen
PATCH_TAG=v20230407
DEFAULTBACKEND_REGISTRY=registry.k8s.io
DEFAULTBACKEND_IMAGE=defaultbackend-amd64
DEFAULTBACKEND_TAG=1.5

az acr import --name $REGISTRY_NAME --source $CONTROLLER_REGISTRY/$CONTROLLER_IMAGE:$CONTROLLER_TAG --image $CONTROLLER_IMAGE:$CONTROLLER_TAG
az acr import --name $REGISTRY_NAME --source $PATCH_REGISTRY/$PATCH_IMAGE:$PATCH_TAG --image $PATCH_IMAGE:$PATCH_TAG
az acr import --name $REGISTRY_NAME --source $DEFAULTBACKEND_REGISTRY/$DEFAULTBACKEND_IMAGE:$DEFAULTBACKEND_TAG --image $DEFAULTBACKEND_IMAGE:$DEFAULTBACKEND_TAG

    ملاحظة

    إلى جانب استيراد صور الحاويات إلى ACR الخاص بك، يمكنك أيضاً استيراد مخططات Helm إلى ACR الخاص بك. لمزيد من المعلومات، راجع «Push and pull Helm charts» إلى سجل حاويات Azure Container Registry.

تشغيل مخططات Helm

  1. قم بتثبيت مخططات Helm باستخدام أمر تثبيت helm وحدد اسم الإصدار واسم المخطط المراد تثبيته.

    تلميح

    ينشئ المثال التالي مساحة اسم Kubernetes لموارد الدخول التي تحمل اسم ingress-basic وتهدف إلى العمل ضمن مساحة الاسم. حدد مساحة االاسم للبيئة الخاصة بك حسب الحاجة.

    Console 
    ACR_URL=<REGISTRY_URL>

# Create a namespace for your ingress resources
kubectl create namespace ingress-basic

# Use Helm to deploy an NGINX ingress controller
helm install ingress-nginx ingress-nginx/ingress-nginx \
    --version 4.0.13 \
    --namespace ingress-basic \
    --set controller.replicaCount=2 \
    --set controller.nodeSelector."kubernetes\.io/os"=linux \
    --set controller.image.registry=$ACR_URL \
    --set controller.image.image=$CONTROLLER_IMAGE \
    --set controller.image.tag=$CONTROLLER_TAG \
    --set controller.image.digest="" \
    --set controller.admissionWebhooks.patch.nodeSelector."kubernetes\.io/os"=linux \
    --set controller.service.annotations."service\.beta\.kubernetes\.io/azure-load-balancer-health-probe-request-path"=/healthz \
    --set controller.admissionWebhooks.patch.image.registry=$ACR_URL \
    --set controller.admissionWebhooks.patch.image.image=$PATCH_IMAGE \
    --set controller.admissionWebhooks.patch.image.tag=$PATCH_TAG \
    --set defaultBackend.nodeSelector."kubernetes\.io/os"=linux \
    --set defaultBackend.image.registry=$ACR_URL \
    --set defaultBackend.image.image=$DEFAULTBACKEND_IMAGE \
    --set defaultBackend.image.tag=$DEFAULTBACKEND_TAG \
    --set defaultBackend.image.digest=""

    يظهر إخراج المثال المكثف التالي حالة نشر موارد Kubernetes التي تم إنشاؤها بواسطة مخطط Helm:

    Output 
    NAME: nginx-ingress
LAST DEPLOYED: Wed Jul 28 11:35:29 2021
NAMESPACE: ingress-basic
STATUS: deployed
REVISION: 1
TEST SUITE: None
NOTES:
The ingress-nginx controller has been installed.
It may take a few minutes for the LoadBalancer IP to be available.
You can watch the status by running 'kubectl --namespace ingress-basic get services -o wide -w nginx-ingress-ingress-nginx-controller'
...

  2. احصل على EXTERNAL-IP للخدمة kubectl get services الخاصة بك باستخدام الأمر .

    Console 
    kubectl --namespace ingress-basic get services -o wide -w ingress-nginx-ingress-nginx-controller

    يظهر إخراج المثال التالي EXTERNAL-IP لخدمة ingress-nginx-ingress-nginx-controller :

    Output 
    NAME                                     TYPE           CLUSTER-IP    EXTERNAL-IP     PORT(S)                      AGE   SELECTOR
nginx-ingress-ingress-nginx-controller   LoadBalancer   10.0.254.93   <EXTERNAL_IP>   80:30004/TCP,443:30348/TCP   61s   app.kubernetes.io/component=controller,app.kubernetes.io/instance=nginx-ingress,app.kubernetes.io/name=ingress-nginx

إصدارات القائمة

  • احصل على قائمة الإصدارات المثبتة على نظام المجموعة باستخدام helm list الأمر .

    Console 
    helm list --namespace ingress-basic

    يظهر إخراج المثال التالي إصدار ingress-nginx المنشور في الخطوة السابقة:

    Output 
    NAME            NAMESPACE       REVISION        UPDATED                                 STATUS          CHART                   APP VERSION
ingress-nginx   ingress-basic   1               2021-07-28 11:35:29.9623734 -0500 CDT   deployed        ingress-nginx-3.34.0    0.47.0

تنظيف الموارد

يؤدي نشر مخطط Helm إلى إنشاء موارد Kubernetes مثل الحجيرات والنشرات والخدمات.

  • قم بتنظيف الموارد باستخدام الأمر helm uninstall وحدد اسم الإصدار الخاص بك.

    Console 
    helm uninstall --namespace ingress-basic ingress-nginx

    يظهر إخراج المثال التالي أن الإصدار المسمى ingress-nginx قد تم إلغاء تثبيته:

    Output 
    release "nginx-ingress" uninstalled

  • احذف عينة مساحة الاسم بأكملها مع الموارد باستخدام kubectl delete الأمر وحدد اسم مساحة الاسم.

    Console 
    kubectl delete namespace ingress-basic

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

لمزيد من المعلومات حول إدارة عمليات نشر تطبيقات Kubernetes مع Helm، راجع وثائق Helm.

وثائق Helm