Aracılığıyla paylaş

Microsoft.ContainerService managedClusters/agentPools

Bicep kaynak tanımı

managedClusters/agentPools kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

  • kaynak grupları - Bkz. kaynak grubu dağıtım komutları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.ContainerService/managedClusters/agentPools kaynağı oluşturmak için, şablonunuza aşağıdaki Bicep'i ekleyin.

resource symbolicname 'Microsoft.ContainerService/managedClusters/agentPools@2025-05-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    availabilityZones: [
      'string'
    ]
    capacityReservationGroupID: 'string'
    count: int
    creationData: {
      sourceResourceId: 'string'
    }
    enableAutoScaling: bool
    enableEncryptionAtHost: bool
    enableFIPS: bool
    enableNodePublicIP: bool
    enableUltraSSD: bool
    gatewayProfile: {
      publicIPPrefixSize: int
    }
    gpuInstanceProfile: 'string'
    gpuProfile: {
      driver: 'string'
    }
    hostGroupID: 'string'
    kubeletConfig: {
      allowedUnsafeSysctls: [
        'string'
      ]
      containerLogMaxFiles: int
      containerLogMaxSizeMB: int
      cpuCfsQuota: bool
      cpuCfsQuotaPeriod: 'string'
      cpuManagerPolicy: 'string'
      failSwapOn: bool
      imageGcHighThreshold: int
      imageGcLowThreshold: int
      podMaxPids: int
      topologyManagerPolicy: 'string'
    }
    kubeletDiskType: 'string'
    linuxOSConfig: {
      swapFileSizeMB: int
      sysctls: {
        fsAioMaxNr: int
        fsFileMax: int
        fsInotifyMaxUserWatches: int
        fsNrOpen: int
        kernelThreadsMax: int
        netCoreNetdevMaxBacklog: int
        netCoreOptmemMax: int
        netCoreRmemDefault: int
        netCoreRmemMax: int
        netCoreSomaxconn: int
        netCoreWmemDefault: int
        netCoreWmemMax: int
        netIpv4IpLocalPortRange: 'string'
        netIpv4NeighDefaultGcThresh1: int
        netIpv4NeighDefaultGcThresh2: int
        netIpv4NeighDefaultGcThresh3: int
        netIpv4TcpFinTimeout: int
        netIpv4TcpkeepaliveIntvl: int
        netIpv4TcpKeepaliveProbes: int
        netIpv4TcpKeepaliveTime: int
        netIpv4TcpMaxSynBacklog: int
        netIpv4TcpMaxTwBuckets: int
        netIpv4TcpTwReuse: bool
        netNetfilterNfConntrackBuckets: int
        netNetfilterNfConntrackMax: int
        vmMaxMapCount: int
        vmSwappiness: int
        vmVfsCachePressure: int
      }
      transparentHugePageDefrag: 'string'
      transparentHugePageEnabled: 'string'
    }
    maxCount: int
    maxPods: int
    messageOfTheDay: 'string'
    minCount: int
    mode: 'string'
    networkProfile: {
      allowedHostPorts: [
        {
          portEnd: int
          portStart: int
          protocol: 'string'
        }
      ]
      applicationSecurityGroups: [
        'string'
      ]
      nodePublicIPTags: [
        {
          ipTagType: 'string'
          tag: 'string'
        }
      ]
    }
    nodeLabels: {
      {customized property}: 'string'
    }
    nodePublicIPPrefixID: 'string'
    nodeTaints: [
      'string'
    ]
    orchestratorVersion: 'string'
    osDiskSizeGB: int
    osDiskType: 'string'
    osSKU: 'string'
    osType: 'string'
    podIPAllocationMode: 'string'
    podSubnetID: 'string'
    powerState: {
      code: 'string'
    }
    proximityPlacementGroupID: 'string'
    scaleDownMode: 'string'
    scaleSetEvictionPolicy: 'string'
    scaleSetPriority: 'string'
    securityProfile: {
      enableSecureBoot: bool
      enableVTPM: bool
    }
    spotMaxPrice: int
    status: {}
    tags: {
      {customized property}: 'string'
    }
    type: 'string'
    upgradeSettings: {
      drainTimeoutInMinutes: int
      maxSurge: 'string'
      maxUnavailable: 'string'
      nodeSoakDurationInMinutes: int
      undrainableNodeBehavior: 'string'
    }
    virtualMachineNodesStatus: [
      {
        count: int
        size: 'string'
      }
    ]
    virtualMachinesProfile: {
      scale: {
        manual: [
          {
            count: int
            size: 'string'
          }
        ]
      }
    }
    vmSize: 'string'
    vnetSubnetID: 'string'
    windowsProfile: {
      disableOutboundNat: bool
    }
    workloadRuntime: 'string'
  }
}

Özellik Değerleri

Microsoft.ContainerService/managedClusters/agentPools

İsim Açıklama Değer
isim Kaynak adı karakter dizisi

Kısıtlama -ları:
En az uzunluk = 1
Maksimum uzunluk = 12
Desen = ^[a-z][a-z0-9]{0,11}$ (gerekli)
veli Bicep'te bir alt kaynak için üst kaynak belirtebilirsiniz. Bu özelliği yalnızca alt kaynak üst kaynağın dışında bildirildiğinde eklemeniz gerekir.

Daha fazla bilgi için bkz. Alt kaynaküst kaynak dışında.		 Kaynak türü için sembolik ad: managedClusters
özellikler Aracı havuzunun özellikleri. ManagedClusterAgentPoolProfileProperties

AgentPoolGatewayProfile

İsim Açıklama Değer
publicIPPrefixSize Ağ geçidi aracı havuzu, genel çıkış sağlamak için her statik çıkış ağ geçidi için bir genel IPPrefix ilişkilendirir. Genel IPPrefix'in boyutu kullanıcı tarafından seçilmelidir. Aracı havuzundaki her düğüm, IPPrefix'ten bir IP ile atanır. BU nedenle IPPrefix boyutu, Ağ Geçidi aracı havuzunun boyutu üzerinde bir üst sınır görevi görür. Azure genel IPPrefix boyut sınırlaması nedeniyle geçerli değer aralığı [28, 31] (/31 = 2 düğüm/IP, /30 = 4 düğüm/IP, /29 = 8 düğüm/IP, /28 = 16 düğüm/IP). Varsayılan değer 31'dir. Int

Kısıtlama -ları:
Min değer = 28
Maksimum değer = 31

AgentPoolNetworkProfile

İsim Açıklama Değer
allowedHostPortlar Erişmesine izin verilen bağlantı noktası aralıkları. Belirtilen aralıkların çakışmasına izin verilir. Bağlantı Noktası Aralığı[]
uygulama güvenlik grupları Aracı havuzunun oluşturulduğunda ilişkilendirileceği uygulama güvenlik gruplarının kimlikleri. dize[]
nodePublicIPTags Örnek düzeyinde genel IP'lerin IPTag'leri. IPTag[]

AgentPoolSecurityProfile

İsim Açıklama Değer
enableSecureBoot Güvenli Önyükleme, yalnızca imzalı işletim sistemlerinin ve sürücülerin önyüklenmesini sağlayan Güvenilir Başlatma özelliğidir. Diğer ayrıntılar için bkz. aka.ms/aks/trustedlaunch. Belirtilmezse varsayılan değer false olur. Boole
enableVTPM vTPM, düğümde yerel olarak tutulan anahtarlar ve ölçümler için ayrılmış bir güvenli kasa yapılandırmaya yönelik bir Güvenilen Başlatma özelliğidir. Diğer ayrıntılar için bkz. aka.ms/aks/trustedlaunch. Belirtilmezse varsayılan değer false olur. Boole

AgentPoolStatus (AgentPoolStatus)

İsim Açıklama Değer

AgentPoolUpgradeSettings

İsim Açıklama Değer
drainTimeoutInMinutes Bir düğüm için boşaltma zaman aşımı. Podların çıkarılması ve düğüm başına düzgün sonlandırma için bekleme süresi (dakika cinsinden). Bu çıkarma bekleme süresi, pod kesintisi bütçelerini beklemeyi kabul eder. Bu süre aşılırsa yükseltme başarısız olur. Belirtilmezse, varsayılan değer 30 dakikadır. Int

Kısıtlama -ları:
Min değer = 1
Maksimum değer = 1440
maxSurge (Maksimum Dalgalanma) Yükseltme sırasında kullanılabilecek en fazla düğüm sayısı veya yüzdesi. Bu bir tamsayıya (ör. '5') veya yüzdeye (örneğin, '50%') ayarlanabilir. Yüzde belirtilirse, yükseltme sırasındaki toplam aracı havuzu boyutunun yüzdesidir. Yüzdeler için kesirli düğümler yukarı yuvarlanir. Belirtilmezse, varsayılan değer 10%'dir. En iyi yöntemler de dahil olmak üzere daha fazla bilgi için bkz. /azure/aks/upgrade-cluster String
maxUnavailable Yükseltme sırasında aynı anda kullanılamayabilecek en fazla düğüm sayısı veya yüzdesi. Bu bir tamsayıya (ör. '1') veya bir yüzdeye (ör. '5%') ayarlanabilir. Yüzde belirtilirse, yükseltme sırasındaki toplam aracı havuzu boyutunun yüzdesidir. Yüzdeler için kesirli düğümler yukarı yuvarlanir. Belirtilmezse, varsayılan değer 0'dır. En iyi yöntemler de dahil olmak üzere daha fazla bilgi için bkz. /azure/aks/upgrade-cluster String
nodeSoakDurationInMinutes Bir düğümün ıslatma süresi. Bir düğümü boşaltıp yeniden boyutlandırmadan ve sonraki düğüme geçmeden önce beklenmesi gereken süre (dakika cinsinden). Belirtilmezse, varsayılan değer 0 dakikadır. Int

Kısıtlama -ları:
En düşük değer = 0
Maksimum değer = 30
çizilemezNodeBehavior Yükseltme sırasında çizilemez düğümlerin davranışını tanımlar. Çizilemeyen düğümlerin en yaygın nedeni Pod Kesinti bütçeleri (PDB) olsa da pod sonlandırma yetkisiz kullanım süresi kalan düğüm başına boşaltma zaman aşımını aşıyor veya pod hala çalışıyor durumdaysa, ayrıca çizilemez düğümlere neden olabilir. 'Kordon'
'Zamanlama'

AgentPoolWindowsProfile

İsim Açıklama Değer
disableOutboundNat Windows düğümlerinde OutboundNAT'ın devre dışı bırakılıp bırakılmayacağı. Varsayılan değer yanlıştır. Giden NAT yalnızca küme outboundType NAT Ağ Geçidi ise ve Windows aracı havuzunda düğüm genel IP'sinin etkinleştirilmemesi durumunda devre dışı bırakılabilir. Boole

Oluşturma Verileri

İsim Açıklama Değer
sourceResourceId Bu, hedef nesneyi oluşturmak için kullanılacak kaynak nesnenin ARM kimliğidir. String

GPUProfile

İsim Açıklama Değer
sürücü GPU sürücülerinin yüklenip yüklenmeyeceği. Belirtilmediğinde, varsayılan olarak Yükle'dir. 'Yükle'
'Hiçbiri'

IPTag (IPTag)

İsim Açıklama Değer
ipTagType IP etiketi türü. Örnek: RoutingPreference. String
etiket Genel IP ile ilişkili IP etiketinin değeri. Örnek: İnternet. String

KubeletConfig

İsim Açıklama Değer
allowedUnsafeSysctls Güvenli olmayan sysctl veya güvenli olmayan sysctl desenlerinin izin verilen listesi (ile *biten). dize[]
containerLogMaxFiles Kapsayıcı için mevcut olabilecek en fazla kapsayıcı günlüğü dosyası sayısı. Sayı 2 ≥ olmalıdır. Int

Kısıtlama -ları:
Min değer = 2
containerLogMaxSizeMB Döndürülmeden önce kapsayıcı günlük dosyasının en büyük boyutu (örneğin 10Mi). Int
cpuCfsKotası CPU sınırlarını belirten kapsayıcılar için CPU CFS kota zorlaması etkinleştirildiyse. Varsayılan değer true'dur. Boole
cpuCfsQuotaPeriod CPU CFS kota dönemi değeri. Varsayılan değer :'100ms.' Geçerli değerler, isteğe bağlı kesir ve birim soneki içeren ondalık sayı dizisidir. Örneğin: '300ms', '2h45m'. Desteklenen birimler 'ns', 'us', 'ms', 's', 'm' ve 'h' birimleridir. String
cpuManagerİlkesi Kullanılacak CPU Yöneticisi ilkesi. Varsayılan değer :'none'. Daha fazla bilgi için bkz. Kubernetes CPU yönetim ilkeleri . İzin verilen değerler 'none' ve 'static' değerleridir. String
failSwapOn True olarak ayarlanırsa, düğümde değiştirme etkinse Kubelet'in başlatılamamasına neden olur. Boole
imageGcHighThreshold (Görüntü Altı) Görüntü çöp toplama işleminin her zaman çalıştırıldığı disk kullanımı yüzdesi. Görüntü çöp toplamayı devre dışı bırakmak için 100 olarak ayarlayın. Varsayılan değer 85% Int
imageGcLowThreshold Görüntü atık toplama işleminin hiçbir zaman çalıştırılamadan önce disk kullanımı yüzdesi. Bu ayar imageGcHighThreshold değerinden yüksek olamaz. Varsayılan değer 80% Int
podMaxPids Pod başına işlem sayısı üst sınırı. Int
topolojiManagerPolicy Kullanılacak Topoloji Yöneticisi ilkesi. Daha fazla bilgi için bkz. Kubernetes Topoloji Yöneticisi. Varsayılan değer :'none'. İzin verilen değerler 'none', 'best-effort', 'restricted' ve 'single-numa-node' değerleridir. String

LinuxOSConfig

İsim Açıklama Değer
swapFileSizeMB Her düğümde oluşturulacak takas dosyasının MB cinsinden boyutu. Int
sysctls (sysctl'ler) Linux aracı düğümleri için sysctl ayarları. SysctlConfig
şeffafKocamanSayfaBirleştir Çekirdeğin daha büyük sayfaları kullanılabilir hale getirmek için bellek sıkıştırmasını agresif bir şekilde kullanıp kullanmaması. Geçerli değerler :'always', 'defer', 'defer+madvise', 'madvise' ve 'never'. Varsayılan değer "madvise" şeklindedir. Daha fazla bilgi için bkz . Transparent Hugepages. String
transparentHugePageEnabled Saydam büyük sayfaların etkinleştirilip etkinleştirilmediği. Geçerli değerler 'always', 'madvise' ve 'never' değerleridir. Varsayılan değer "her zaman"dır. Daha fazla bilgi için bkz . Transparent Hugepages. String

ManagedClusterAgentPoolProfileProperties

İsim Açıklama Değer
kullanılabilirlik bölgeleri Düğümler için kullanılacak Kullanılabilirlik alanlarının listesi. Bu yalnızca AgentPoolType özelliği 'VirtualMachineScaleSets' olduğunda belirtilebilir. dize[]
capacityReservationGroupID AKS, belirtilen aracı havuzunu Kapasite Rezervasyon Grubu ile ilişkilendirir. String
sayı Docker kapsayıcılarını barındıracak aracıların (VM) sayısı. İzin verilen değerler, kullanıcı havuzları için 0 ile 1000 (dahil) arasında ve sistem havuzları için 1 ile 1000 (dahil) arasında olmalıdır. Varsayılan değer 1'dir. Int
oluşturmaVeri Düğüm havuzu bir anlık görüntü kullanılarak oluşturulacak/yükseltilecekse kaynak Anlık Görüntü Kimliğini belirtmek için kullanılacak CreationData. Oluşturma Verileri
enableAutoScaling Otomatik ölçeklendiricinin etkinleştirilip etkinleştirilmeyileceği Boole
enableEncryptionAtHost Konak tabanlı işletim sisteminin ve veri sürücüsü şifrelemenin etkinleştirilip etkinleştirilmeyileceği. Bu yalnızca belirli VM boyutlarında ve belirli Azure bölgelerinde desteklenir. Daha fazla bilgi için bkz. /azure/aks/enable-host-encryption Boole
enableFIPS FIPS özellikli işletim sisteminin kullanılıp kullanılmaymayacağı. Daha fazla ayrıntı için bkz. FIPS özellikli düğüm havuzu ekleme . Boole
enableNodePublicIP Her düğümün kendi genel IP'sini ayırıp ayırmadığı. Bazı senaryolar, düğüm havuzundaki düğümlerin kendi ayrılmış genel IP adreslerini almasını gerektirebilir. Yaygın bir senaryo, konsolun atlamaları en aza indirmek için bulut sanal makinesine doğrudan bağlantı sağlaması gereken oyun iş yüklerine yöneliktir. Daha fazla bilgi için bkz. Düğüm başına genel IP atama. Varsayılan değer false'tur. Boole
UltraSSD'yi etkinleştir UltraSSD'nin etkinleştirilip etkinleştirilmeyileceği Boole
ağ geçidi profili Ağ geçidi modunda yönetilen aracı havuzuna özgü profil. Aracı havuzu modu Ağ Geçidi değilse bu alan ayarlanamaz. AgentPoolGatewayProfile
gpuInstanceProfile Desteklenen GPU VM SKU'su için GPU MIG örnek profilini belirtmek üzere kullanılacak GPUInstanceProfile. 'MIG1g'
'MIG2g'
'MIG3g'
'MIG4g'
'MIG7g'
gpuProfile (İngilizce) Aracı Havuzu için GPU ayarları. GPUProfile
hostGroupID (Ana BilgisayarGrup Kimliği) Sanal makinelerin sağlanacağı Ayrılmış Konak Grubunun tam kaynak kimliği, yalnızca oluşturma senaryosunda kullanılır ve bir kez ayarlandıktan sonra değiştirilmesine izin verilmez. Bu şu biçimdedir: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Daha fazla bilgi için bkz. Azure ayrılmış konakları. String
kubeletConfig Aracı havuzu düğümlerinde Kubelet yapılandırması. KubeletConfig
kubeletDiskType emptyDir birimlerinin, kapsayıcı çalışma zamanı veri kökünün ve Kubelet kısa ömürlü depolamanın yerleşimini belirler. 'İşletim Sistemi'
'Geçici'
linuxOSConfig Linux aracı düğümlerinin işletim sistemi yapılandırması. LinuxOSConfig
maxCount (Maksimum Sayı) Otomatik ölçeklendirme için en fazla düğüm sayısı Int
maksimum Bölmeler Bir düğümde çalışabilecek en fazla pod sayısı. Int
messageOfTheDay Base64 kodlu Linux düğümleri için günün iletisi. Kod çözmeden sonra /etc/motd öğesine yazılacak base64 kodlanmış bir dize. Bu, Linux düğümleri için günün iletisinin özelleştirilmesini sağlar. Windows düğümleri için belirtilmemelidir. Statik bir dize olmalıdır (örneğin, ham olarak yazdırılır ve betik olarak yürütülmeyecektir). String
minCount Otomatik ölçeklendirme için en az düğüm sayısı Int
mod Aracı havuzunun modu. Bir kümenin her zaman en az bir 'Sistem' Aracı Havuzu olmalıdır. Aracı havuzu kısıtlamaları ve en iyi yöntemler hakkında ek bilgi için bkz. /azure/aks/use-system-pools 'Ağ Geçidi'
'Sistem'
'Kullanıcı'
ağ Profili Aracı havuzunun ağ ile ilgili ayarları. AgentPoolNetworkProfile
nodeLabels (düğüm etiketleri) Aracı havuzundaki tüm düğümlerde kalıcı hale getirmek için düğüm etiketleri. ManagedClusterAgentPoolProfilePropertiesNodeLabels
nodePublicIPPrefixID VM düğümlerinin IP'lerini kullanması gereken genel IP ön ek kimliği. Bu şu biçimdedir: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} String
nodeTaints (Düğümler) Düğüm havuzu oluşturma ve ölçeklendirme sırasında yeni düğümlere eklenen renk tonları. Örneğin, key=value:NoSchedule. dize[]
orchestratorVersion Kullanıcı tarafından belirtilen Kubernetes sürümü. Hem yama sürümü <major.minor.patch> (örneğin, 1.20.13) hem de <major.minor> (örneğin 1.20) desteklenir. <major.minor> belirtildiğinde, desteklenen en son GA düzeltme eki sürümü otomatik olarak seçilir. Küme oluşturulduktan sonra aynı <major.minor> ile güncelleştirilmesi (örneğin, 1.14.x -> 1.14) daha yeni bir düzeltme eki sürümü kullanılabilir olsa bile yükseltme tetiklemez. En iyi yöntem olarak, AKS kümesindeki tüm düğüm havuzlarını aynı Kubernetes sürümüne yükseltmeniz gerekir. Düğüm havuzu sürümü, denetim düzlemi ile aynı ana sürüme sahip olmalıdır. Düğüm havuzu ikincil sürümü, denetim düzlemi sürümünün iki ikincil sürümünde olmalıdır. Düğüm havuzu sürümü, denetim düzlemi sürümünden büyük olamaz. Daha fazla bilgi için bkz. Düğüm havuzunu yükseltme. String
İşletim SistemiBoyutuGB Ana/aracı havuzundaki her makine için disk boyutunu belirtmek için kullanılacak GB cinsinden işletim sistemi Disk Boyutu. 0 belirtirseniz, belirtilen vmSize değerine göre varsayılan osDisk boyutunu uygular. Int

Kısıtlama -ları:
En düşük değer = 0
Maksimum değer = 2048
osDiskType Aracı havuzundaki makineler için kullanılacak işletim sistemi disk türü. VM destekliyorsa ve istenen OSDiskSizeGB değerinden daha büyük bir önbellek diske sahipse varsayılan değer 'Kısa Ömürlü'dür. Aksi takdirde, varsayılan olarak 'Yönetilen' olarak gösterilir. Oluşturulduktan sonra değiştirilemez. Daha fazla bilgi için bkz. Kısa ömürlü işletim sistemi. 'Kısa Ömürlü'
'Yönetilen'
İşletim SistemiSKU'su Aracı havuzu tarafından kullanılan işletim sistemi SKU'su belirtir. OSType Linux ise varsayılan değer Ubuntu'dur. OSType Windows ise, Kubernetes <= 1,24 veya Windows2022 olduğunda varsayılan >değer Windows2019'dur. 'AzureLinux'
'CBLMariner'
'Ubuntu'
'Ubuntu2204'
'Windows2019'
'Windows2022'
işletim sistemi türü İşletim sistemi türü. Varsayılan değer Linux'tır. 'Linux'
'Pencereler'
podIPAllocationMode Pod IP Ayırma Modu. Aracı havuzundaki podlar için IP ayırma modu. podSubnetId ile kullanılmalıdır. Varsayılan değer :'DynamicIndividual'. 'Dinamik Bireysel'
'Statik Blok'
podSubnetID Podların başlatıldığında birleştirileceği alt ağın kimliği. Atlanırsa pod IP'leri düğüm alt ağından statik olarak atanır (daha fazla ayrıntı için bkz. vnetSubnetID). Bu şu biçimdedir: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} String
güç durumu Aracı Havuzunun çalışıp çalışmadığı veya durdurulduğu. Bir Aracı Havuzu ilk oluşturulduğunda başlangıçta Çalışıyor olur. Aracı Havuzu, bu alan Durduruldu olarak ayarlanarak durdurulabilir. Durdurulan Aracı Havuzu tüm VM'lerini durdurur ve faturalama ücretlerini tahakkuk etmez. Aracı Havuzu yalnızca Çalışıyor ve sağlama durumu Başarılı olduğunda durdurulabilir Güç Durumu
proximityPlacementGroupID YakınLık Yerleştirme Grubu kimliği. String
scaleDownMode (ölçek Küçültme Modu) Aracı Havuzunu ölçeklendirirken kullanılacak ölçeği azaltma modu. Bu, küme otomatik ölçeklendirici davranışını da etkiler. Belirtilmezse, varsayılan olarak Delete olur. 'Serbest Bırak'
'Sil'
Ölçek Kümesi İşten Çıkarma Politikası Kullanılacak Sanal Makine Ölçek Kümesi çıkarma ilkesi. scaleSetPriority değeri 'Spot' değilse bu belirtilemez. Belirtilmezse, varsayılan değer 'Sil'dir. 'Serbest Bırak'
'Sil'
ölçekSetÖncelik Sanal Makine Ölçek Kümesi önceliği. Belirtilmezse, varsayılan değer 'Normal'dir. 'Normal'
'Yer'
güvenlik profili Aracı havuzunun güvenlik ayarları. AgentPoolSecurityProfile
spotMaxFiyat Spot örnekler için ödeme yapmak istediğiniz maksimum fiyat (ABD Doları cinsinden). Olası değerler, varsayılan fiyatın isteğe bağlı olarak up-to belirten sıfırdan büyük veya -1 herhangi bir ondalık değerdir. Olası değerler, herhangi bir isteğe bağlı fiyat ödemeye istekli olduğunu gösteren sıfırdan veya -1 büyük herhangi bir ondalık değerdir. Spot fiyatlandırma hakkında daha fazla bilgi için bkz. spot VM fiyatlandırması Int
statü Aracı Havuzu hakkında salt okunur bilgiler içerir. AgentPoolStatus (AgentPoolStatus)
Etiketler Aracı havuzu sanal makine ölçek kümesinde kalıcı hale eklenecek etiketler. ManagedClusterAgentPoolProfilePropertiesTags
tür Aracı Havuzu türü. 'Kullanılabilirlik Seti'
'Sanal Makineler'
'VirtualMachineScaleSets'
upgradeSettings Aracı havuzunu yükseltme ayarları AgentPoolUpgradeSettings
virtualMachineNodesStatus VirtualMachines aracı havuzundaki düğümlerin durumu. VirtualMachineNodes[]
virtualMachinesProfile VirtualMachines aracı havuzundaki belirtimler. VirtualMachinesProfile
vmSize (Sanal Makine Boyutu) Aracı havuzu VM'lerinin boyutu. VM boyutu kullanılabilirliği bölgeye göre değişir. Düğüm yetersiz işlem kaynakları (bellek, cpu vb.) içeriyorsa podlar düzgün çalışmayabilir. Kısıtlanmış VM boyutları hakkında daha fazla ayrıntı için bkz. /azure/aks/quotas-skus-regions String
vnetSubnetID Aracı havuzu düğümlerinin ve isteğe bağlı olarak podların başlangıçta birleştirileceği alt ağın kimliği. Bu belirtilmezse, bir sanal ağ ve alt ağ oluşturulur ve kullanılır. PodSubnetID belirtilmezse, bu düğümler ve podlar için geçerlidir, aksi takdirde yalnızca düğümler için geçerlidir. Bu şu biçimdedir: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} String
windows Profili Windows aracı havuzunun belirli profili. AgentPoolWindowsProfile
workloadRuntime (İş YüküÇalışma Zamanı) Bir düğümün çalıştırabileceği iş yükü türünü belirler. 'OCIContainer'
'WasmWasi'

ManagedClusterAgentPoolProfilePropertiesNodeLabels

İsim Açıklama Değer

ManagedClusterAgentPoolProfilePropertiesTags

İsim Açıklama Değer

ManualScaleProfile (Kılavuzu)

İsim Açıklama Değer
sayı Düğüm sayısı. Int
boyut AKS 'Standard_E4s_v3', 'Standard_E16s_v3' veya 'Standard_D16s_v5' gibi oluşturma ve ölçeklendirme sırasında kullanacağı VM boyutu. String

Bağlantı Noktası Aralığı

İsim Açıklama Değer
portEnd Aralığa dahil edilen maksimum bağlantı noktası. 1 ile 65535 arasında olmalı ve portStart değerinden büyük veya buna eşit olmalıdır. Int

Kısıtlama -ları:
Min değer = 1
Maksimum değer = 65535
bağlantı noktası Başlat Aralığa dahil edilen en düşük bağlantı noktası. 1 ile 65535 arasında olmalı ve portEnd değerinden küçük veya buna eşit olmalıdır. Int

Kısıtlama -ları:
Min değer = 1
Maksimum değer = 65535
protokol Bağlantı noktasının ağ protokolü. 'TCP'
'UDP'

Güç Durumu

İsim Açıklama Değer
kod Kümenin Çalışıyor mu yoksa Durduruldu mu olduğunu bildirir 'Çalışıyor'
'Durduruldu'

Ölçek Profili

İsim Açıklama Değer
el ile VirtualMachines aracı havuzunun sabit bir boyuta ölçeklendirilmesiyle ilgili belirtimler. ManualScaleProfile[]

SysctlConfig

İsim Açıklama Değer
fsAioMaxNr Sysctl ayarı fs.aio-max-nr. Int
fsFileMax Sysctl ayarı fs.file-max. Int
fsInotifyMaxUserWatches Sysctl ayarı fs.inotify.max_user_watches. Int
fsNrAçık Sysctl ayarı fs.nr_open. Int
kernelThreadsMax Kernel.threads-max sysctl ayarı. Int
netCoreNetdevMaxBacklog Sysctl ayarı net.core.netdev_max_backlog. Int
netCoreOptmemMax (NetCoreOptmemMax) Sysctl ayarı net.core.optmem_max. Int
netCoreRmemDefault Sysctl ayarı net.core.rmem_default. Int
netCoreRmemMax Sysctl ayarı net.core.rmem_max. Int
netCoreSomaxconn Net.core.somaxconn sysctl ayarı. Int
netCoreWmemDefault Sysctl ayarı net.core.wmem_default. Int
netCoreWmemMax Sysctl ayarı net.core.wmem_max. Int
netIpv4IpLocalPortRange Sysctl ayarı net.ipv4.ip_local_port_range. String
netIpv4NeighDefaultGcThresh1 Sysctl ayarı net.ipv4.neigh.default.gc_thresh1. Int
netIpv4NeighDefaultGcThresh2 Sysctl ayarı net.ipv4.neigh.default.gc_thresh2. Int
netIpv4NeighDefaultGcThresh3 Sysctl ayarı net.ipv4.neigh.default.gc_thresh3. Int
netIpv4TcpFinTimeout Sysctl ayarı net.ipv4.tcp_fin_timeout. Int
netIpv4TcpkeepaliveIntvl Sysctl ayarı net.ipv4.tcp_keepalive_intvl. Int

Kısıtlama -ları:
En düşük değer = 10
Maksimum değer = 90
netIpv4TcpKeepaliveProbes Sysctl ayarı net.ipv4.tcp_keepalive_probes. Int
netIpv4TcpKeepaliveTime Sysctl ayarı net.ipv4.tcp_keepalive_time. Int
netIpv4TcpMaxSynBacklog Sysctl ayarı net.ipv4.tcp_max_syn_backlog. Int
netIpv4TcpMaxTwBuckets Sysctl ayarı net.ipv4.tcp_max_tw_buckets. Int
netIpv4TcpTwReuse Sysctl ayarı net.ipv4.tcp_tw_reuse. Boole
netNetfilterNfConntrackBuckets Sysctl ayarı net.netfilter.nf_conntrack_buckets. Int

Kısıtlama -ları:
Min değer = 65536
En yüksek değer = 524288
netNetfilterNfConntrackMax Sysctl ayarı net.netfilter.nf_conntrack_max. Int

Kısıtlama -ları:
En düşük değer = 131072
En yüksek değer = 2097152
vmMaxMapCount Sysctl ayarı vm.max_map_count. Int
vmSwappiness (Sanal Makine Değişimi) Sysctl ayarı vm.swappiness. Int
vmVfsÖnbellek Basıncı Sysctl ayarı vm.vfs_cache_pressure. Int

Sanal Makine Düğümleri

İsim Açıklama Değer
sayı Düğüm sayısı. Int
boyut Bu düğüm grubunu barındırmak için kullanılan aracıların VM boyutu. String

VirtualMachinesProfile

İsim Açıklama Değer
ölçek VirtualMachines aracı havuzunu ölçeklendirmeye ilişkin belirtimler. Ölçek Profili

ARM şablonu kaynak tanımı

managedClusters/agentPools kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

  • kaynak grupları - Bkz. kaynak grubu dağıtım komutları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.ContainerService/managedClusters/agentPools kaynağı oluşturmak için şablonunuza aşağıdaki JSON'u ekleyin.

{
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "apiVersion": "2025-05-01",
  "name": "string",
  "properties": {
    "availabilityZones": [ "string" ],
    "capacityReservationGroupID": "string",
    "count": "int",
    "creationData": {
      "sourceResourceId": "string"
    },
    "enableAutoScaling": "bool",
    "enableEncryptionAtHost": "bool",
    "enableFIPS": "bool",
    "enableNodePublicIP": "bool",
    "enableUltraSSD": "bool",
    "gatewayProfile": {
      "publicIPPrefixSize": "int"
    },
    "gpuInstanceProfile": "string",
    "gpuProfile": {
      "driver": "string"
    },
    "hostGroupID": "string",
    "kubeletConfig": {
      "allowedUnsafeSysctls": [ "string" ],
      "containerLogMaxFiles": "int",
      "containerLogMaxSizeMB": "int",
      "cpuCfsQuota": "bool",
      "cpuCfsQuotaPeriod": "string",
      "cpuManagerPolicy": "string",
      "failSwapOn": "bool",
      "imageGcHighThreshold": "int",
      "imageGcLowThreshold": "int",
      "podMaxPids": "int",
      "topologyManagerPolicy": "string"
    },
    "kubeletDiskType": "string",
    "linuxOSConfig": {
      "swapFileSizeMB": "int",
      "sysctls": {
        "fsAioMaxNr": "int",
        "fsFileMax": "int",
        "fsInotifyMaxUserWatches": "int",
        "fsNrOpen": "int",
        "kernelThreadsMax": "int",
        "netCoreNetdevMaxBacklog": "int",
        "netCoreOptmemMax": "int",
        "netCoreRmemDefault": "int",
        "netCoreRmemMax": "int",
        "netCoreSomaxconn": "int",
        "netCoreWmemDefault": "int",
        "netCoreWmemMax": "int",
        "netIpv4IpLocalPortRange": "string",
        "netIpv4NeighDefaultGcThresh1": "int",
        "netIpv4NeighDefaultGcThresh2": "int",
        "netIpv4NeighDefaultGcThresh3": "int",
        "netIpv4TcpFinTimeout": "int",
        "netIpv4TcpkeepaliveIntvl": "int",
        "netIpv4TcpKeepaliveProbes": "int",
        "netIpv4TcpKeepaliveTime": "int",
        "netIpv4TcpMaxSynBacklog": "int",
        "netIpv4TcpMaxTwBuckets": "int",
        "netIpv4TcpTwReuse": "bool",
        "netNetfilterNfConntrackBuckets": "int",
        "netNetfilterNfConntrackMax": "int",
        "vmMaxMapCount": "int",
        "vmSwappiness": "int",
        "vmVfsCachePressure": "int"
      },
      "transparentHugePageDefrag": "string",
      "transparentHugePageEnabled": "string"
    },
    "maxCount": "int",
    "maxPods": "int",
    "messageOfTheDay": "string",
    "minCount": "int",
    "mode": "string",
    "networkProfile": {
      "allowedHostPorts": [
        {
          "portEnd": "int",
          "portStart": "int",
          "protocol": "string"
        }
      ],
      "applicationSecurityGroups": [ "string" ],
      "nodePublicIPTags": [
        {
          "ipTagType": "string",
          "tag": "string"
        }
      ]
    },
    "nodeLabels": {
      "{customized property}": "string"
    },
    "nodePublicIPPrefixID": "string",
    "nodeTaints": [ "string" ],
    "orchestratorVersion": "string",
    "osDiskSizeGB": "int",
    "osDiskType": "string",
    "osSKU": "string",
    "osType": "string",
    "podIPAllocationMode": "string",
    "podSubnetID": "string",
    "powerState": {
      "code": "string"
    },
    "proximityPlacementGroupID": "string",
    "scaleDownMode": "string",
    "scaleSetEvictionPolicy": "string",
    "scaleSetPriority": "string",
    "securityProfile": {
      "enableSecureBoot": "bool",
      "enableVTPM": "bool"
    },
    "spotMaxPrice": "int",
    "status": {
    },
    "tags": {
      "{customized property}": "string"
    },
    "type": "string",
    "upgradeSettings": {
      "drainTimeoutInMinutes": "int",
      "maxSurge": "string",
      "maxUnavailable": "string",
      "nodeSoakDurationInMinutes": "int",
      "undrainableNodeBehavior": "string"
    },
    "virtualMachineNodesStatus": [
      {
        "count": "int",
        "size": "string"
      }
    ],
    "virtualMachinesProfile": {
      "scale": {
        "manual": [
          {
            "count": "int",
            "size": "string"
          }
        ]
      }
    },
    "vmSize": "string",
    "vnetSubnetID": "string",
    "windowsProfile": {
      "disableOutboundNat": "bool"
    },
    "workloadRuntime": "string"
  }
}

Özellik Değerleri

Microsoft.ContainerService/managedClusters/agentPools

İsim Açıklama Değer
apiVersiyonu API sürümü '2025-05-01'
isim Kaynak adı karakter dizisi

Kısıtlama -ları:
En az uzunluk = 1
Maksimum uzunluk = 12
Desen = ^[a-z][a-z0-9]{0,11}$ (gerekli)
özellikler Aracı havuzunun özellikleri. ManagedClusterAgentPoolProfileProperties
tür Kaynak türü 'Microsoft.ContainerService/managedClusters/agentPools'

AgentPoolGatewayProfile

İsim Açıklama Değer
publicIPPrefixSize Ağ geçidi aracı havuzu, genel çıkış sağlamak için her statik çıkış ağ geçidi için bir genel IPPrefix ilişkilendirir. Genel IPPrefix'in boyutu kullanıcı tarafından seçilmelidir. Aracı havuzundaki her düğüm, IPPrefix'ten bir IP ile atanır. BU nedenle IPPrefix boyutu, Ağ Geçidi aracı havuzunun boyutu üzerinde bir üst sınır görevi görür. Azure genel IPPrefix boyut sınırlaması nedeniyle geçerli değer aralığı [28, 31] (/31 = 2 düğüm/IP, /30 = 4 düğüm/IP, /29 = 8 düğüm/IP, /28 = 16 düğüm/IP). Varsayılan değer 31'dir. Int

Kısıtlama -ları:
Min değer = 28
Maksimum değer = 31

AgentPoolNetworkProfile

İsim Açıklama Değer
allowedHostPortlar Erişmesine izin verilen bağlantı noktası aralıkları. Belirtilen aralıkların çakışmasına izin verilir. Bağlantı Noktası Aralığı[]
uygulama güvenlik grupları Aracı havuzunun oluşturulduğunda ilişkilendirileceği uygulama güvenlik gruplarının kimlikleri. dize[]
nodePublicIPTags Örnek düzeyinde genel IP'lerin IPTag'leri. IPTag[]

AgentPoolSecurityProfile

İsim Açıklama Değer
enableSecureBoot Güvenli Önyükleme, yalnızca imzalı işletim sistemlerinin ve sürücülerin önyüklenmesini sağlayan Güvenilir Başlatma özelliğidir. Diğer ayrıntılar için bkz. aka.ms/aks/trustedlaunch. Belirtilmezse varsayılan değer false olur. Boole
enableVTPM vTPM, düğümde yerel olarak tutulan anahtarlar ve ölçümler için ayrılmış bir güvenli kasa yapılandırmaya yönelik bir Güvenilen Başlatma özelliğidir. Diğer ayrıntılar için bkz. aka.ms/aks/trustedlaunch. Belirtilmezse varsayılan değer false olur. Boole

AgentPoolStatus (AgentPoolStatus)

İsim Açıklama Değer

AgentPoolUpgradeSettings

İsim Açıklama Değer
drainTimeoutInMinutes Bir düğüm için boşaltma zaman aşımı. Podların çıkarılması ve düğüm başına düzgün sonlandırma için bekleme süresi (dakika cinsinden). Bu çıkarma bekleme süresi, pod kesintisi bütçelerini beklemeyi kabul eder. Bu süre aşılırsa yükseltme başarısız olur. Belirtilmezse, varsayılan değer 30 dakikadır. Int

Kısıtlama -ları:
Min değer = 1
Maksimum değer = 1440
maxSurge (Maksimum Dalgalanma) Yükseltme sırasında kullanılabilecek en fazla düğüm sayısı veya yüzdesi. Bu bir tamsayıya (ör. '5') veya yüzdeye (örneğin, '50%') ayarlanabilir. Yüzde belirtilirse, yükseltme sırasındaki toplam aracı havuzu boyutunun yüzdesidir. Yüzdeler için kesirli düğümler yukarı yuvarlanir. Belirtilmezse, varsayılan değer 10%'dir. En iyi yöntemler de dahil olmak üzere daha fazla bilgi için bkz. /azure/aks/upgrade-cluster String
maxUnavailable Yükseltme sırasında aynı anda kullanılamayabilecek en fazla düğüm sayısı veya yüzdesi. Bu bir tamsayıya (ör. '1') veya bir yüzdeye (ör. '5%') ayarlanabilir. Yüzde belirtilirse, yükseltme sırasındaki toplam aracı havuzu boyutunun yüzdesidir. Yüzdeler için kesirli düğümler yukarı yuvarlanir. Belirtilmezse, varsayılan değer 0'dır. En iyi yöntemler de dahil olmak üzere daha fazla bilgi için bkz. /azure/aks/upgrade-cluster String
nodeSoakDurationInMinutes Bir düğümün ıslatma süresi. Bir düğümü boşaltıp yeniden boyutlandırmadan ve sonraki düğüme geçmeden önce beklenmesi gereken süre (dakika cinsinden). Belirtilmezse, varsayılan değer 0 dakikadır. Int

Kısıtlama -ları:
En düşük değer = 0
Maksimum değer = 30
çizilemezNodeBehavior Yükseltme sırasında çizilemez düğümlerin davranışını tanımlar. Çizilemeyen düğümlerin en yaygın nedeni Pod Kesinti bütçeleri (PDB) olsa da pod sonlandırma yetkisiz kullanım süresi kalan düğüm başına boşaltma zaman aşımını aşıyor veya pod hala çalışıyor durumdaysa, ayrıca çizilemez düğümlere neden olabilir. 'Kordon'
'Zamanlama'

AgentPoolWindowsProfile

İsim Açıklama Değer
disableOutboundNat Windows düğümlerinde OutboundNAT'ın devre dışı bırakılıp bırakılmayacağı. Varsayılan değer yanlıştır. Giden NAT yalnızca küme outboundType NAT Ağ Geçidi ise ve Windows aracı havuzunda düğüm genel IP'sinin etkinleştirilmemesi durumunda devre dışı bırakılabilir. Boole

Oluşturma Verileri

İsim Açıklama Değer
sourceResourceId Bu, hedef nesneyi oluşturmak için kullanılacak kaynak nesnenin ARM kimliğidir. String

GPUProfile

İsim Açıklama Değer
sürücü GPU sürücülerinin yüklenip yüklenmeyeceği. Belirtilmediğinde, varsayılan olarak Yükle'dir. 'Yükle'
'Hiçbiri'

IPTag (IPTag)

İsim Açıklama Değer
ipTagType IP etiketi türü. Örnek: RoutingPreference. String
etiket Genel IP ile ilişkili IP etiketinin değeri. Örnek: İnternet. String

KubeletConfig

İsim Açıklama Değer
allowedUnsafeSysctls Güvenli olmayan sysctl veya güvenli olmayan sysctl desenlerinin izin verilen listesi (ile *biten). dize[]
containerLogMaxFiles Kapsayıcı için mevcut olabilecek en fazla kapsayıcı günlüğü dosyası sayısı. Sayı 2 ≥ olmalıdır. Int

Kısıtlama -ları:
Min değer = 2
containerLogMaxSizeMB Döndürülmeden önce kapsayıcı günlük dosyasının en büyük boyutu (örneğin 10Mi). Int
cpuCfsKotası CPU sınırlarını belirten kapsayıcılar için CPU CFS kota zorlaması etkinleştirildiyse. Varsayılan değer true'dur. Boole
cpuCfsQuotaPeriod CPU CFS kota dönemi değeri. Varsayılan değer :'100ms.' Geçerli değerler, isteğe bağlı kesir ve birim soneki içeren ondalık sayı dizisidir. Örneğin: '300ms', '2h45m'. Desteklenen birimler 'ns', 'us', 'ms', 's', 'm' ve 'h' birimleridir. String
cpuManagerİlkesi Kullanılacak CPU Yöneticisi ilkesi. Varsayılan değer :'none'. Daha fazla bilgi için bkz. Kubernetes CPU yönetim ilkeleri . İzin verilen değerler 'none' ve 'static' değerleridir. String
failSwapOn True olarak ayarlanırsa, düğümde değiştirme etkinse Kubelet'in başlatılamamasına neden olur. Boole
imageGcHighThreshold (Görüntü Altı) Görüntü çöp toplama işleminin her zaman çalıştırıldığı disk kullanımı yüzdesi. Görüntü çöp toplamayı devre dışı bırakmak için 100 olarak ayarlayın. Varsayılan değer 85% Int
imageGcLowThreshold Görüntü atık toplama işleminin hiçbir zaman çalıştırılamadan önce disk kullanımı yüzdesi. Bu ayar imageGcHighThreshold değerinden yüksek olamaz. Varsayılan değer 80% Int
podMaxPids Pod başına işlem sayısı üst sınırı. Int
topolojiManagerPolicy Kullanılacak Topoloji Yöneticisi ilkesi. Daha fazla bilgi için bkz. Kubernetes Topoloji Yöneticisi. Varsayılan değer :'none'. İzin verilen değerler 'none', 'best-effort', 'restricted' ve 'single-numa-node' değerleridir. String

LinuxOSConfig

İsim Açıklama Değer
swapFileSizeMB Her düğümde oluşturulacak takas dosyasının MB cinsinden boyutu. Int
sysctls (sysctl'ler) Linux aracı düğümleri için sysctl ayarları. SysctlConfig
şeffafKocamanSayfaBirleştir Çekirdeğin daha büyük sayfaları kullanılabilir hale getirmek için bellek sıkıştırmasını agresif bir şekilde kullanıp kullanmaması. Geçerli değerler :'always', 'defer', 'defer+madvise', 'madvise' ve 'never'. Varsayılan değer "madvise" şeklindedir. Daha fazla bilgi için bkz . Transparent Hugepages. String
transparentHugePageEnabled Saydam büyük sayfaların etkinleştirilip etkinleştirilmediği. Geçerli değerler 'always', 'madvise' ve 'never' değerleridir. Varsayılan değer "her zaman"dır. Daha fazla bilgi için bkz . Transparent Hugepages. String

ManagedClusterAgentPoolProfileProperties

İsim Açıklama Değer
kullanılabilirlik bölgeleri Düğümler için kullanılacak Kullanılabilirlik alanlarının listesi. Bu yalnızca AgentPoolType özelliği 'VirtualMachineScaleSets' olduğunda belirtilebilir. dize[]
capacityReservationGroupID AKS, belirtilen aracı havuzunu Kapasite Rezervasyon Grubu ile ilişkilendirir. String
sayı Docker kapsayıcılarını barındıracak aracıların (VM) sayısı. İzin verilen değerler, kullanıcı havuzları için 0 ile 1000 (dahil) arasında ve sistem havuzları için 1 ile 1000 (dahil) arasında olmalıdır. Varsayılan değer 1'dir. Int
oluşturmaVeri Düğüm havuzu bir anlık görüntü kullanılarak oluşturulacak/yükseltilecekse kaynak Anlık Görüntü Kimliğini belirtmek için kullanılacak CreationData. Oluşturma Verileri
enableAutoScaling Otomatik ölçeklendiricinin etkinleştirilip etkinleştirilmeyileceği Boole
enableEncryptionAtHost Konak tabanlı işletim sisteminin ve veri sürücüsü şifrelemenin etkinleştirilip etkinleştirilmeyileceği. Bu yalnızca belirli VM boyutlarında ve belirli Azure bölgelerinde desteklenir. Daha fazla bilgi için bkz. /azure/aks/enable-host-encryption Boole
enableFIPS FIPS özellikli işletim sisteminin kullanılıp kullanılmaymayacağı. Daha fazla ayrıntı için bkz. FIPS özellikli düğüm havuzu ekleme . Boole
enableNodePublicIP Her düğümün kendi genel IP'sini ayırıp ayırmadığı. Bazı senaryolar, düğüm havuzundaki düğümlerin kendi ayrılmış genel IP adreslerini almasını gerektirebilir. Yaygın bir senaryo, konsolun atlamaları en aza indirmek için bulut sanal makinesine doğrudan bağlantı sağlaması gereken oyun iş yüklerine yöneliktir. Daha fazla bilgi için bkz. Düğüm başına genel IP atama. Varsayılan değer false'tur. Boole
UltraSSD'yi etkinleştir UltraSSD'nin etkinleştirilip etkinleştirilmeyileceği Boole
ağ geçidi profili Ağ geçidi modunda yönetilen aracı havuzuna özgü profil. Aracı havuzu modu Ağ Geçidi değilse bu alan ayarlanamaz. AgentPoolGatewayProfile
gpuInstanceProfile Desteklenen GPU VM SKU'su için GPU MIG örnek profilini belirtmek üzere kullanılacak GPUInstanceProfile. 'MIG1g'
'MIG2g'
'MIG3g'
'MIG4g'
'MIG7g'
gpuProfile (İngilizce) Aracı Havuzu için GPU ayarları. GPUProfile
hostGroupID (Ana BilgisayarGrup Kimliği) Sanal makinelerin sağlanacağı Ayrılmış Konak Grubunun tam kaynak kimliği, yalnızca oluşturma senaryosunda kullanılır ve bir kez ayarlandıktan sonra değiştirilmesine izin verilmez. Bu şu biçimdedir: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Daha fazla bilgi için bkz. Azure ayrılmış konakları. String
kubeletConfig Aracı havuzu düğümlerinde Kubelet yapılandırması. KubeletConfig
kubeletDiskType emptyDir birimlerinin, kapsayıcı çalışma zamanı veri kökünün ve Kubelet kısa ömürlü depolamanın yerleşimini belirler. 'İşletim Sistemi'
'Geçici'
linuxOSConfig Linux aracı düğümlerinin işletim sistemi yapılandırması. LinuxOSConfig
maxCount (Maksimum Sayı) Otomatik ölçeklendirme için en fazla düğüm sayısı Int
maksimum Bölmeler Bir düğümde çalışabilecek en fazla pod sayısı. Int
messageOfTheDay Base64 kodlu Linux düğümleri için günün iletisi. Kod çözmeden sonra /etc/motd öğesine yazılacak base64 kodlanmış bir dize. Bu, Linux düğümleri için günün iletisinin özelleştirilmesini sağlar. Windows düğümleri için belirtilmemelidir. Statik bir dize olmalıdır (örneğin, ham olarak yazdırılır ve betik olarak yürütülmeyecektir). String
minCount Otomatik ölçeklendirme için en az düğüm sayısı Int
mod Aracı havuzunun modu. Bir kümenin her zaman en az bir 'Sistem' Aracı Havuzu olmalıdır. Aracı havuzu kısıtlamaları ve en iyi yöntemler hakkında ek bilgi için bkz. /azure/aks/use-system-pools 'Ağ Geçidi'
'Sistem'
'Kullanıcı'
ağ Profili Aracı havuzunun ağ ile ilgili ayarları. AgentPoolNetworkProfile
nodeLabels (düğüm etiketleri) Aracı havuzundaki tüm düğümlerde kalıcı hale getirmek için düğüm etiketleri. ManagedClusterAgentPoolProfilePropertiesNodeLabels
nodePublicIPPrefixID VM düğümlerinin IP'lerini kullanması gereken genel IP ön ek kimliği. Bu şu biçimdedir: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} String
nodeTaints (Düğümler) Düğüm havuzu oluşturma ve ölçeklendirme sırasında yeni düğümlere eklenen renk tonları. Örneğin, key=value:NoSchedule. dize[]
orchestratorVersion Kullanıcı tarafından belirtilen Kubernetes sürümü. Hem yama sürümü <major.minor.patch> (örneğin, 1.20.13) hem de <major.minor> (örneğin 1.20) desteklenir. <major.minor> belirtildiğinde, desteklenen en son GA düzeltme eki sürümü otomatik olarak seçilir. Küme oluşturulduktan sonra aynı <major.minor> ile güncelleştirilmesi (örneğin, 1.14.x -> 1.14) daha yeni bir düzeltme eki sürümü kullanılabilir olsa bile yükseltme tetiklemez. En iyi yöntem olarak, AKS kümesindeki tüm düğüm havuzlarını aynı Kubernetes sürümüne yükseltmeniz gerekir. Düğüm havuzu sürümü, denetim düzlemi ile aynı ana sürüme sahip olmalıdır. Düğüm havuzu ikincil sürümü, denetim düzlemi sürümünün iki ikincil sürümünde olmalıdır. Düğüm havuzu sürümü, denetim düzlemi sürümünden büyük olamaz. Daha fazla bilgi için bkz. Düğüm havuzunu yükseltme. String
İşletim SistemiBoyutuGB Ana/aracı havuzundaki her makine için disk boyutunu belirtmek için kullanılacak GB cinsinden işletim sistemi Disk Boyutu. 0 belirtirseniz, belirtilen vmSize değerine göre varsayılan osDisk boyutunu uygular. Int

Kısıtlama -ları:
En düşük değer = 0
Maksimum değer = 2048
osDiskType Aracı havuzundaki makineler için kullanılacak işletim sistemi disk türü. VM destekliyorsa ve istenen OSDiskSizeGB değerinden daha büyük bir önbellek diske sahipse varsayılan değer 'Kısa Ömürlü'dür. Aksi takdirde, varsayılan olarak 'Yönetilen' olarak gösterilir. Oluşturulduktan sonra değiştirilemez. Daha fazla bilgi için bkz. Kısa ömürlü işletim sistemi. 'Kısa Ömürlü'
'Yönetilen'
İşletim SistemiSKU'su Aracı havuzu tarafından kullanılan işletim sistemi SKU'su belirtir. OSType Linux ise varsayılan değer Ubuntu'dur. OSType Windows ise, Kubernetes <= 1,24 veya Windows2022 olduğunda varsayılan >değer Windows2019'dur. 'AzureLinux'
'CBLMariner'
'Ubuntu'
'Ubuntu2204'
'Windows2019'
'Windows2022'
işletim sistemi türü İşletim sistemi türü. Varsayılan değer Linux'tır. 'Linux'
'Pencereler'
podIPAllocationMode Pod IP Ayırma Modu. Aracı havuzundaki podlar için IP ayırma modu. podSubnetId ile kullanılmalıdır. Varsayılan değer :'DynamicIndividual'. 'Dinamik Bireysel'
'Statik Blok'
podSubnetID Podların başlatıldığında birleştirileceği alt ağın kimliği. Atlanırsa pod IP'leri düğüm alt ağından statik olarak atanır (daha fazla ayrıntı için bkz. vnetSubnetID). Bu şu biçimdedir: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} String
güç durumu Aracı Havuzunun çalışıp çalışmadığı veya durdurulduğu. Bir Aracı Havuzu ilk oluşturulduğunda başlangıçta Çalışıyor olur. Aracı Havuzu, bu alan Durduruldu olarak ayarlanarak durdurulabilir. Durdurulan Aracı Havuzu tüm VM'lerini durdurur ve faturalama ücretlerini tahakkuk etmez. Aracı Havuzu yalnızca Çalışıyor ve sağlama durumu Başarılı olduğunda durdurulabilir Güç Durumu
proximityPlacementGroupID YakınLık Yerleştirme Grubu kimliği. String
scaleDownMode (ölçek Küçültme Modu) Aracı Havuzunu ölçeklendirirken kullanılacak ölçeği azaltma modu. Bu, küme otomatik ölçeklendirici davranışını da etkiler. Belirtilmezse, varsayılan olarak Delete olur. 'Serbest Bırak'
'Sil'
Ölçek Kümesi İşten Çıkarma Politikası Kullanılacak Sanal Makine Ölçek Kümesi çıkarma ilkesi. scaleSetPriority değeri 'Spot' değilse bu belirtilemez. Belirtilmezse, varsayılan değer 'Sil'dir. 'Serbest Bırak'
'Sil'
ölçekSetÖncelik Sanal Makine Ölçek Kümesi önceliği. Belirtilmezse, varsayılan değer 'Normal'dir. 'Normal'
'Yer'
güvenlik profili Aracı havuzunun güvenlik ayarları. AgentPoolSecurityProfile
spotMaxFiyat Spot örnekler için ödeme yapmak istediğiniz maksimum fiyat (ABD Doları cinsinden). Olası değerler, varsayılan fiyatın isteğe bağlı olarak up-to belirten sıfırdan büyük veya -1 herhangi bir ondalık değerdir. Olası değerler, herhangi bir isteğe bağlı fiyat ödemeye istekli olduğunu gösteren sıfırdan veya -1 büyük herhangi bir ondalık değerdir. Spot fiyatlandırma hakkında daha fazla bilgi için bkz. spot VM fiyatlandırması Int
statü Aracı Havuzu hakkında salt okunur bilgiler içerir. AgentPoolStatus (AgentPoolStatus)
Etiketler Aracı havuzu sanal makine ölçek kümesinde kalıcı hale eklenecek etiketler. ManagedClusterAgentPoolProfilePropertiesTags
tür Aracı Havuzu türü. 'Kullanılabilirlik Seti'
'Sanal Makineler'
'VirtualMachineScaleSets'
upgradeSettings Aracı havuzunu yükseltme ayarları AgentPoolUpgradeSettings
virtualMachineNodesStatus VirtualMachines aracı havuzundaki düğümlerin durumu. VirtualMachineNodes[]
virtualMachinesProfile VirtualMachines aracı havuzundaki belirtimler. VirtualMachinesProfile
vmSize (Sanal Makine Boyutu) Aracı havuzu VM'lerinin boyutu. VM boyutu kullanılabilirliği bölgeye göre değişir. Düğüm yetersiz işlem kaynakları (bellek, cpu vb.) içeriyorsa podlar düzgün çalışmayabilir. Kısıtlanmış VM boyutları hakkında daha fazla ayrıntı için bkz. /azure/aks/quotas-skus-regions String
vnetSubnetID Aracı havuzu düğümlerinin ve isteğe bağlı olarak podların başlangıçta birleştirileceği alt ağın kimliği. Bu belirtilmezse, bir sanal ağ ve alt ağ oluşturulur ve kullanılır. PodSubnetID belirtilmezse, bu düğümler ve podlar için geçerlidir, aksi takdirde yalnızca düğümler için geçerlidir. Bu şu biçimdedir: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} String
windows Profili Windows aracı havuzunun belirli profili. AgentPoolWindowsProfile
workloadRuntime (İş YüküÇalışma Zamanı) Bir düğümün çalıştırabileceği iş yükü türünü belirler. 'OCIContainer'
'WasmWasi'

ManagedClusterAgentPoolProfilePropertiesNodeLabels

İsim Açıklama Değer

ManagedClusterAgentPoolProfilePropertiesTags

İsim Açıklama Değer

ManualScaleProfile (Kılavuzu)

İsim Açıklama Değer
sayı Düğüm sayısı. Int
boyut AKS 'Standard_E4s_v3', 'Standard_E16s_v3' veya 'Standard_D16s_v5' gibi oluşturma ve ölçeklendirme sırasında kullanacağı VM boyutu. String

Bağlantı Noktası Aralığı

İsim Açıklama Değer
portEnd Aralığa dahil edilen maksimum bağlantı noktası. 1 ile 65535 arasında olmalı ve portStart değerinden büyük veya buna eşit olmalıdır. Int

Kısıtlama -ları:
Min değer = 1
Maksimum değer = 65535
bağlantı noktası Başlat Aralığa dahil edilen en düşük bağlantı noktası. 1 ile 65535 arasında olmalı ve portEnd değerinden küçük veya buna eşit olmalıdır. Int

Kısıtlama -ları:
Min değer = 1
Maksimum değer = 65535
protokol Bağlantı noktasının ağ protokolü. 'TCP'
'UDP'

Güç Durumu

İsim Açıklama Değer
kod Kümenin Çalışıyor mu yoksa Durduruldu mu olduğunu bildirir 'Çalışıyor'
'Durduruldu'

Ölçek Profili

İsim Açıklama Değer
el ile VirtualMachines aracı havuzunun sabit bir boyuta ölçeklendirilmesiyle ilgili belirtimler. ManualScaleProfile[]

SysctlConfig

İsim Açıklama Değer
fsAioMaxNr Sysctl ayarı fs.aio-max-nr. Int
fsFileMax Sysctl ayarı fs.file-max. Int
fsInotifyMaxUserWatches Sysctl ayarı fs.inotify.max_user_watches. Int
fsNrAçık Sysctl ayarı fs.nr_open. Int
kernelThreadsMax Kernel.threads-max sysctl ayarı. Int
netCoreNetdevMaxBacklog Sysctl ayarı net.core.netdev_max_backlog. Int
netCoreOptmemMax (NetCoreOptmemMax) Sysctl ayarı net.core.optmem_max. Int
netCoreRmemDefault Sysctl ayarı net.core.rmem_default. Int
netCoreRmemMax Sysctl ayarı net.core.rmem_max. Int
netCoreSomaxconn Net.core.somaxconn sysctl ayarı. Int
netCoreWmemDefault Sysctl ayarı net.core.wmem_default. Int
netCoreWmemMax Sysctl ayarı net.core.wmem_max. Int
netIpv4IpLocalPortRange Sysctl ayarı net.ipv4.ip_local_port_range. String
netIpv4NeighDefaultGcThresh1 Sysctl ayarı net.ipv4.neigh.default.gc_thresh1. Int
netIpv4NeighDefaultGcThresh2 Sysctl ayarı net.ipv4.neigh.default.gc_thresh2. Int
netIpv4NeighDefaultGcThresh3 Sysctl ayarı net.ipv4.neigh.default.gc_thresh3. Int
netIpv4TcpFinTimeout Sysctl ayarı net.ipv4.tcp_fin_timeout. Int
netIpv4TcpkeepaliveIntvl Sysctl ayarı net.ipv4.tcp_keepalive_intvl. Int

Kısıtlama -ları:
En düşük değer = 10
Maksimum değer = 90
netIpv4TcpKeepaliveProbes Sysctl ayarı net.ipv4.tcp_keepalive_probes. Int
netIpv4TcpKeepaliveTime Sysctl ayarı net.ipv4.tcp_keepalive_time. Int
netIpv4TcpMaxSynBacklog Sysctl ayarı net.ipv4.tcp_max_syn_backlog. Int
netIpv4TcpMaxTwBuckets Sysctl ayarı net.ipv4.tcp_max_tw_buckets. Int
netIpv4TcpTwReuse Sysctl ayarı net.ipv4.tcp_tw_reuse. Boole
netNetfilterNfConntrackBuckets Sysctl ayarı net.netfilter.nf_conntrack_buckets. Int

Kısıtlama -ları:
Min değer = 65536
En yüksek değer = 524288
netNetfilterNfConntrackMax Sysctl ayarı net.netfilter.nf_conntrack_max. Int

Kısıtlama -ları:
En düşük değer = 131072
En yüksek değer = 2097152
vmMaxMapCount Sysctl ayarı vm.max_map_count. Int
vmSwappiness (Sanal Makine Değişimi) Sysctl ayarı vm.swappiness. Int
vmVfsÖnbellek Basıncı Sysctl ayarı vm.vfs_cache_pressure. Int

Sanal Makine Düğümleri

İsim Açıklama Değer
sayı Düğüm sayısı. Int
boyut Bu düğüm grubunu barındırmak için kullanılan aracıların VM boyutu. String

VirtualMachinesProfile

İsim Açıklama Değer
ölçek VirtualMachines aracı havuzunu ölçeklendirmeye ilişkin belirtimler. Ölçek Profili

Kullanım Örnekleri

Azure Hızlı Başlangıç Şablonları

Aşağıdaki Azure Hızlı Başlangıç şablonları bu kaynak türünü dağıtmak.

Şablon Açıklama
Azure ML için AKS kümesi dağıtma

Azure’a dağıtın 		Bu şablon, Azure ML'ye eklenebilen, sabit uyumlu bir AKS kümesi dağıtmanıza olanak tanır

Terraform (AzAPI sağlayıcısı) kaynak tanımı

managedClusters/agentPools kaynak türü, aşağıdakileri hedefleyen işlemlerle dağıtılabilir:

  • Kaynak grupları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.ContainerService/managedClusters/agentPools kaynağı oluşturmak için şablonunuza aşağıdaki Terraform'u ekleyin.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerService/managedClusters/agentPools@2025-05-01"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      availabilityZones = [
        "string"
      ]
      capacityReservationGroupID = "string"
      count = int
      creationData = {
        sourceResourceId = "string"
      }
      enableAutoScaling = bool
      enableEncryptionAtHost = bool
      enableFIPS = bool
      enableNodePublicIP = bool
      enableUltraSSD = bool
      gatewayProfile = {
        publicIPPrefixSize = int
      }
      gpuInstanceProfile = "string"
      gpuProfile = {
        driver = "string"
      }
      hostGroupID = "string"
      kubeletConfig = {
        allowedUnsafeSysctls = [
          "string"
        ]
        containerLogMaxFiles = int
        containerLogMaxSizeMB = int
        cpuCfsQuota = bool
        cpuCfsQuotaPeriod = "string"
        cpuManagerPolicy = "string"
        failSwapOn = bool
        imageGcHighThreshold = int
        imageGcLowThreshold = int
        podMaxPids = int
        topologyManagerPolicy = "string"
      }
      kubeletDiskType = "string"
      linuxOSConfig = {
        swapFileSizeMB = int
        sysctls = {
          fsAioMaxNr = int
          fsFileMax = int
          fsInotifyMaxUserWatches = int
          fsNrOpen = int
          kernelThreadsMax = int
          netCoreNetdevMaxBacklog = int
          netCoreOptmemMax = int
          netCoreRmemDefault = int
          netCoreRmemMax = int
          netCoreSomaxconn = int
          netCoreWmemDefault = int
          netCoreWmemMax = int
          netIpv4IpLocalPortRange = "string"
          netIpv4NeighDefaultGcThresh1 = int
          netIpv4NeighDefaultGcThresh2 = int
          netIpv4NeighDefaultGcThresh3 = int
          netIpv4TcpFinTimeout = int
          netIpv4TcpkeepaliveIntvl = int
          netIpv4TcpKeepaliveProbes = int
          netIpv4TcpKeepaliveTime = int
          netIpv4TcpMaxSynBacklog = int
          netIpv4TcpMaxTwBuckets = int
          netIpv4TcpTwReuse = bool
          netNetfilterNfConntrackBuckets = int
          netNetfilterNfConntrackMax = int
          vmMaxMapCount = int
          vmSwappiness = int
          vmVfsCachePressure = int
        }
        transparentHugePageDefrag = "string"
        transparentHugePageEnabled = "string"
      }
      maxCount = int
      maxPods = int
      messageOfTheDay = "string"
      minCount = int
      mode = "string"
      networkProfile = {
        allowedHostPorts = [
          {
            portEnd = int
            portStart = int
            protocol = "string"
          }
        ]
        applicationSecurityGroups = [
          "string"
        ]
        nodePublicIPTags = [
          {
            ipTagType = "string"
            tag = "string"
          }
        ]
      }
      nodeLabels = {
        {customized property} = "string"
      }
      nodePublicIPPrefixID = "string"
      nodeTaints = [
        "string"
      ]
      orchestratorVersion = "string"
      osDiskSizeGB = int
      osDiskType = "string"
      osSKU = "string"
      osType = "string"
      podIPAllocationMode = "string"
      podSubnetID = "string"
      powerState = {
        code = "string"
      }
      proximityPlacementGroupID = "string"
      scaleDownMode = "string"
      scaleSetEvictionPolicy = "string"
      scaleSetPriority = "string"
      securityProfile = {
        enableSecureBoot = bool
        enableVTPM = bool
      }
      spotMaxPrice = int
      status = {
      }
      tags = {
        {customized property} = "string"
      }
      type = "string"
      upgradeSettings = {
        drainTimeoutInMinutes = int
        maxSurge = "string"
        maxUnavailable = "string"
        nodeSoakDurationInMinutes = int
        undrainableNodeBehavior = "string"
      }
      virtualMachineNodesStatus = [
        {
          count = int
          size = "string"
        }
      ]
      virtualMachinesProfile = {
        scale = {
          manual = [
            {
              count = int
              size = "string"
            }
          ]
        }
      }
      vmSize = "string"
      vnetSubnetID = "string"
      windowsProfile = {
        disableOutboundNat = bool
      }
      workloadRuntime = "string"
    }
  }
}

Özellik Değerleri

Microsoft.ContainerService/managedClusters/agentPools

İsim Açıklama Değer
isim Kaynak adı karakter dizisi

Kısıtlama -ları:
En az uzunluk = 1
Maksimum uzunluk = 12
Desen = ^[a-z][a-z0-9]{0,11}$ (gerekli)
ebeveyn_kimlik Bu kaynağın üst öğesi olan kaynağın kimliği. Tür kaynağı kimliği: managedClusters
özellikler Aracı havuzunun özellikleri. ManagedClusterAgentPoolProfileProperties
tür Kaynak türü "Microsoft.ContainerService/managedClusters/agentPools@2025-05-01"

AgentPoolGatewayProfile

İsim Açıklama Değer
publicIPPrefixSize Ağ geçidi aracı havuzu, genel çıkış sağlamak için her statik çıkış ağ geçidi için bir genel IPPrefix ilişkilendirir. Genel IPPrefix'in boyutu kullanıcı tarafından seçilmelidir. Aracı havuzundaki her düğüm, IPPrefix'ten bir IP ile atanır. BU nedenle IPPrefix boyutu, Ağ Geçidi aracı havuzunun boyutu üzerinde bir üst sınır görevi görür. Azure genel IPPrefix boyut sınırlaması nedeniyle geçerli değer aralığı [28, 31] (/31 = 2 düğüm/IP, /30 = 4 düğüm/IP, /29 = 8 düğüm/IP, /28 = 16 düğüm/IP). Varsayılan değer 31'dir. Int

Kısıtlama -ları:
Min değer = 28
Maksimum değer = 31

AgentPoolNetworkProfile

İsim Açıklama Değer
allowedHostPortlar Erişmesine izin verilen bağlantı noktası aralıkları. Belirtilen aralıkların çakışmasına izin verilir. Bağlantı Noktası Aralığı[]
uygulama güvenlik grupları Aracı havuzunun oluşturulduğunda ilişkilendirileceği uygulama güvenlik gruplarının kimlikleri. dize[]
nodePublicIPTags Örnek düzeyinde genel IP'lerin IPTag'leri. IPTag[]

AgentPoolSecurityProfile

İsim Açıklama Değer
enableSecureBoot Güvenli Önyükleme, yalnızca imzalı işletim sistemlerinin ve sürücülerin önyüklenmesini sağlayan Güvenilir Başlatma özelliğidir. Diğer ayrıntılar için bkz. aka.ms/aks/trustedlaunch. Belirtilmezse varsayılan değer false olur. Boole
enableVTPM vTPM, düğümde yerel olarak tutulan anahtarlar ve ölçümler için ayrılmış bir güvenli kasa yapılandırmaya yönelik bir Güvenilen Başlatma özelliğidir. Diğer ayrıntılar için bkz. aka.ms/aks/trustedlaunch. Belirtilmezse varsayılan değer false olur. Boole

AgentPoolStatus (AgentPoolStatus)

İsim Açıklama Değer

AgentPoolUpgradeSettings

İsim Açıklama Değer
drainTimeoutInMinutes Bir düğüm için boşaltma zaman aşımı. Podların çıkarılması ve düğüm başına düzgün sonlandırma için bekleme süresi (dakika cinsinden). Bu çıkarma bekleme süresi, pod kesintisi bütçelerini beklemeyi kabul eder. Bu süre aşılırsa yükseltme başarısız olur. Belirtilmezse, varsayılan değer 30 dakikadır. Int

Kısıtlama -ları:
Min değer = 1
Maksimum değer = 1440
maxSurge (Maksimum Dalgalanma) Yükseltme sırasında kullanılabilecek en fazla düğüm sayısı veya yüzdesi. Bu bir tamsayıya (ör. '5') veya yüzdeye (örneğin, '50%') ayarlanabilir. Yüzde belirtilirse, yükseltme sırasındaki toplam aracı havuzu boyutunun yüzdesidir. Yüzdeler için kesirli düğümler yukarı yuvarlanir. Belirtilmezse, varsayılan değer 10%'dir. En iyi yöntemler de dahil olmak üzere daha fazla bilgi için bkz. /azure/aks/upgrade-cluster String
maxUnavailable Yükseltme sırasında aynı anda kullanılamayabilecek en fazla düğüm sayısı veya yüzdesi. Bu bir tamsayıya (ör. '1') veya bir yüzdeye (ör. '5%') ayarlanabilir. Yüzde belirtilirse, yükseltme sırasındaki toplam aracı havuzu boyutunun yüzdesidir. Yüzdeler için kesirli düğümler yukarı yuvarlanir. Belirtilmezse, varsayılan değer 0'dır. En iyi yöntemler de dahil olmak üzere daha fazla bilgi için bkz. /azure/aks/upgrade-cluster String
nodeSoakDurationInMinutes Bir düğümün ıslatma süresi. Bir düğümü boşaltıp yeniden boyutlandırmadan ve sonraki düğüme geçmeden önce beklenmesi gereken süre (dakika cinsinden). Belirtilmezse, varsayılan değer 0 dakikadır. Int

Kısıtlama -ları:
En düşük değer = 0
Maksimum değer = 30
çizilemezNodeBehavior Yükseltme sırasında çizilemez düğümlerin davranışını tanımlar. Çizilemeyen düğümlerin en yaygın nedeni Pod Kesinti bütçeleri (PDB) olsa da pod sonlandırma yetkisiz kullanım süresi kalan düğüm başına boşaltma zaman aşımını aşıyor veya pod hala çalışıyor durumdaysa, ayrıca çizilemez düğümlere neden olabilir. 'Kordon'
'Zamanlama'

AgentPoolWindowsProfile

İsim Açıklama Değer
disableOutboundNat Windows düğümlerinde OutboundNAT'ın devre dışı bırakılıp bırakılmayacağı. Varsayılan değer yanlıştır. Giden NAT yalnızca küme outboundType NAT Ağ Geçidi ise ve Windows aracı havuzunda düğüm genel IP'sinin etkinleştirilmemesi durumunda devre dışı bırakılabilir. Boole

Oluşturma Verileri

İsim Açıklama Değer
sourceResourceId Bu, hedef nesneyi oluşturmak için kullanılacak kaynak nesnenin ARM kimliğidir. String

GPUProfile

İsim Açıklama Değer
sürücü GPU sürücülerinin yüklenip yüklenmeyeceği. Belirtilmediğinde, varsayılan olarak Yükle'dir. 'Yükle'
'Hiçbiri'

IPTag (IPTag)

İsim Açıklama Değer
ipTagType IP etiketi türü. Örnek: RoutingPreference. String
etiket Genel IP ile ilişkili IP etiketinin değeri. Örnek: İnternet. String

KubeletConfig

İsim Açıklama Değer
allowedUnsafeSysctls Güvenli olmayan sysctl veya güvenli olmayan sysctl desenlerinin izin verilen listesi (ile *biten). dize[]
containerLogMaxFiles Kapsayıcı için mevcut olabilecek en fazla kapsayıcı günlüğü dosyası sayısı. Sayı 2 ≥ olmalıdır. Int

Kısıtlama -ları:
Min değer = 2
containerLogMaxSizeMB Döndürülmeden önce kapsayıcı günlük dosyasının en büyük boyutu (örneğin 10Mi). Int
cpuCfsKotası CPU sınırlarını belirten kapsayıcılar için CPU CFS kota zorlaması etkinleştirildiyse. Varsayılan değer true'dur. Boole
cpuCfsQuotaPeriod CPU CFS kota dönemi değeri. Varsayılan değer :'100ms.' Geçerli değerler, isteğe bağlı kesir ve birim soneki içeren ondalık sayı dizisidir. Örneğin: '300ms', '2h45m'. Desteklenen birimler 'ns', 'us', 'ms', 's', 'm' ve 'h' birimleridir. String
cpuManagerİlkesi Kullanılacak CPU Yöneticisi ilkesi. Varsayılan değer :'none'. Daha fazla bilgi için bkz. Kubernetes CPU yönetim ilkeleri . İzin verilen değerler 'none' ve 'static' değerleridir. String
failSwapOn True olarak ayarlanırsa, düğümde değiştirme etkinse Kubelet'in başlatılamamasına neden olur. Boole
imageGcHighThreshold (Görüntü Altı) Görüntü çöp toplama işleminin her zaman çalıştırıldığı disk kullanımı yüzdesi. Görüntü çöp toplamayı devre dışı bırakmak için 100 olarak ayarlayın. Varsayılan değer 85% Int
imageGcLowThreshold Görüntü atık toplama işleminin hiçbir zaman çalıştırılamadan önce disk kullanımı yüzdesi. Bu ayar imageGcHighThreshold değerinden yüksek olamaz. Varsayılan değer 80% Int
podMaxPids Pod başına işlem sayısı üst sınırı. Int
topolojiManagerPolicy Kullanılacak Topoloji Yöneticisi ilkesi. Daha fazla bilgi için bkz. Kubernetes Topoloji Yöneticisi. Varsayılan değer :'none'. İzin verilen değerler 'none', 'best-effort', 'restricted' ve 'single-numa-node' değerleridir. String

LinuxOSConfig

İsim Açıklama Değer
swapFileSizeMB Her düğümde oluşturulacak takas dosyasının MB cinsinden boyutu. Int
sysctls (sysctl'ler) Linux aracı düğümleri için sysctl ayarları. SysctlConfig
şeffafKocamanSayfaBirleştir Çekirdeğin daha büyük sayfaları kullanılabilir hale getirmek için bellek sıkıştırmasını agresif bir şekilde kullanıp kullanmaması. Geçerli değerler :'always', 'defer', 'defer+madvise', 'madvise' ve 'never'. Varsayılan değer "madvise" şeklindedir. Daha fazla bilgi için bkz . Transparent Hugepages. String
transparentHugePageEnabled Saydam büyük sayfaların etkinleştirilip etkinleştirilmediği. Geçerli değerler 'always', 'madvise' ve 'never' değerleridir. Varsayılan değer "her zaman"dır. Daha fazla bilgi için bkz . Transparent Hugepages. String

ManagedClusterAgentPoolProfileProperties

İsim Açıklama Değer
kullanılabilirlik bölgeleri Düğümler için kullanılacak Kullanılabilirlik alanlarının listesi. Bu yalnızca AgentPoolType özelliği 'VirtualMachineScaleSets' olduğunda belirtilebilir. dize[]
capacityReservationGroupID AKS, belirtilen aracı havuzunu Kapasite Rezervasyon Grubu ile ilişkilendirir. String
sayı Docker kapsayıcılarını barındıracak aracıların (VM) sayısı. İzin verilen değerler, kullanıcı havuzları için 0 ile 1000 (dahil) arasında ve sistem havuzları için 1 ile 1000 (dahil) arasında olmalıdır. Varsayılan değer 1'dir. Int
oluşturmaVeri Düğüm havuzu bir anlık görüntü kullanılarak oluşturulacak/yükseltilecekse kaynak Anlık Görüntü Kimliğini belirtmek için kullanılacak CreationData. Oluşturma Verileri
enableAutoScaling Otomatik ölçeklendiricinin etkinleştirilip etkinleştirilmeyileceği Boole
enableEncryptionAtHost Konak tabanlı işletim sisteminin ve veri sürücüsü şifrelemenin etkinleştirilip etkinleştirilmeyileceği. Bu yalnızca belirli VM boyutlarında ve belirli Azure bölgelerinde desteklenir. Daha fazla bilgi için bkz. /azure/aks/enable-host-encryption Boole
enableFIPS FIPS özellikli işletim sisteminin kullanılıp kullanılmaymayacağı. Daha fazla ayrıntı için bkz. FIPS özellikli düğüm havuzu ekleme . Boole
enableNodePublicIP Her düğümün kendi genel IP'sini ayırıp ayırmadığı. Bazı senaryolar, düğüm havuzundaki düğümlerin kendi ayrılmış genel IP adreslerini almasını gerektirebilir. Yaygın bir senaryo, konsolun atlamaları en aza indirmek için bulut sanal makinesine doğrudan bağlantı sağlaması gereken oyun iş yüklerine yöneliktir. Daha fazla bilgi için bkz. Düğüm başına genel IP atama. Varsayılan değer false'tur. Boole
UltraSSD'yi etkinleştir UltraSSD'nin etkinleştirilip etkinleştirilmeyileceği Boole
ağ geçidi profili Ağ geçidi modunda yönetilen aracı havuzuna özgü profil. Aracı havuzu modu Ağ Geçidi değilse bu alan ayarlanamaz. AgentPoolGatewayProfile
gpuInstanceProfile Desteklenen GPU VM SKU'su için GPU MIG örnek profilini belirtmek üzere kullanılacak GPUInstanceProfile. 'MIG1g'
'MIG2g'
'MIG3g'
'MIG4g'
'MIG7g'
gpuProfile (İngilizce) Aracı Havuzu için GPU ayarları. GPUProfile
hostGroupID (Ana BilgisayarGrup Kimliği) Sanal makinelerin sağlanacağı Ayrılmış Konak Grubunun tam kaynak kimliği, yalnızca oluşturma senaryosunda kullanılır ve bir kez ayarlandıktan sonra değiştirilmesine izin verilmez. Bu şu biçimdedir: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Daha fazla bilgi için bkz. Azure ayrılmış konakları. String
kubeletConfig Aracı havuzu düğümlerinde Kubelet yapılandırması. KubeletConfig
kubeletDiskType emptyDir birimlerinin, kapsayıcı çalışma zamanı veri kökünün ve Kubelet kısa ömürlü depolamanın yerleşimini belirler. 'İşletim Sistemi'
'Geçici'
linuxOSConfig Linux aracı düğümlerinin işletim sistemi yapılandırması. LinuxOSConfig
maxCount (Maksimum Sayı) Otomatik ölçeklendirme için en fazla düğüm sayısı Int
maksimum Bölmeler Bir düğümde çalışabilecek en fazla pod sayısı. Int
messageOfTheDay Base64 kodlu Linux düğümleri için günün iletisi. Kod çözmeden sonra /etc/motd öğesine yazılacak base64 kodlanmış bir dize. Bu, Linux düğümleri için günün iletisinin özelleştirilmesini sağlar. Windows düğümleri için belirtilmemelidir. Statik bir dize olmalıdır (örneğin, ham olarak yazdırılır ve betik olarak yürütülmeyecektir). String
minCount Otomatik ölçeklendirme için en az düğüm sayısı Int
mod Aracı havuzunun modu. Bir kümenin her zaman en az bir 'Sistem' Aracı Havuzu olmalıdır. Aracı havuzu kısıtlamaları ve en iyi yöntemler hakkında ek bilgi için bkz. /azure/aks/use-system-pools 'Ağ Geçidi'
'Sistem'
'Kullanıcı'
ağ Profili Aracı havuzunun ağ ile ilgili ayarları. AgentPoolNetworkProfile
nodeLabels (düğüm etiketleri) Aracı havuzundaki tüm düğümlerde kalıcı hale getirmek için düğüm etiketleri. ManagedClusterAgentPoolProfilePropertiesNodeLabels
nodePublicIPPrefixID VM düğümlerinin IP'lerini kullanması gereken genel IP ön ek kimliği. Bu şu biçimdedir: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} String
nodeTaints (Düğümler) Düğüm havuzu oluşturma ve ölçeklendirme sırasında yeni düğümlere eklenen renk tonları. Örneğin, key=value:NoSchedule. dize[]
orchestratorVersion Kullanıcı tarafından belirtilen Kubernetes sürümü. Hem yama sürümü <major.minor.patch> (örneğin, 1.20.13) hem de <major.minor> (örneğin 1.20) desteklenir. <major.minor> belirtildiğinde, desteklenen en son GA düzeltme eki sürümü otomatik olarak seçilir. Küme oluşturulduktan sonra aynı <major.minor> ile güncelleştirilmesi (örneğin, 1.14.x -> 1.14) daha yeni bir düzeltme eki sürümü kullanılabilir olsa bile yükseltme tetiklemez. En iyi yöntem olarak, AKS kümesindeki tüm düğüm havuzlarını aynı Kubernetes sürümüne yükseltmeniz gerekir. Düğüm havuzu sürümü, denetim düzlemi ile aynı ana sürüme sahip olmalıdır. Düğüm havuzu ikincil sürümü, denetim düzlemi sürümünün iki ikincil sürümünde olmalıdır. Düğüm havuzu sürümü, denetim düzlemi sürümünden büyük olamaz. Daha fazla bilgi için bkz. Düğüm havuzunu yükseltme. String
İşletim SistemiBoyutuGB Ana/aracı havuzundaki her makine için disk boyutunu belirtmek için kullanılacak GB cinsinden işletim sistemi Disk Boyutu. 0 belirtirseniz, belirtilen vmSize değerine göre varsayılan osDisk boyutunu uygular. Int

Kısıtlama -ları:
En düşük değer = 0
Maksimum değer = 2048
osDiskType Aracı havuzundaki makineler için kullanılacak işletim sistemi disk türü. VM destekliyorsa ve istenen OSDiskSizeGB değerinden daha büyük bir önbellek diske sahipse varsayılan değer 'Kısa Ömürlü'dür. Aksi takdirde, varsayılan olarak 'Yönetilen' olarak gösterilir. Oluşturulduktan sonra değiştirilemez. Daha fazla bilgi için bkz. Kısa ömürlü işletim sistemi. 'Kısa Ömürlü'
'Yönetilen'
İşletim SistemiSKU'su Aracı havuzu tarafından kullanılan işletim sistemi SKU'su belirtir. OSType Linux ise varsayılan değer Ubuntu'dur. OSType Windows ise, Kubernetes <= 1,24 veya Windows2022 olduğunda varsayılan >değer Windows2019'dur. 'AzureLinux'
'CBLMariner'
'Ubuntu'
'Ubuntu2204'
'Windows2019'
'Windows2022'
işletim sistemi türü İşletim sistemi türü. Varsayılan değer Linux'tır. 'Linux'
'Pencereler'
podIPAllocationMode Pod IP Ayırma Modu. Aracı havuzundaki podlar için IP ayırma modu. podSubnetId ile kullanılmalıdır. Varsayılan değer :'DynamicIndividual'. 'Dinamik Bireysel'
'Statik Blok'
podSubnetID Podların başlatıldığında birleştirileceği alt ağın kimliği. Atlanırsa pod IP'leri düğüm alt ağından statik olarak atanır (daha fazla ayrıntı için bkz. vnetSubnetID). Bu şu biçimdedir: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} String
güç durumu Aracı Havuzunun çalışıp çalışmadığı veya durdurulduğu. Bir Aracı Havuzu ilk oluşturulduğunda başlangıçta Çalışıyor olur. Aracı Havuzu, bu alan Durduruldu olarak ayarlanarak durdurulabilir. Durdurulan Aracı Havuzu tüm VM'lerini durdurur ve faturalama ücretlerini tahakkuk etmez. Aracı Havuzu yalnızca Çalışıyor ve sağlama durumu Başarılı olduğunda durdurulabilir Güç Durumu
proximityPlacementGroupID YakınLık Yerleştirme Grubu kimliği. String
scaleDownMode (ölçek Küçültme Modu) Aracı Havuzunu ölçeklendirirken kullanılacak ölçeği azaltma modu. Bu, küme otomatik ölçeklendirici davranışını da etkiler. Belirtilmezse, varsayılan olarak Delete olur. 'Serbest Bırak'
'Sil'
Ölçek Kümesi İşten Çıkarma Politikası Kullanılacak Sanal Makine Ölçek Kümesi çıkarma ilkesi. scaleSetPriority değeri 'Spot' değilse bu belirtilemez. Belirtilmezse, varsayılan değer 'Sil'dir. 'Serbest Bırak'
'Sil'
ölçekSetÖncelik Sanal Makine Ölçek Kümesi önceliği. Belirtilmezse, varsayılan değer 'Normal'dir. 'Normal'
'Yer'
güvenlik profili Aracı havuzunun güvenlik ayarları. AgentPoolSecurityProfile
spotMaxFiyat Spot örnekler için ödeme yapmak istediğiniz maksimum fiyat (ABD Doları cinsinden). Olası değerler, varsayılan fiyatın isteğe bağlı olarak up-to belirten sıfırdan büyük veya -1 herhangi bir ondalık değerdir. Olası değerler, herhangi bir isteğe bağlı fiyat ödemeye istekli olduğunu gösteren sıfırdan veya -1 büyük herhangi bir ondalık değerdir. Spot fiyatlandırma hakkında daha fazla bilgi için bkz. spot VM fiyatlandırması Int
statü Aracı Havuzu hakkında salt okunur bilgiler içerir. AgentPoolStatus (AgentPoolStatus)
Etiketler Aracı havuzu sanal makine ölçek kümesinde kalıcı hale eklenecek etiketler. ManagedClusterAgentPoolProfilePropertiesTags
tür Aracı Havuzu türü. 'Kullanılabilirlik Seti'
'Sanal Makineler'
'VirtualMachineScaleSets'
upgradeSettings Aracı havuzunu yükseltme ayarları AgentPoolUpgradeSettings
virtualMachineNodesStatus VirtualMachines aracı havuzundaki düğümlerin durumu. VirtualMachineNodes[]
virtualMachinesProfile VirtualMachines aracı havuzundaki belirtimler. VirtualMachinesProfile
vmSize (Sanal Makine Boyutu) Aracı havuzu VM'lerinin boyutu. VM boyutu kullanılabilirliği bölgeye göre değişir. Düğüm yetersiz işlem kaynakları (bellek, cpu vb.) içeriyorsa podlar düzgün çalışmayabilir. Kısıtlanmış VM boyutları hakkında daha fazla ayrıntı için bkz. /azure/aks/quotas-skus-regions String
vnetSubnetID Aracı havuzu düğümlerinin ve isteğe bağlı olarak podların başlangıçta birleştirileceği alt ağın kimliği. Bu belirtilmezse, bir sanal ağ ve alt ağ oluşturulur ve kullanılır. PodSubnetID belirtilmezse, bu düğümler ve podlar için geçerlidir, aksi takdirde yalnızca düğümler için geçerlidir. Bu şu biçimdedir: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} String
windows Profili Windows aracı havuzunun belirli profili. AgentPoolWindowsProfile
workloadRuntime (İş YüküÇalışma Zamanı) Bir düğümün çalıştırabileceği iş yükü türünü belirler. 'OCIContainer'
'WasmWasi'

ManagedClusterAgentPoolProfilePropertiesNodeLabels

İsim Açıklama Değer

ManagedClusterAgentPoolProfilePropertiesTags

İsim Açıklama Değer

ManualScaleProfile (Kılavuzu)

İsim Açıklama Değer
sayı Düğüm sayısı. Int
boyut AKS 'Standard_E4s_v3', 'Standard_E16s_v3' veya 'Standard_D16s_v5' gibi oluşturma ve ölçeklendirme sırasında kullanacağı VM boyutu. String

Bağlantı Noktası Aralığı

İsim Açıklama Değer
portEnd Aralığa dahil edilen maksimum bağlantı noktası. 1 ile 65535 arasında olmalı ve portStart değerinden büyük veya buna eşit olmalıdır. Int

Kısıtlama -ları:
Min değer = 1
Maksimum değer = 65535
bağlantı noktası Başlat Aralığa dahil edilen en düşük bağlantı noktası. 1 ile 65535 arasında olmalı ve portEnd değerinden küçük veya buna eşit olmalıdır. Int

Kısıtlama -ları:
Min değer = 1
Maksimum değer = 65535
protokol Bağlantı noktasının ağ protokolü. 'TCP'
'UDP'

Güç Durumu

İsim Açıklama Değer
kod Kümenin Çalışıyor mu yoksa Durduruldu mu olduğunu bildirir 'Çalışıyor'
'Durduruldu'

Ölçek Profili

İsim Açıklama Değer
el ile VirtualMachines aracı havuzunun sabit bir boyuta ölçeklendirilmesiyle ilgili belirtimler. ManualScaleProfile[]

SysctlConfig

İsim Açıklama Değer
fsAioMaxNr Sysctl ayarı fs.aio-max-nr. Int
fsFileMax Sysctl ayarı fs.file-max. Int
fsInotifyMaxUserWatches Sysctl ayarı fs.inotify.max_user_watches. Int
fsNrAçık Sysctl ayarı fs.nr_open. Int
kernelThreadsMax Kernel.threads-max sysctl ayarı. Int
netCoreNetdevMaxBacklog Sysctl ayarı net.core.netdev_max_backlog. Int
netCoreOptmemMax (NetCoreOptmemMax) Sysctl ayarı net.core.optmem_max. Int
netCoreRmemDefault Sysctl ayarı net.core.rmem_default. Int
netCoreRmemMax Sysctl ayarı net.core.rmem_max. Int
netCoreSomaxconn Net.core.somaxconn sysctl ayarı. Int
netCoreWmemDefault Sysctl ayarı net.core.wmem_default. Int
netCoreWmemMax Sysctl ayarı net.core.wmem_max. Int
netIpv4IpLocalPortRange Sysctl ayarı net.ipv4.ip_local_port_range. String
netIpv4NeighDefaultGcThresh1 Sysctl ayarı net.ipv4.neigh.default.gc_thresh1. Int
netIpv4NeighDefaultGcThresh2 Sysctl ayarı net.ipv4.neigh.default.gc_thresh2. Int
netIpv4NeighDefaultGcThresh3 Sysctl ayarı net.ipv4.neigh.default.gc_thresh3. Int
netIpv4TcpFinTimeout Sysctl ayarı net.ipv4.tcp_fin_timeout. Int
netIpv4TcpkeepaliveIntvl Sysctl ayarı net.ipv4.tcp_keepalive_intvl. Int

Kısıtlama -ları:
En düşük değer = 10
Maksimum değer = 90
netIpv4TcpKeepaliveProbes Sysctl ayarı net.ipv4.tcp_keepalive_probes. Int
netIpv4TcpKeepaliveTime Sysctl ayarı net.ipv4.tcp_keepalive_time. Int
netIpv4TcpMaxSynBacklog Sysctl ayarı net.ipv4.tcp_max_syn_backlog. Int
netIpv4TcpMaxTwBuckets Sysctl ayarı net.ipv4.tcp_max_tw_buckets. Int
netIpv4TcpTwReuse Sysctl ayarı net.ipv4.tcp_tw_reuse. Boole
netNetfilterNfConntrackBuckets Sysctl ayarı net.netfilter.nf_conntrack_buckets. Int

Kısıtlama -ları:
Min değer = 65536
En yüksek değer = 524288
netNetfilterNfConntrackMax Sysctl ayarı net.netfilter.nf_conntrack_max. Int

Kısıtlama -ları:
En düşük değer = 131072
En yüksek değer = 2097152
vmMaxMapCount Sysctl ayarı vm.max_map_count. Int
vmSwappiness (Sanal Makine Değişimi) Sysctl ayarı vm.swappiness. Int
vmVfsÖnbellek Basıncı Sysctl ayarı vm.vfs_cache_pressure. Int

Sanal Makine Düğümleri

İsim Açıklama Değer
sayı Düğüm sayısı. Int
boyut Bu düğüm grubunu barındırmak için kullanılan aracıların VM boyutu. String

VirtualMachinesProfile

İsim Açıklama Değer
ölçek VirtualMachines aracı havuzunu ölçeklendirmeye ilişkin belirtimler. Ölçek Profili