ManagedClusterAgentPoolProfileProperties interface

الحزمة:

@azure-rest/arm-containerservice

خصائص ملف تعريف تجمع عامل خدمة الحاوية.

الخصائص

availabilityZones	قائمة مناطق التوفر لاستخدامها للعقد. يمكن تحديد هذا فقط إذا كانت الخاصية AgentPoolType هي "VirtualMachineScaleSets".
capacityReservationGroupID	ستقوم AKS بإقران تجمع الوكلاء المحدد بمجموعة حجز السعة.
count	عدد العوامل (VMs) لاستضافة حاويات docker. يجب أن تكون القيم المسموح بها في نطاق من 0 إلى 1000 (شاملة) لتجمعات المستخدمين وفي نطاق 1 إلى 1000 (شامل) لتجمعات النظام. القيمة الافتراضية هي 1.
creationData	CreateData لاستخدامها لتحديد معرف اللقطة المصدر إذا كان سيتم إنشاء/ترقية تجمع العقدة باستخدام لقطة.
enableAutoScaling	ما إذا كان يجب تمكين أداة التحجيم التلقائي
enableCustomCATrust	عند التعيين إلى true، تقوم AKS بنشر daemonset وخدمات المضيف لمزامنة المراجع المصدقة المخصصة من مخطط التكوين الذي يوفره المستخدم في مخازن ثقة العقدة. الإعدادات الافتراضية للخطأ.
enableEncryptionAtHost	هذا مدعوم فقط على أحجام أجهزة ظاهرية معينة وفي مناطق Azure معينة. لمزيد من المعلومات، راجع: https://docs.microsoft.com/azure/aks/enable-host-encryption
enableFIPS	راجع إضافة تجمع عقدة يدعم FIPS لمزيد من التفاصيل.
enableNodePublicIP	قد تتطلب بعض السيناريوهات عقدا في تجمع عقدة لتلقي عناوين IP العامة المخصصة الخاصة بها. السيناريو الشائع هو أحمال عمل الألعاب، حيث تحتاج وحدة التحكم إلى إجراء اتصال مباشر بجهاز ظاهري سحابي لتقليل القفزات. لمزيد من المعلومات، راجع تعيين IP عام لكل عقدة. الإعداد الافتراضي خطأ.
enableUltraSSD	ما إذا كان يجب تمكين UltraSSD
gpuInstanceProfile	GPUInstanceProfile ليتم استخدامه لتحديد ملف تعريف مثيل GPU MIG ل GPU VM SKU المدعوم.
hostGroupID	هذا هو النموذج: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. لمزيد من المعلومات، راجع مضيفي Azure المخصصين.
kubeletConfig	تكوين Kubelet على عقد تجمع العامل.
kubeletDiskType	تحديد موضع وحدات تخزين emptyDir وجذر بيانات وقت تشغيل الحاوية والتخزين المؤقت Kubelet.
linuxOSConfig	تكوين نظام التشغيل لعقد عامل Linux.
maxCount	الحد الأقصى لعدد العقد للتحجيم التلقائي
maxPods	الحد الأقصى لعدد pods التي يمكن تشغيلها على عقدة.
messageOfTheDay	سلسلة مرمزة ب base64 والتي ستتم كتابتها إلى /etc/motd بعد فك التشفير. يسمح هذا بتخصيص رسالة اليوم لعقد Linux. يجب عدم تحديده لعقد Windows. يجب أن تكون سلسلة ثابتة (أي ستتم طباعة raw ولا يتم تنفيذها كبرنامج نصي).
minCount	الحد الأدنى لعدد العقد للتحجيم التلقائي
mode	يجب أن يحتوي نظام المجموعة على تجمع عامل "نظام" واحد على الأقل في جميع الأوقات. للحصول على معلومات إضافية حول قيود تجمع الوكلاء وأفضل الممارسات، راجع: https://docs.microsoft.com/azure/aks/use-system-pools
nodeLabels	تسميات العقدة التي يجب أن تستمر عبر جميع العقد في تجمع العامل.
nodePublicIPPrefixID	هذا هو النموذج: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
nodeTaints	الملامح المضافة إلى العقد الجديدة أثناء إنشاء تجمع العقدة وتوسيع نطاقها. على سبيل المثال، key=value:NoSchedule.
orchestratorVersion	يتم دعم كل من إصدار التصحيح <> major.minor.patch <major.minor>. عند تحديد <major.minor>، يتم اختيار أحدث إصدار تصحيح مدعوم تلقائيا. لن يؤدي تحديث تجمع الوكلاء بنفس <major.minor> بمجرد إنشائه إلى تشغيل ترقية، حتى إذا كان هناك إصدار تصحيح أحدث متوفر. كأفضل ممارسة، يجب ترقية جميع تجمعات العقد في نظام مجموعة AKS إلى نفس إصدار Kubernetes. يجب أن يكون لإصدار تجمع العقدة نفس الإصدار الرئيسي مثل مستوى التحكم. يجب أن يكون الإصدار الثانوي لتجمع العقدة ضمن إصدارين ثانويين من إصدار وحدة التحكم. لا يمكن أن يكون إصدار تجمع العقدة أكبر من إصدار وحدة التحكم. لمزيد من المعلومات، راجع ترقية تجمع عقدة.
osDiskSizeGB	حجم قرص نظام التشغيل بالجيجابايت الذي سيتم استخدامه لتحديد حجم القرص لكل جهاز في تجمع العامل/الرئيسي. إذا قمت بتحديد 0، تطبيق حجم osDisk الافتراضي وفقا ل vmSize المحدد.
osDiskType	الإعداد الافتراضي هو "سريع الزوال" إذا كان الجهاز الظاهري يدعمه ويحتوي على قرص ذاكرة تخزين مؤقت أكبر من OSDiskSizeGB المطلوب. وإلا، يتم تعيين الإعدادات الافتراضية إلى "مدار". قد لا يتم تغيير بعد الإنشاء. لمزيد من المعلومات، راجع نظام التشغيل المؤقت.
osSKU	يحدد نظام التشغيل SKU المستخدم من قبل تجمع العامل. إذا لم يتم تحديده، يكون الافتراضي هو Ubuntu إذا OSType=Linux أو Windows2019 إذا OSType=Windows. وسيتم تغيير Windows OSSKU الافتراضي إلى Windows2022 بعد إهمال Windows2019.
osType	نوع نظام التشغيل. الافتراضي هو Linux.
podSubnetID	إذا تم حذفها، يتم تعيين عناوين IP الخاصة بالجراب بشكل ثابت على الشبكة الفرعية للعقدة (راجع vnetSubnetID لمزيد من التفاصيل). هذا هو النموذج: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
powerState	عند إنشاء تجمع عامل لأول مرة، يكون قيد التشغيل في البداية. يمكن إيقاف تجمع الوكلاء عن طريق تعيين هذا الحقل إلى متوقف. توقف مجموعة الوكلاء المتوقفة جميع الأجهزة الظاهرية الخاصة بها ولا تتراكم عليها رسوم الفوترة. يمكن إيقاف تجمع عامل فقط إذا كان قيد التشغيل وحالة التوفير ناجحة
proximityPlacementGroupID	معرف مجموعة موضع التقارب.
scaleDownMode	يؤدي هذا أيضا إلى التأثير على سلوك التحجيم التلقائي لنظام المجموعة. إذا لم يتم تحديده، تعيينه افتراضيا إلى حذف.
scaleSetEvictionPolicy	لا يمكن تحديد هذا إلا إذا كان scaleSetPriority هو 'Spot'. إذا لم يتم تحديده، يكون الافتراضي هو "حذف".
scaleSetPriority	أولوية مجموعة مقياس الجهاز الظاهري. إذا لم يتم تحديده، يكون الافتراضي هو "عادي".
spotMaxPrice	القيم المحتملة هي أي قيمة عشرية أكبر من الصفر أو -1 مما يشير إلى الاستعداد لدفع أي سعر عند الطلب. لمزيد من التفاصيل حول التسعير الفوري، راجع تسعير الأجهزة الظاهرية الفورية
tags	العلامات التي سيتم استمرارها على مجموعة مقياس الجهاز الظاهري لتجمع العامل.
type	نوع تجمع الوكلاء.
upgradeSettings	إعدادات ترقية مستودع الوكيل
vmSize	يختلف توفر حجم الجهاز الظاهري حسب المنطقة. إذا كانت العقدة تحتوي على موارد حساب غير كافية (الذاكرة، وحدة المعالجة المركزية، وما إلى ذلك) فقد تفشل الحجيرات في العمل بشكل صحيح. لمزيد من التفاصيل حول أحجام الأجهزة الظاهرية المقيدة، راجع: https://docs.microsoft.com/azure/aks/quotas-skus-regions
vnetSubnetID	إذا لم يتم تحديد ذلك، سيتم إنشاء شبكة ظاهرية وشبكة فرعية واستخدامها. إذا لم يتم تحديد podSubnetID، ينطبق هذا على العقد والقرون، وإلا فإنه ينطبق على العقد فقط. هذا هو النموذج: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
workloadRuntime	تحديد نوع حمل العمل الذي يمكن أن تشغله العقدة.

تفاصيل الخاصية

availabilityZones

قائمة مناطق التوفر لاستخدامها للعقد. يمكن تحديد هذا فقط إذا كانت الخاصية AgentPoolType هي "VirtualMachineScaleSets".

availabilityZones?: string[]

قيمة الخاصية

string[]

capacityReservationGroupID

ستقوم AKS بإقران تجمع الوكلاء المحدد بمجموعة حجز السعة.

capacityReservationGroupID?: string

قيمة الخاصية

string

count

عدد العوامل (VMs) لاستضافة حاويات docker. يجب أن تكون القيم المسموح بها في نطاق من 0 إلى 1000 (شاملة) لتجمعات المستخدمين وفي نطاق 1 إلى 1000 (شامل) لتجمعات النظام. القيمة الافتراضية هي 1.

count?: number

قيمة الخاصية

number

creationData

CreateData لاستخدامها لتحديد معرف اللقطة المصدر إذا كان سيتم إنشاء/ترقية تجمع العقدة باستخدام لقطة.

creationData?: CreationData

قيمة الخاصية

CreationData

enableAutoScaling

ما إذا كان يجب تمكين أداة التحجيم التلقائي

enableAutoScaling?: boolean

قيمة الخاصية

boolean

enableCustomCATrust

عند التعيين إلى true، تقوم AKS بنشر daemonset وخدمات المضيف لمزامنة المراجع المصدقة المخصصة من مخطط التكوين الذي يوفره المستخدم في مخازن ثقة العقدة. الإعدادات الافتراضية للخطأ.

enableCustomCATrust?: boolean

قيمة الخاصية

boolean

enableEncryptionAtHost

هذا مدعوم فقط على أحجام أجهزة ظاهرية معينة وفي مناطق Azure معينة. لمزيد من المعلومات، راجع: https://docs.microsoft.com/azure/aks/enable-host-encryption

enableEncryptionAtHost?: boolean

قيمة الخاصية

boolean

enableFIPS

راجع إضافة تجمع عقدة يدعم FIPS لمزيد من التفاصيل.

enableFIPS?: boolean

قيمة الخاصية

boolean

enableNodePublicIP

قد تتطلب بعض السيناريوهات عقدا في تجمع عقدة لتلقي عناوين IP العامة المخصصة الخاصة بها. السيناريو الشائع هو أحمال عمل الألعاب، حيث تحتاج وحدة التحكم إلى إجراء اتصال مباشر بجهاز ظاهري سحابي لتقليل القفزات. لمزيد من المعلومات، راجع تعيين IP عام لكل عقدة. الإعداد الافتراضي خطأ.

enableNodePublicIP?: boolean

قيمة الخاصية

boolean

enableUltraSSD

ما إذا كان يجب تمكين UltraSSD

enableUltraSSD?: boolean

قيمة الخاصية

boolean

gpuInstanceProfile

GPUInstanceProfile ليتم استخدامه لتحديد ملف تعريف مثيل GPU MIG ل GPU VM SKU المدعوم.

gpuInstanceProfile?: "MIG1g" | "MIG2g" | "MIG3g" | "MIG4g" | "MIG7g"

قيمة الخاصية

"MIG1g" | "MIG2g" | "MIG3g" | "MIG4g" | "MIG7g"

hostGroupID

هذا هو النموذج: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. لمزيد من المعلومات، راجع مضيفي Azure المخصصين.

hostGroupID?: string

قيمة الخاصية

string

kubeletConfig

تكوين Kubelet على عقد تجمع العامل.

kubeletConfig?: KubeletConfig

قيمة الخاصية

KubeletConfig

kubeletDiskType

تحديد موضع وحدات تخزين emptyDir وجذر بيانات وقت تشغيل الحاوية والتخزين المؤقت Kubelet.

kubeletDiskType?: "OS" | "Temporary"

قيمة الخاصية

"OS" | "Temporary"

linuxOSConfig

تكوين نظام التشغيل لعقد عامل Linux.

linuxOSConfig?: LinuxOSConfig

قيمة الخاصية

LinuxOSConfig

maxCount

الحد الأقصى لعدد العقد للتحجيم التلقائي

maxCount?: number

قيمة الخاصية

number

maxPods

الحد الأقصى لعدد pods التي يمكن تشغيلها على عقدة.

maxPods?: number

قيمة الخاصية

number

messageOfTheDay

سلسلة مرمزة ب base64 والتي ستتم كتابتها إلى /etc/motd بعد فك التشفير. يسمح هذا بتخصيص رسالة اليوم لعقد Linux. يجب عدم تحديده لعقد Windows. يجب أن تكون سلسلة ثابتة (أي ستتم طباعة raw ولا يتم تنفيذها كبرنامج نصي).

messageOfTheDay?: string

قيمة الخاصية

string

minCount

الحد الأدنى لعدد العقد للتحجيم التلقائي

minCount?: number

قيمة الخاصية

number

mode

يجب أن يحتوي نظام المجموعة على تجمع عامل "نظام" واحد على الأقل في جميع الأوقات. للحصول على معلومات إضافية حول قيود تجمع الوكلاء وأفضل الممارسات، راجع: https://docs.microsoft.com/azure/aks/use-system-pools

mode?: "System" | "User"

قيمة الخاصية

"System" | "User"

nodeLabels

تسميات العقدة التي يجب أن تستمر عبر جميع العقد في تجمع العامل.

nodeLabels?: Record<string, string>

قيمة الخاصية

Record<string, string>

nodePublicIPPrefixID

هذا هو النموذج: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}

nodePublicIPPrefixID?: string

قيمة الخاصية

string

nodeTaints

الملامح المضافة إلى العقد الجديدة أثناء إنشاء تجمع العقدة وتوسيع نطاقها. على سبيل المثال، key=value:NoSchedule.

nodeTaints?: string[]

قيمة الخاصية

string[]

orchestratorVersion

يتم دعم كل من إصدار التصحيح <> major.minor.patch <major.minor>. عند تحديد <major.minor>، يتم اختيار أحدث إصدار تصحيح مدعوم تلقائيا. لن يؤدي تحديث تجمع الوكلاء بنفس <major.minor> بمجرد إنشائه إلى تشغيل ترقية، حتى إذا كان هناك إصدار تصحيح أحدث متوفر. كأفضل ممارسة، يجب ترقية جميع تجمعات العقد في نظام مجموعة AKS إلى نفس إصدار Kubernetes. يجب أن يكون لإصدار تجمع العقدة نفس الإصدار الرئيسي مثل مستوى التحكم. يجب أن يكون الإصدار الثانوي لتجمع العقدة ضمن إصدارين ثانويين من إصدار وحدة التحكم. لا يمكن أن يكون إصدار تجمع العقدة أكبر من إصدار وحدة التحكم. لمزيد من المعلومات، راجع ترقية تجمع عقدة.

orchestratorVersion?: string

قيمة الخاصية

string

osDiskSizeGB

حجم قرص نظام التشغيل بالجيجابايت الذي سيتم استخدامه لتحديد حجم القرص لكل جهاز في تجمع العامل/الرئيسي. إذا قمت بتحديد 0، تطبيق حجم osDisk الافتراضي وفقا ل vmSize المحدد.

osDiskSizeGB?: number

قيمة الخاصية

number

osDiskType

الإعداد الافتراضي هو "سريع الزوال" إذا كان الجهاز الظاهري يدعمه ويحتوي على قرص ذاكرة تخزين مؤقت أكبر من OSDiskSizeGB المطلوب. وإلا، يتم تعيين الإعدادات الافتراضية إلى "مدار". قد لا يتم تغيير بعد الإنشاء. لمزيد من المعلومات، راجع نظام التشغيل المؤقت.

osDiskType?: "Managed" | "Ephemeral"

قيمة الخاصية

"Managed" | "Ephemeral"

osSKU

يحدد نظام التشغيل SKU المستخدم من قبل تجمع العامل. إذا لم يتم تحديده، يكون الافتراضي هو Ubuntu إذا OSType=Linux أو Windows2019 إذا OSType=Windows. وسيتم تغيير Windows OSSKU الافتراضي إلى Windows2022 بعد إهمال Windows2019.

osSKU?: "Ubuntu" | "CBLMariner" | "Windows2019" | "Windows2022"

قيمة الخاصية

"Ubuntu" | "CBLMariner" | "Windows2019" | "Windows2022"

osType

نوع نظام التشغيل. الافتراضي هو Linux.

osType?: "Linux" | "Windows"

قيمة الخاصية

"Linux" | "Windows"

podSubnetID

إذا تم حذفها، يتم تعيين عناوين IP الخاصة بالجراب بشكل ثابت على الشبكة الفرعية للعقدة (راجع vnetSubnetID لمزيد من التفاصيل). هذا هو النموذج: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}

podSubnetID?: string

قيمة الخاصية

string

powerState

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

powerState?: PowerState

قيمة الخاصية

PowerState

proximityPlacementGroupID

معرف مجموعة موضع التقارب.

proximityPlacementGroupID?: string

قيمة الخاصية

string

scaleDownMode

يؤدي هذا أيضا إلى التأثير على سلوك التحجيم التلقائي لنظام المجموعة. إذا لم يتم تحديده، تعيينه افتراضيا إلى حذف.

scaleDownMode?: "Delete" | "Deallocate"

قيمة الخاصية

"Delete" | "Deallocate"

scaleSetEvictionPolicy

لا يمكن تحديد هذا إلا إذا كان scaleSetPriority هو 'Spot'. إذا لم يتم تحديده، يكون الافتراضي هو "حذف".

scaleSetEvictionPolicy?: "Delete" | "Deallocate"

قيمة الخاصية

"Delete" | "Deallocate"

scaleSetPriority

أولوية مجموعة مقياس الجهاز الظاهري. إذا لم يتم تحديده، يكون الافتراضي هو "عادي".

scaleSetPriority?: "Spot" | "Regular"

قيمة الخاصية

"Spot" | "Regular"

spotMaxPrice

القيم المحتملة هي أي قيمة عشرية أكبر من الصفر أو -1 مما يشير إلى الاستعداد لدفع أي سعر عند الطلب. لمزيد من التفاصيل حول التسعير الفوري، راجع تسعير الأجهزة الظاهرية الفورية

spotMaxPrice?: number

قيمة الخاصية

number

tags

العلامات التي سيتم استمرارها على مجموعة مقياس الجهاز الظاهري لتجمع العامل.

tags?: Record<string, string>

قيمة الخاصية

Record<string, string>

type

نوع تجمع الوكلاء.

type?: "VirtualMachineScaleSets" | "AvailabilitySet"

قيمة الخاصية

"VirtualMachineScaleSets" | "AvailabilitySet"

upgradeSettings

إعدادات ترقية مستودع الوكيل

upgradeSettings?: AgentPoolUpgradeSettings

قيمة الخاصية

AgentPoolUpgradeSettings

vmSize

يختلف توفر حجم الجهاز الظاهري حسب المنطقة. إذا كانت العقدة تحتوي على موارد حساب غير كافية (الذاكرة، وحدة المعالجة المركزية، وما إلى ذلك) فقد تفشل الحجيرات في العمل بشكل صحيح. لمزيد من التفاصيل حول أحجام الأجهزة الظاهرية المقيدة، راجع: https://docs.microsoft.com/azure/aks/quotas-skus-regions

vmSize?: string

قيمة الخاصية

string

vnetSubnetID

إذا لم يتم تحديد ذلك، سيتم إنشاء شبكة ظاهرية وشبكة فرعية واستخدامها. إذا لم يتم تحديد podSubnetID، ينطبق هذا على العقد والقرون، وإلا فإنه ينطبق على العقد فقط. هذا هو النموذج: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}

vnetSubnetID?: string

قيمة الخاصية

string

workloadRuntime

تحديد نوع حمل العمل الذي يمكن أن تشغله العقدة.

workloadRuntime?: "OCIContainer" | "WasmWasi"

قيمة الخاصية

"OCIContainer" | "WasmWasi"