استخدم التسميات في مجموعة خدمة Azure Kubernetes (AKS)

إذا كان لديك تجمعات عقد متعددة، فقد تحتاج إلى إضافة تسمية أثناء إنشاء تجمع العقدة. تعالج تسميات Kubernetes قواعد الجدولة للعقد. يمكنك إضافة تسميات إلى تجمع عقدة في أي وقت وتطبيقها على جميع العقد في تجمع العقدة.

في هذا الدليل الإرشادي، ستتعلم كيفية استخدام التسميات في نظام مجموعة Azure Kubernetes Service (AKS).

المتطلبات الأساسية

تحتاج إلى الإصدار 2.2.0 من Azure CLI أو تثبيتها وتكوينها لاحقًا. قم بتشغيل az --version للعثور على الإصدار. إذا كنت بحاجة إلى التثبيت أو الترقية، فراجع تثبيت Azure CLI.

إنشاء نظام مجموعة AKS باستخدام تسمية

1. إنشاء نظام مجموعة AKS مع تسمية باستخدام az aks create الأمر وتحديد المعلمة --node-labels لتعيين التسميات الخاصة بك. يجب أن تكون التسميات زوج مفتاح/قيمة وأن يكون لها بناء جملة صالح.

   az aks create \
       --resource-group myResourceGroup \
       --name myAKSCluster \
       --node-count 2 \
       --nodepool-labels dept=IT costcenter=9000 \
       --generate-ssh-keys
   

2. تحقق من تعيين التسميات باستخدام kubectl get nodes --show-labels الأمر .

   kubectl get nodes --show-labels | grep -e "costcenter=9000" -e "dept=IT"
   

إنشاء تجمع عقدة مع تسمية

1. إنشاء تجمع عقدة مع تسمية باستخدام az aks nodepool add الأمر وتحديد اسم للمعلمات --name والتسميات للمعلمة --labels . يجب أن تكون التسميات أيضًا زوج مفتاح/قيمة وأن يكون لها بناء جملة صالح

   ينشئ الأمر المثال التالي تجمع عقدة يسمى labelnp مع تسميات dept=HR و costcenter=5000.

   az aks nodepool add \
       --resource-group myResourceGroup \
       --cluster-name myAKSCluster \
       --name labelnp \
       --node-count 1 \
       --labels dept=HR costcenter=5000 \
       --no-wait
   

   يظهر إخراج المثال التالي من az aks nodepool list الأمر تجمع عقدة labelnp هو Create nodes with the specified nodeLabels:

   [
     {
       ...
       "count": 1,
       ...
       "name": "labelnp",
       "orchestratorVersion": "1.15.7",
       ...
       "provisioningState": "Creating",
       ...
       "nodeLabels":  {
         "costcenter": "5000",
         "dept": "HR"
       },
       ...
     },
    ...
   ]
   

2. تحقق من تعيين التسميات باستخدام kubectl get nodes --show-labels الأمر .

   kubectl get nodes --show-labels | grep -e "costcenter=5000" -e "dept=HR"
   

تحديث التسميات على تجمعات العقد الموجودة

1. تحديث تسمية على تجمع عقدة موجود باستخدام az aks nodepool update الأمر . يؤدي تحديث التسميات على تجمعات العقد الموجودة إلى استبدال التسميات القديمة بالتسميات الجديدة. يجب أن تكون التسميات زوج مفتاح/قيمة وأن يكون لها بناء جملة صالح.

   az aks nodepool update \
       --resource-group myResourceGroup \
       --cluster-name myAKSCluster \
       --name labelnp \
       --labels dept=ACCT costcenter=6000 \
       --no-wait
   

2. تحقق من تعيين التسميات باستخدام kubectl get nodes --show-labels الأمر .

   kubectl get nodes --show-labels | grep -e "costcenter=6000" -e "dept=ACCT"
   

التسميات غير المتوفرة

تسميات النظام المحجوزة

منذ إصدار AKS 2021-08-19، أوقفت AKS القدرة على إجراء تغييرات على التسميات المحجوزة ل AKS. تؤدي محاولة تغيير هذه التسميات إلى ظهور رسالة خطأ.

التسميات التالية هي تسميات محجوزة من AKS. يحدد استخدام العقدة الظاهرية ما إذا كانت هذه التسميات يمكن أن تكون ميزة نظام مدعومة على العقد الظاهرية. لا تتوفر بعض الخصائص التي تغيرها ميزات النظام هذه على العقد الظاهرية لأنها تتطلب تعديل المضيف.

• يتم تضمين نفس الشيء في الأماكن التي لا تختلف فيها القيم المتوقعة للتسميات بين تجمع عقدة قياسي وتجمع عقدة ظاهرية. نظرا لأن جرابات العقدة الظاهرية لا تعرض أي جهاز ظاهري أساسي (VM)، يتم استبدال قيم SKU للجهاز الظاهري بـ SKU Virtual.
• يشير إصدار العقدة الظاهرية إلى الإصدار الحالي من إصدار موصل Kubelet-ACI الظاهري.
• اسم الشبكة الفرعية للعقدة الظاهرية هو اسم الشبكة الفرعية حيث يتم توزيع جرابات العقدة الظاهرية في مثيل حاوية Azure (ACI).
• الشبكة الظاهرية للعقدة الظاهرية هي اسم الشبكة الظاهرية، والتي تحتوي على الشبكة الفرعية حيث يتم توزيع جرابات العقدة الظاهرية على ACI.

البادئات المحجوزة

البادئات التالية هي بادئات AKS المحجوزة ولا يمكن استخدامها لأي عقدة:

• kubernetes.azure.com/
• kubernetes.io/

لمزيد من المعلومات حول البادئات المحجوزة، راجع تسميات Kubernetes المعروفة والتعليقات التوضيحية والملامح.

تسميات مهملة

يتم التخطيط للتسميات التالية للإهمال مع إصدار Kubernetes v1.24. يجب تغيير أي مراجع تسمية إلى البديل الموصى به.

*مهمل حديثا. لمزيد من المعلومات، راجع ملاحظات الإصدار.

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

تعرف على المزيد حول تسميات Kubernetes في وثائق تسميات Kubernetes.