Delen via


Microsoft.ContainerService managedClusters/agentPools 2024-01-01

Bicep-resourcedefinitie

Het resourcetype managedClusters/agentPools kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Resource Microsoft.ContainerService/managedClusters/agentPools wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.

resource symbolicname 'Microsoft.ContainerService/managedClusters/agentPools@2024-01-01' = {
  name: 'string'
  parent: resourceSymbolicName
  properties: {
    availabilityZones: [
      'string'
    ]
    capacityReservationGroupID: 'string'
    count: int
    creationData: {
      sourceResourceId: 'string'
    }
    enableAutoScaling: bool
    enableEncryptionAtHost: bool
    enableFIPS: bool
    enableNodePublicIP: bool
    enableUltraSSD: bool
    gpuInstanceProfile: '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
    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'
    podSubnetID: 'string'
    powerState: {
      code: 'string'
    }
    proximityPlacementGroupID: 'string'
    scaleDownMode: 'string'
    scaleSetEvictionPolicy: 'string'
    scaleSetPriority: 'string'
    spotMaxPrice: int
    tags: {}
    type: 'string'
    upgradeSettings: {
      drainTimeoutInMinutes: int
      maxSurge: 'string'
      nodeSoakDurationInMinutes: int
    }
    vmSize: 'string'
    vnetSubnetID: 'string'
    workloadRuntime: 'string'
  }
}

Eigenschapswaarden

managedClusters/agentPools

Naam Beschrijving Waarde
naam De resourcenaam

Zie hoe u namen en typen instelt voor onderliggende resources in Bicep-.
tekenreeks (vereist)

Tekenlimiet: 1-12 voor Linux
1-6 voor Windows

Geldige tekens:
Kleine letters en cijfers.

Kan niet beginnen met een getal.
ouder In Bicep kunt u de bovenliggende resource voor een onderliggende resource opgeven. U hoeft deze eigenschap alleen toe te voegen wanneer de onderliggende resource buiten de bovenliggende resource wordt gedeclareerd.

Zie onderliggende resource buiten de bovenliggende resourcevoor meer informatie.
Symbolische naam voor resource van het type: managedClusters
Eigenschappen Eigenschappen van een agentgroep. ManagedClusterAgentPoolProfileProperties-

ManagedClusterAgentPoolProfileProperties

Naam Beschrijving Waarde
availabilityZones De lijst met beschikbaarheidszones die moeten worden gebruikt voor knooppunten. Dit kan alleen worden opgegeven als de eigenschap AgentPoolType virtualMachineScaleSets is. tekenreeks[]
capacityReservationGroupID AKS koppelt de opgegeven agentgroep aan de capaciteitsreserveringsgroep. snaar
tellen Aantal agents (VM's) voor het hosten van Docker-containers. Toegestane waarden moeten zich in het bereik van 0 tot 1000 (inclusief) bevinden voor gebruikersgroepen en in het bereik van 1 tot 1000 (inclusief) voor systeemgroepen. De standaardwaarde is 1. Int
creationData CreationData moet worden gebruikt om de bronmomentopname-id op te geven als de knooppuntgroep wordt gemaakt/bijgewerkt met behulp van een momentopname. CreationData-
enableAutoScaling Of automatische schaalaanpassing moet worden ingeschakeld Bool
enableEncryptionAtHost Dit wordt alleen ondersteund op bepaalde VM-grootten en in bepaalde Azure-regio's. Zie voor meer informatie: /azure/aks/enable-host-encryption Bool
enableFIPS Zie Een knooppuntgroep met FIPS-functionaliteit toevoegen voor meer informatie. Bool
enableNodePublicIP Voor sommige scenario's moeten knooppunten in een knooppuntgroep mogelijk hun eigen toegewezen openbare IP-adressen ontvangen. Een veelvoorkomend scenario is voor gamingworkloads, waarbij een console een directe verbinding moet maken met een virtuele cloudmachine om hops te minimaliseren. Zie voor meer informatie het toewijzen van een openbaar IP-adres per knooppunt. De standaardwaarde is onwaar. Bool
enableUltraSSD Of UltraSSD moet worden ingeschakeld Bool
gpuInstanceProfile GPUInstanceProfile dat moet worden gebruikt om het GPU MIG-exemplaarprofiel op te geven voor de ondersteunde GPU VM-SKU. 'MIG1g'
'MIG2g'
'MIG3g'
'MIG4g'
'MIG7g'
hostGroupID Dit is van het formulier: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Zie toegewezen Azure-hostsvoor meer informatie. snaar
kubeletConfig De Kubelet-configuratie op de agentpoolknooppunten. KubeletConfig-
kubeletDiskType Bepaalt de plaatsing van legeDir-volumes, hoofdmap van containerruntimegegevens en tijdelijke Kubelet-opslag. 'BESTURINGSSYSTEEM'
'Tijdelijk'
linuxOSConfig De besturingssysteemconfiguratie van Linux-agentknooppunten. LinuxOSConfig-
maxCount Het maximum aantal knooppunten voor automatisch schalen Int
maxPods Het maximum aantal pods dat op een knooppunt kan worden uitgevoerd. Int
minCount Het minimale aantal knooppunten voor automatisch schalen Int
wijze Een cluster moet te allen tijde ten minste één agentgroep van het systeem hebben. Zie voor meer informatie over beperkingen en best practices voor agentpools: /azure/aks/use-system-pools 'Systeem'
'Gebruiker'
networkProfile Netwerkinstellingen van een agentgroep. AgentPoolNetworkProfile
nodeLabels De knooppuntlabels die moeten worden bewaard op alle knooppunten in de agentgroep. ManagedClusterAgentPoolProfilePropertiesNodeLabels
nodePublicIPPrefixID Dit is van de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} snaar
nodeTaints De taints die zijn toegevoegd aan nieuwe knooppunten tijdens het maken en schalen van knooppuntgroepen. Bijvoorbeeld key=value:NoSchedule. tekenreeks[]
orchestratorVersion Beide patchversie {major.minor.patch} (bijvoorbeeld 1.20.13) en {major.minor} (bijvoorbeeld 1.20) worden ondersteund. Wanneer {major.minor} is opgegeven, wordt automatisch de meest recente ondersteunde GA-patchversie gekozen. Het cluster bijwerken met hetzelfde {major.minor} nadat het is gemaakt (bijvoorbeeld 1.14.x -} 1.14) activeert geen upgrade, zelfs niet als er een nieuwere patchversie beschikbaar is. Als best practice moet u alle knooppuntgroepen in een AKS-cluster upgraden naar dezelfde Kubernetes-versie. De versie van de knooppuntgroep moet dezelfde primaire versie hebben als het besturingsvlak. De secundaire versie van de knooppuntgroep moet zich in twee secundaire versies van de versie van het besturingsvlak bevindt. De versie van de knooppuntgroep mag niet groter zijn dan de versie van het besturingsvlak. Zie een knooppuntgroep bijwerkenvoor meer informatie. snaar
osDiskSizeGB Grootte van besturingssysteemschijf in GB die moet worden gebruikt om de schijfgrootte op te geven voor elke computer in de hoofd-/agentgroep. Als u 0 opgeeft, wordt de standaard osDisk-grootte toegepast op basis van de opgegeven vmSize. Int

Beperkingen:
Minimumwaarde = 0
Maximumwaarde = 2048
osDiskType De standaardwaarde is 'kortstondig' als de VIRTUELE machine deze ondersteunt en een cacheschijf heeft die groter is dan de aangevraagde OSDiskSizeGB. Anders wordt standaard 'Beheerd' gebruikt. Kan niet worden gewijzigd na het maken. Zie kortstondige os-voor meer informatie. 'Kortstondige'
'Beheerd'
osSKU Hiermee geeft u de SKU van het besturingssysteem op die wordt gebruikt door de agentgroep. De standaardwaarde is Ubuntu als OSType Linux is. De standaardwaarde is Windows2019 wanneer Kubernetes <= 1.24 of Windows2022 wanneer Kubernetes >= 1.25 als OSType Windows is. 'AzureLinux'
'CBLMariner'
'Ubuntu'
'Windows2019'
'Windows2022'
osType Het type besturingssysteem. De standaardwaarde is Linux. 'Linux'
'Windows'
podSubnetID Als u dit weglaat, worden pod-IP's statisch toegewezen aan het knooppuntsubnet (zie vnetSubnetID voor meer informatie). Dit is van het formulier: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} snaar
powerState Wanneer een agentgroep voor het eerst wordt gemaakt, wordt deze in eerste instantie uitgevoerd. De agentgroep kan worden gestopt door dit veld in te stellen op Gestopt. Een gestopte agentgroep stopt alle VM's en brengt geen factureringskosten met zich mee. Een agentgroep kan alleen worden gestopt als deze actief is en de inrichtingsstatus is geslaagd PowerState-
proximityPlacementGroupID De id voor nabijheidsplaatsingsgroep. snaar
scaleDownMode Dit heeft ook invloed op het gedrag van automatische schaalaanpassing van clusters. Als dit niet is opgegeven, wordt deze standaard verwijderd. Toewijzing ongedaan maken
'Verwijderen'
scaleSetEvictionPolicy Dit kan niet worden opgegeven tenzij de scaleSetPriority 'Spot' is. Als dit niet is opgegeven, is de standaardwaarde Verwijderen. Toewijzing ongedaan maken
'Verwijderen'
scaleSetPriority De prioriteit van de virtuele-machineschaalset. Als dit niet is opgegeven, is de standaardwaarde 'Normaal'. 'Normaal'
'Spot'
spotMaxPrice Mogelijke waarden zijn een decimale waarde die groter is dan nul of -1 die de bereidheid aangeeft om een on-demand prijs te betalen. Zie prijzen voor spot-VM's voor meer informatie over spotprijzen Int
Tags De tags die moeten worden bewaard in de virtuele-machineschaalset van de agentgroep. object
type Het type agentgroep. 'AvailabilitySet'
'VirtualMachineScaleSets'
upgradeSettings Instellingen voor het upgraden van de agentpool AgentPoolUpgradeSettings
vmSize Beschikbaarheid van VM-grootte verschilt per regio. Als een knooppunt onvoldoende rekenresources (geheugen, cpu, enzovoort) bevat, kunnen pods mogelijk niet correct worden uitgevoerd. Zie voor meer informatie over beperkte VM-grootten: /azure/aks/quotas-skus-regions snaar
vnetSubnetID Als dit niet is opgegeven, worden er een VNET en subnet gegenereerd en gebruikt. Als er geen podSubnetID is opgegeven, is dit van toepassing op knooppunten en pods, anders geldt dit voor alleen knooppunten. Dit is van het formulier: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} snaar
workloadRuntime Bepaalt het type workload dat een knooppunt kan uitvoeren. 'OCIContainer'
'WasmWasi'

CreationData

Naam Beschrijving Waarde
sourceResourceId Dit is de ARM-id van het bronobject dat moet worden gebruikt om het doelobject te maken. snaar

KubeletConfig

Naam Beschrijving Waarde
allowedUnsafeSysctls Toegestane lijst met onveilige sysctls of onveilige sysctl-patronen (eindigend op *). tekenreeks[]
containerLogMaxFiles Het maximum aantal containerlogboekbestanden dat aanwezig kan zijn voor een container. Het getal moet ≥ 2 zijn. Int

Beperkingen:
Minimumwaarde = 2
containerLogMaxSizeMB De maximale grootte (bijvoorbeeld 10Mi) van het containerlogboekbestand voordat het wordt gedraaid. Int
cpuCfsQuota De standaardwaarde is waar. Bool
cpuCfsQuotaPeriod De standaardwaarde is '100ms'. Geldige waarden zijn een reeks decimale getallen met een optionele breuk en een eenheidsachtervoegsel. Bijvoorbeeld: '300ms', '2h45m'. Ondersteunde eenheden zijn 'ns', 'us', 'ms', 's', 'm' en 'h'. snaar
cpuManagerPolicy De standaardwaarde is 'none'. Zie Kubernetes CPU-beheerbeleid voor meer informatie. Toegestane waarden zijn 'none' en 'static'. snaar
failSwapOn Als deze optie is ingesteld op true, kan de Kubelet niet worden gestart als wisselen is ingeschakeld op het knooppunt. Bool
imageGcHighThreshold Als u de garbagecollection van de installatiekopieën wilt uitschakelen, stelt u in op 100. De standaardwaarde is 85% Int
imageGcLowThreshold Dit kan niet hoger worden ingesteld dan imageGcHighThreshold. De standaardwaarde is 80% Int
podMaxPids Het maximum aantal processen per pod. Int
topologyManagerPolicy Zie Kubernetes Topology Managervoor meer informatie. De standaardwaarde is 'none'. Toegestane waarden zijn 'none', 'best-effort', 'restricted' en 'single-numa-node'. snaar

LinuxOSConfig

Naam Beschrijving Waarde
swapFileSizeMB De grootte in MB van een wisselbestand dat op elk knooppunt wordt gemaakt. Int
sysctls Sysctl-instellingen voor Linux-agentknooppunten. SysctlConfig-
transparentHugePageDefrag Geldige waarden zijn 'altijd', 'uitstellen', 'uitstellen+madvise', 'madvise' en 'nooit'. De standaardwaarde is 'madvise'. Zie Transparent Hugepagesvoor meer informatie. snaar
transparentHugePageEnabled Geldige waarden zijn 'altijd', 'madvise' en 'nooit'. De standaardwaarde is altijd. Zie Transparent Hugepagesvoor meer informatie. snaar

SysctlConfig

Naam Beschrijving Waarde
fsAioMaxNr Sysctl-instelling fs.aio-max-nr. Int
fsFileMax Sysctl setting fs.file-max. Int
fsInotifyMaxUserWatches Sysctl-instelling fs.inotify.max_user_watches. Int
fsNrOpen Sysctl-instelling fs.nr_open. Int
kernelThreadsMax Sysctl-instelling kernel.threads-max. Int
netCoreNetdevMaxBacklog Sysctl-instelling net.core.netdev_max_backlog. Int
netCoreOptmemMax Sysctl-instelling net.core.optmem_max. Int
netCoreRmemDefault Sysctl-instelling net.core.rmem_default. Int
netCoreRmemMax Sysctl-instelling net.core.rmem_max. Int
netCoreSomaxconn Sysctl setting net.core.somaxconn. Int
netCoreWmemDefault Sysctl-instelling net.core.wmem_default. Int
netCoreWmemMax Sysctl-instelling net.core.wmem_max. Int
netIpv4IpLocalPortRange Sysctl-instelling net.ipv4.ip_local_port_range. snaar
netIpv4NeighDefaultGcThresh1 Sysctl-instelling net.ipv4.neigh.default.gc_thresh1. Int
netIpv4NeighDefaultGcThresh2 Sysctl-instelling net.ipv4.neigh.default.gc_thresh2. Int
netIpv4NeighDefaultGcThresh3 Sysctl-instelling net.ipv4.neigh.default.gc_thresh3. Int
netIpv4TcpFinTimeout Sysctl-instelling net.ipv4.tcp_fin_timeout. Int
netIpv4TcpkeepaliveIntvl Sysctl-instelling net.ipv4.tcp_keepalive_intvl. Int

Beperkingen:
Minimumwaarde = 10
Maximumwaarde = 90
netIpv4TcpKeepaliveProbes Sysctl-instelling net.ipv4.tcp_keepalive_probes. Int
netIpv4TcpKeepaliveTime Sysctl-instelling net.ipv4.tcp_keepalive_time. Int
netIpv4TcpMaxSynBacklog Sysctl-instelling net.ipv4.tcp_max_syn_backlog. Int
netIpv4TcpMaxTwBuckets Sysctl-instelling net.ipv4.tcp_max_tw_buckets. Int
netIpv4TcpTwReuse Sysctl-instelling net.ipv4.tcp_tw_reuse. Bool
netNetfilterNfConntrackBuckets Sysctl-instelling net.netfilter.nf_conntrack_buckets. Int

Beperkingen:
Minimumwaarde = 65536
Maximumwaarde = 524288
netNetfilterNfConntrackMax Sysctl-instelling net.netfilter.nf_conntrack_max. Int

Beperkingen:
Minimumwaarde = 131072
Maximumwaarde = 2097152
vmMaxMapCount Sysctl-instelling vm.max_map_count. Int
vmSwappiness Sysctl-instelling vm.swappiness. Int
vmVfsCachePressure Sysctl-instelling vm.vfs_cache_pressure. Int

AgentPoolNetworkProfile

Naam Beschrijving Waarde
allowedHostPorts De poortbereiken waartoe toegang is toegestaan. De opgegeven bereiken mogen elkaar overlappen. PortRange[]
applicationSecurityGroups De id's van de toepassingsbeveiligingsgroepen die door de agentgroep worden gekoppeld wanneer deze worden gemaakt. tekenreeks[]
nodePublicIPTags IPTags van openbare IP-adressen op exemplaarniveau. IPTag[]

PortRange

Naam Beschrijving Waarde
portEnd De maximale poort die is opgenomen in het bereik. Het moet variëren van 1 tot 65535 en groter zijn dan of gelijk zijn aan portStart. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 65535
portStart De minimale poort die is opgenomen in het bereik. Het moet variëren van 1 tot 65535 en kleiner dan of gelijk aan portEnd. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 65535
protocol Het netwerkprotocol van de poort. 'TCP'
'UDP'

IPTag

Naam Beschrijving Waarde
ipTagType Het TYPE IP-tag. Voorbeeld: RoutingPreference. snaar
label De waarde van de IP-tag die is gekoppeld aan het openbare IP-adres. Voorbeeld: Internet. snaar

ManagedClusterAgentPoolProfilePropertiesNodeLabels

Naam Beschrijving Waarde
{aangepaste eigenschap} snaar

PowerState

Naam Beschrijving Waarde
code Hiermee wordt aangegeven of het cluster wordt uitgevoerd of gestopt 'Wordt uitgevoerd'
'Gestopt'

AgentPoolUpgradeSettings

Naam Beschrijving Waarde
drainTimeoutInMinutes De hoeveelheid tijd (in minuten) om te wachten op verwijdering van pods en respijtvolle beëindiging per knooppunt. Deze verwijderingswachttijd eert het wachten op budgetten voor podonderbreking. Als deze tijd wordt overschreden, mislukt de upgrade. Als dit niet is opgegeven, is de standaardwaarde 30 minuten. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 1440
maxSurge Dit kan worden ingesteld op een geheel getal (bijvoorbeeld '5') of een percentage (bijvoorbeeld '50%'). Als een percentage is opgegeven, is dit het percentage van de totale grootte van de agentgroep op het moment van de upgrade. Voor percentages worden breukknooppunten naar boven afgerond. Als dit niet is opgegeven, is de standaardwaarde 1. Zie voor meer informatie, inclusief aanbevolen procedures: /azure/aks/upgrade-cluster#customize-node-surge-upgrade snaar
nodeSoakDurationInMinutes De hoeveelheid tijd (in minuten) die moet worden gewacht na het leegmaken van een knooppunt en voordat u het opnieuw opgeeft en verdergaat met het volgende knooppunt. Als dit niet is opgegeven, is de standaardwaarde 0 minuten. Int

Beperkingen:
Minimumwaarde = 0
Maximumwaarde = 30

Quickstart-sjablonen

Met de volgende quickstart-sjablonen wordt dit resourcetype geïmplementeerd.

Sjabloon Beschrijving
Een AKS-cluster implementeren voor Azure ML-

implementeren in Azure
Met deze sjabloon kunt u een AKS-cluster implementeren dat compatibel is met entreprise, dat kan worden gekoppeld aan Azure ML

Resourcedefinitie van ARM-sjabloon

Het resourcetype managedClusters/agentPools kan worden geïmplementeerd met bewerkingen die zijn gericht op:

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Resource Microsoft.ContainerService/managedClusters/agentPools wilt maken, voegt u de volgende JSON toe aan uw sjabloon.

{
  "type": "Microsoft.ContainerService/managedClusters/agentPools",
  "apiVersion": "2024-01-01",
  "name": "string",
  "properties": {
    "availabilityZones": [ "string" ],
    "capacityReservationGroupID": "string",
    "count": "int",
    "creationData": {
      "sourceResourceId": "string"
    },
    "enableAutoScaling": "bool",
    "enableEncryptionAtHost": "bool",
    "enableFIPS": "bool",
    "enableNodePublicIP": "bool",
    "enableUltraSSD": "bool",
    "gpuInstanceProfile": "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",
    "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",
    "podSubnetID": "string",
    "powerState": {
      "code": "string"
    },
    "proximityPlacementGroupID": "string",
    "scaleDownMode": "string",
    "scaleSetEvictionPolicy": "string",
    "scaleSetPriority": "string",
    "spotMaxPrice": "int",
    "tags": {},
    "type": "string",
    "upgradeSettings": {
      "drainTimeoutInMinutes": "int",
      "maxSurge": "string",
      "nodeSoakDurationInMinutes": "int"
    },
    "vmSize": "string",
    "vnetSubnetID": "string",
    "workloadRuntime": "string"
  }
}

Eigenschapswaarden

managedClusters/agentPools

Naam Beschrijving Waarde
type Het resourcetype 'Microsoft.ContainerService/managedClusters/agentPools'
apiVersion De versie van de resource-API '2024-01-01'
naam De resourcenaam

Zie hoe u namen en typen instelt voor onderliggende resources in JSON ARM-sjablonen.
tekenreeks (vereist)

Tekenlimiet: 1-12 voor Linux
1-6 voor Windows

Geldige tekens:
Kleine letters en cijfers.

Kan niet beginnen met een getal.
Eigenschappen Eigenschappen van een agentgroep. ManagedClusterAgentPoolProfileProperties-

ManagedClusterAgentPoolProfileProperties

Naam Beschrijving Waarde
availabilityZones De lijst met beschikbaarheidszones die moeten worden gebruikt voor knooppunten. Dit kan alleen worden opgegeven als de eigenschap AgentPoolType virtualMachineScaleSets is. tekenreeks[]
capacityReservationGroupID AKS koppelt de opgegeven agentgroep aan de capaciteitsreserveringsgroep. snaar
tellen Aantal agents (VM's) voor het hosten van Docker-containers. Toegestane waarden moeten zich in het bereik van 0 tot 1000 (inclusief) bevinden voor gebruikersgroepen en in het bereik van 1 tot 1000 (inclusief) voor systeemgroepen. De standaardwaarde is 1. Int
creationData CreationData moet worden gebruikt om de bronmomentopname-id op te geven als de knooppuntgroep wordt gemaakt/bijgewerkt met behulp van een momentopname. CreationData-
enableAutoScaling Of automatische schaalaanpassing moet worden ingeschakeld Bool
enableEncryptionAtHost Dit wordt alleen ondersteund op bepaalde VM-grootten en in bepaalde Azure-regio's. Zie voor meer informatie: /azure/aks/enable-host-encryption Bool
enableFIPS Zie Een knooppuntgroep met FIPS-functionaliteit toevoegen voor meer informatie. Bool
enableNodePublicIP Voor sommige scenario's moeten knooppunten in een knooppuntgroep mogelijk hun eigen toegewezen openbare IP-adressen ontvangen. Een veelvoorkomend scenario is voor gamingworkloads, waarbij een console een directe verbinding moet maken met een virtuele cloudmachine om hops te minimaliseren. Zie voor meer informatie het toewijzen van een openbaar IP-adres per knooppunt. De standaardwaarde is onwaar. Bool
enableUltraSSD Of UltraSSD moet worden ingeschakeld Bool
gpuInstanceProfile GPUInstanceProfile dat moet worden gebruikt om het GPU MIG-exemplaarprofiel op te geven voor de ondersteunde GPU VM-SKU. 'MIG1g'
'MIG2g'
'MIG3g'
'MIG4g'
'MIG7g'
hostGroupID Dit is van het formulier: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Zie toegewezen Azure-hostsvoor meer informatie. snaar
kubeletConfig De Kubelet-configuratie op de agentpoolknooppunten. KubeletConfig-
kubeletDiskType Bepaalt de plaatsing van legeDir-volumes, hoofdmap van containerruntimegegevens en tijdelijke Kubelet-opslag. 'BESTURINGSSYSTEEM'
'Tijdelijk'
linuxOSConfig De besturingssysteemconfiguratie van Linux-agentknooppunten. LinuxOSConfig-
maxCount Het maximum aantal knooppunten voor automatisch schalen Int
maxPods Het maximum aantal pods dat op een knooppunt kan worden uitgevoerd. Int
minCount Het minimale aantal knooppunten voor automatisch schalen Int
wijze Een cluster moet te allen tijde ten minste één agentgroep van het systeem hebben. Zie voor meer informatie over beperkingen en best practices voor agentpools: /azure/aks/use-system-pools 'Systeem'
'Gebruiker'
networkProfile Netwerkinstellingen van een agentgroep. AgentPoolNetworkProfile
nodeLabels De knooppuntlabels die moeten worden bewaard op alle knooppunten in de agentgroep. ManagedClusterAgentPoolProfilePropertiesNodeLabels
nodePublicIPPrefixID Dit is van de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} snaar
nodeTaints De taints die zijn toegevoegd aan nieuwe knooppunten tijdens het maken en schalen van knooppuntgroepen. Bijvoorbeeld key=value:NoSchedule. tekenreeks[]
orchestratorVersion Beide patchversie {major.minor.patch} (bijvoorbeeld 1.20.13) en {major.minor} (bijvoorbeeld 1.20) worden ondersteund. Wanneer {major.minor} is opgegeven, wordt automatisch de meest recente ondersteunde GA-patchversie gekozen. Het cluster bijwerken met hetzelfde {major.minor} nadat het is gemaakt (bijvoorbeeld 1.14.x -} 1.14) activeert geen upgrade, zelfs niet als er een nieuwere patchversie beschikbaar is. Als best practice moet u alle knooppuntgroepen in een AKS-cluster upgraden naar dezelfde Kubernetes-versie. De versie van de knooppuntgroep moet dezelfde primaire versie hebben als het besturingsvlak. De secundaire versie van de knooppuntgroep moet zich in twee secundaire versies van de versie van het besturingsvlak bevindt. De versie van de knooppuntgroep mag niet groter zijn dan de versie van het besturingsvlak. Zie een knooppuntgroep bijwerkenvoor meer informatie. snaar
osDiskSizeGB Grootte van besturingssysteemschijf in GB die moet worden gebruikt om de schijfgrootte op te geven voor elke computer in de hoofd-/agentgroep. Als u 0 opgeeft, wordt de standaard osDisk-grootte toegepast op basis van de opgegeven vmSize. Int

Beperkingen:
Minimumwaarde = 0
Maximumwaarde = 2048
osDiskType De standaardwaarde is 'kortstondig' als de VIRTUELE machine deze ondersteunt en een cacheschijf heeft die groter is dan de aangevraagde OSDiskSizeGB. Anders wordt standaard 'Beheerd' gebruikt. Kan niet worden gewijzigd na het maken. Zie kortstondige os-voor meer informatie. 'Kortstondige'
'Beheerd'
osSKU Hiermee geeft u de SKU van het besturingssysteem op die wordt gebruikt door de agentgroep. De standaardwaarde is Ubuntu als OSType Linux is. De standaardwaarde is Windows2019 wanneer Kubernetes <= 1.24 of Windows2022 wanneer Kubernetes >= 1.25 als OSType Windows is. 'AzureLinux'
'CBLMariner'
'Ubuntu'
'Windows2019'
'Windows2022'
osType Het type besturingssysteem. De standaardwaarde is Linux. 'Linux'
'Windows'
podSubnetID Als u dit weglaat, worden pod-IP's statisch toegewezen aan het knooppuntsubnet (zie vnetSubnetID voor meer informatie). Dit is van het formulier: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} snaar
powerState Wanneer een agentgroep voor het eerst wordt gemaakt, wordt deze in eerste instantie uitgevoerd. De agentgroep kan worden gestopt door dit veld in te stellen op Gestopt. Een gestopte agentgroep stopt alle VM's en brengt geen factureringskosten met zich mee. Een agentgroep kan alleen worden gestopt als deze actief is en de inrichtingsstatus is geslaagd PowerState-
proximityPlacementGroupID De id voor nabijheidsplaatsingsgroep. snaar
scaleDownMode Dit heeft ook invloed op het gedrag van automatische schaalaanpassing van clusters. Als dit niet is opgegeven, wordt deze standaard verwijderd. Toewijzing ongedaan maken
'Verwijderen'
scaleSetEvictionPolicy Dit kan niet worden opgegeven tenzij de scaleSetPriority 'Spot' is. Als dit niet is opgegeven, is de standaardwaarde Verwijderen. Toewijzing ongedaan maken
'Verwijderen'
scaleSetPriority De prioriteit van de virtuele-machineschaalset. Als dit niet is opgegeven, is de standaardwaarde 'Normaal'. 'Normaal'
'Spot'
spotMaxPrice Mogelijke waarden zijn een decimale waarde die groter is dan nul of -1 die de bereidheid aangeeft om een on-demand prijs te betalen. Zie prijzen voor spot-VM's voor meer informatie over spotprijzen Int
Tags De tags die moeten worden bewaard in de virtuele-machineschaalset van de agentgroep. object
type Het type agentgroep. 'AvailabilitySet'
'VirtualMachineScaleSets'
upgradeSettings Instellingen voor het upgraden van de agentpool AgentPoolUpgradeSettings
vmSize Beschikbaarheid van VM-grootte verschilt per regio. Als een knooppunt onvoldoende rekenresources (geheugen, cpu, enzovoort) bevat, kunnen pods mogelijk niet correct worden uitgevoerd. Zie voor meer informatie over beperkte VM-grootten: /azure/aks/quotas-skus-regions snaar
vnetSubnetID Als dit niet is opgegeven, worden er een VNET en subnet gegenereerd en gebruikt. Als er geen podSubnetID is opgegeven, is dit van toepassing op knooppunten en pods, anders geldt dit voor alleen knooppunten. Dit is van het formulier: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} snaar
workloadRuntime Bepaalt het type workload dat een knooppunt kan uitvoeren. 'OCIContainer'
'WasmWasi'

CreationData

Naam Beschrijving Waarde
sourceResourceId Dit is de ARM-id van het bronobject dat moet worden gebruikt om het doelobject te maken. snaar

KubeletConfig

Naam Beschrijving Waarde
allowedUnsafeSysctls Toegestane lijst met onveilige sysctls of onveilige sysctl-patronen (eindigend op *). tekenreeks[]
containerLogMaxFiles Het maximum aantal containerlogboekbestanden dat aanwezig kan zijn voor een container. Het getal moet ≥ 2 zijn. Int

Beperkingen:
Minimumwaarde = 2
containerLogMaxSizeMB De maximale grootte (bijvoorbeeld 10Mi) van het containerlogboekbestand voordat het wordt gedraaid. Int
cpuCfsQuota De standaardwaarde is waar. Bool
cpuCfsQuotaPeriod De standaardwaarde is '100ms'. Geldige waarden zijn een reeks decimale getallen met een optionele breuk en een eenheidsachtervoegsel. Bijvoorbeeld: '300ms', '2h45m'. Ondersteunde eenheden zijn 'ns', 'us', 'ms', 's', 'm' en 'h'. snaar
cpuManagerPolicy De standaardwaarde is 'none'. Zie Kubernetes CPU-beheerbeleid voor meer informatie. Toegestane waarden zijn 'none' en 'static'. snaar
failSwapOn Als deze optie is ingesteld op true, kan de Kubelet niet worden gestart als wisselen is ingeschakeld op het knooppunt. Bool
imageGcHighThreshold Als u de garbagecollection van de installatiekopieën wilt uitschakelen, stelt u in op 100. De standaardwaarde is 85% Int
imageGcLowThreshold Dit kan niet hoger worden ingesteld dan imageGcHighThreshold. De standaardwaarde is 80% Int
podMaxPids Het maximum aantal processen per pod. Int
topologyManagerPolicy Zie Kubernetes Topology Managervoor meer informatie. De standaardwaarde is 'none'. Toegestane waarden zijn 'none', 'best-effort', 'restricted' en 'single-numa-node'. snaar

LinuxOSConfig

Naam Beschrijving Waarde
swapFileSizeMB De grootte in MB van een wisselbestand dat op elk knooppunt wordt gemaakt. Int
sysctls Sysctl-instellingen voor Linux-agentknooppunten. SysctlConfig-
transparentHugePageDefrag Geldige waarden zijn 'altijd', 'uitstellen', 'uitstellen+madvise', 'madvise' en 'nooit'. De standaardwaarde is 'madvise'. Zie Transparent Hugepagesvoor meer informatie. snaar
transparentHugePageEnabled Geldige waarden zijn 'altijd', 'madvise' en 'nooit'. De standaardwaarde is altijd. Zie Transparent Hugepagesvoor meer informatie. snaar

SysctlConfig

Naam Beschrijving Waarde
fsAioMaxNr Sysctl-instelling fs.aio-max-nr. Int
fsFileMax Sysctl setting fs.file-max. Int
fsInotifyMaxUserWatches Sysctl-instelling fs.inotify.max_user_watches. Int
fsNrOpen Sysctl-instelling fs.nr_open. Int
kernelThreadsMax Sysctl-instelling kernel.threads-max. Int
netCoreNetdevMaxBacklog Sysctl-instelling net.core.netdev_max_backlog. Int
netCoreOptmemMax Sysctl-instelling net.core.optmem_max. Int
netCoreRmemDefault Sysctl-instelling net.core.rmem_default. Int
netCoreRmemMax Sysctl-instelling net.core.rmem_max. Int
netCoreSomaxconn Sysctl setting net.core.somaxconn. Int
netCoreWmemDefault Sysctl-instelling net.core.wmem_default. Int
netCoreWmemMax Sysctl-instelling net.core.wmem_max. Int
netIpv4IpLocalPortRange Sysctl-instelling net.ipv4.ip_local_port_range. snaar
netIpv4NeighDefaultGcThresh1 Sysctl-instelling net.ipv4.neigh.default.gc_thresh1. Int
netIpv4NeighDefaultGcThresh2 Sysctl-instelling net.ipv4.neigh.default.gc_thresh2. Int
netIpv4NeighDefaultGcThresh3 Sysctl-instelling net.ipv4.neigh.default.gc_thresh3. Int
netIpv4TcpFinTimeout Sysctl-instelling net.ipv4.tcp_fin_timeout. Int
netIpv4TcpkeepaliveIntvl Sysctl-instelling net.ipv4.tcp_keepalive_intvl. Int

Beperkingen:
Minimumwaarde = 10
Maximumwaarde = 90
netIpv4TcpKeepaliveProbes Sysctl-instelling net.ipv4.tcp_keepalive_probes. Int
netIpv4TcpKeepaliveTime Sysctl-instelling net.ipv4.tcp_keepalive_time. Int
netIpv4TcpMaxSynBacklog Sysctl-instelling net.ipv4.tcp_max_syn_backlog. Int
netIpv4TcpMaxTwBuckets Sysctl-instelling net.ipv4.tcp_max_tw_buckets. Int
netIpv4TcpTwReuse Sysctl-instelling net.ipv4.tcp_tw_reuse. Bool
netNetfilterNfConntrackBuckets Sysctl-instelling net.netfilter.nf_conntrack_buckets. Int

Beperkingen:
Minimumwaarde = 65536
Maximumwaarde = 524288
netNetfilterNfConntrackMax Sysctl-instelling net.netfilter.nf_conntrack_max. Int

Beperkingen:
Minimumwaarde = 131072
Maximumwaarde = 2097152
vmMaxMapCount Sysctl-instelling vm.max_map_count. Int
vmSwappiness Sysctl-instelling vm.swappiness. Int
vmVfsCachePressure Sysctl-instelling vm.vfs_cache_pressure. Int

AgentPoolNetworkProfile

Naam Beschrijving Waarde
allowedHostPorts De poortbereiken waartoe toegang is toegestaan. De opgegeven bereiken mogen elkaar overlappen. PortRange[]
applicationSecurityGroups De id's van de toepassingsbeveiligingsgroepen die door de agentgroep worden gekoppeld wanneer deze worden gemaakt. tekenreeks[]
nodePublicIPTags IPTags van openbare IP-adressen op exemplaarniveau. IPTag[]

PortRange

Naam Beschrijving Waarde
portEnd De maximale poort die is opgenomen in het bereik. Het moet variëren van 1 tot 65535 en groter zijn dan of gelijk zijn aan portStart. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 65535
portStart De minimale poort die is opgenomen in het bereik. Het moet variëren van 1 tot 65535 en kleiner dan of gelijk aan portEnd. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 65535
protocol Het netwerkprotocol van de poort. 'TCP'
'UDP'

IPTag

Naam Beschrijving Waarde
ipTagType Het TYPE IP-tag. Voorbeeld: RoutingPreference. snaar
label De waarde van de IP-tag die is gekoppeld aan het openbare IP-adres. Voorbeeld: Internet. snaar

ManagedClusterAgentPoolProfilePropertiesNodeLabels

Naam Beschrijving Waarde
{aangepaste eigenschap} snaar

PowerState

Naam Beschrijving Waarde
code Hiermee wordt aangegeven of het cluster wordt uitgevoerd of gestopt 'Wordt uitgevoerd'
'Gestopt'

AgentPoolUpgradeSettings

Naam Beschrijving Waarde
drainTimeoutInMinutes De hoeveelheid tijd (in minuten) om te wachten op verwijdering van pods en respijtvolle beëindiging per knooppunt. Deze verwijderingswachttijd eert het wachten op budgetten voor podonderbreking. Als deze tijd wordt overschreden, mislukt de upgrade. Als dit niet is opgegeven, is de standaardwaarde 30 minuten. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 1440
maxSurge Dit kan worden ingesteld op een geheel getal (bijvoorbeeld '5') of een percentage (bijvoorbeeld '50%'). Als een percentage is opgegeven, is dit het percentage van de totale grootte van de agentgroep op het moment van de upgrade. Voor percentages worden breukknooppunten naar boven afgerond. Als dit niet is opgegeven, is de standaardwaarde 1. Zie voor meer informatie, inclusief aanbevolen procedures: /azure/aks/upgrade-cluster#customize-node-surge-upgrade snaar
nodeSoakDurationInMinutes De hoeveelheid tijd (in minuten) die moet worden gewacht na het leegmaken van een knooppunt en voordat u het opnieuw opgeeft en verdergaat met het volgende knooppunt. Als dit niet is opgegeven, is de standaardwaarde 0 minuten. Int

Beperkingen:
Minimumwaarde = 0
Maximumwaarde = 30

Quickstart-sjablonen

Met de volgende quickstart-sjablonen wordt dit resourcetype geïmplementeerd.

Sjabloon Beschrijving
Een AKS-cluster implementeren voor Azure ML-

implementeren in Azure
Met deze sjabloon kunt u een AKS-cluster implementeren dat compatibel is met entreprise, dat kan worden gekoppeld aan Azure ML

Resourcedefinitie van Terraform (AzAPI-provider)

Het resourcetype managedClusters/agentPools kan worden geïmplementeerd met bewerkingen die zijn gericht op:

  • resourcegroepen

Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.

Resource-indeling

Als u een Resource Microsoft.ContainerService/managedClusters/agentPools wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ContainerService/managedClusters/agentPools@2024-01-01"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      availabilityZones = [
        "string"
      ]
      capacityReservationGroupID = "string"
      count = int
      creationData = {
        sourceResourceId = "string"
      }
      enableAutoScaling = bool
      enableEncryptionAtHost = bool
      enableFIPS = bool
      enableNodePublicIP = bool
      enableUltraSSD = bool
      gpuInstanceProfile = "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
      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"
      podSubnetID = "string"
      powerState = {
        code = "string"
      }
      proximityPlacementGroupID = "string"
      scaleDownMode = "string"
      scaleSetEvictionPolicy = "string"
      scaleSetPriority = "string"
      spotMaxPrice = int
      tags = {}
      type = "string"
      upgradeSettings = {
        drainTimeoutInMinutes = int
        maxSurge = "string"
        nodeSoakDurationInMinutes = int
      }
      vmSize = "string"
      vnetSubnetID = "string"
      workloadRuntime = "string"
    }
  })
}

Eigenschapswaarden

managedClusters/agentPools

Naam Beschrijving Waarde
type Het resourcetype "Microsoft.ContainerService/managedClusters/agentPools@2024-01-01"
naam De resourcenaam tekenreeks (vereist)

Tekenlimiet: 1-12 voor Linux
1-6 voor Windows

Geldige tekens:
Kleine letters en cijfers.

Kan niet beginnen met een getal.
parent_id De id van de resource die het bovenliggende item voor deze resource is. Id voor resource van het type: managedClusters
Eigenschappen Eigenschappen van een agentgroep. ManagedClusterAgentPoolProfileProperties-

ManagedClusterAgentPoolProfileProperties

Naam Beschrijving Waarde
availabilityZones De lijst met beschikbaarheidszones die moeten worden gebruikt voor knooppunten. Dit kan alleen worden opgegeven als de eigenschap AgentPoolType virtualMachineScaleSets is. tekenreeks[]
capacityReservationGroupID AKS koppelt de opgegeven agentgroep aan de capaciteitsreserveringsgroep. snaar
tellen Aantal agents (VM's) voor het hosten van Docker-containers. Toegestane waarden moeten zich in het bereik van 0 tot 1000 (inclusief) bevinden voor gebruikersgroepen en in het bereik van 1 tot 1000 (inclusief) voor systeemgroepen. De standaardwaarde is 1. Int
creationData CreationData moet worden gebruikt om de bronmomentopname-id op te geven als de knooppuntgroep wordt gemaakt/bijgewerkt met behulp van een momentopname. CreationData-
enableAutoScaling Of automatische schaalaanpassing moet worden ingeschakeld Bool
enableEncryptionAtHost Dit wordt alleen ondersteund op bepaalde VM-grootten en in bepaalde Azure-regio's. Zie voor meer informatie: /azure/aks/enable-host-encryption Bool
enableFIPS Zie Een knooppuntgroep met FIPS-functionaliteit toevoegen voor meer informatie. Bool
enableNodePublicIP Voor sommige scenario's moeten knooppunten in een knooppuntgroep mogelijk hun eigen toegewezen openbare IP-adressen ontvangen. Een veelvoorkomend scenario is voor gamingworkloads, waarbij een console een directe verbinding moet maken met een virtuele cloudmachine om hops te minimaliseren. Zie voor meer informatie het toewijzen van een openbaar IP-adres per knooppunt. De standaardwaarde is onwaar. Bool
enableUltraSSD Of UltraSSD moet worden ingeschakeld Bool
gpuInstanceProfile GPUInstanceProfile dat moet worden gebruikt om het GPU MIG-exemplaarprofiel op te geven voor de ondersteunde GPU VM-SKU. "MIG1g"
"MIG2g"
"MIG3g"
"MIG4g"
"MIG7g"
hostGroupID Dit is van het formulier: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Zie toegewezen Azure-hostsvoor meer informatie. snaar
kubeletConfig De Kubelet-configuratie op de agentpoolknooppunten. KubeletConfig-
kubeletDiskType Bepaalt de plaatsing van legeDir-volumes, hoofdmap van containerruntimegegevens en tijdelijke Kubelet-opslag. "BESTURINGSSYSTEEM"
"Tijdelijk"
linuxOSConfig De besturingssysteemconfiguratie van Linux-agentknooppunten. LinuxOSConfig-
maxCount Het maximum aantal knooppunten voor automatisch schalen Int
maxPods Het maximum aantal pods dat op een knooppunt kan worden uitgevoerd. Int
minCount Het minimale aantal knooppunten voor automatisch schalen Int
wijze Een cluster moet te allen tijde ten minste één agentgroep van het systeem hebben. Zie voor meer informatie over beperkingen en best practices voor agentpools: /azure/aks/use-system-pools "Systeem"
"Gebruiker"
networkProfile Netwerkinstellingen van een agentgroep. AgentPoolNetworkProfile
nodeLabels De knooppuntlabels die moeten worden bewaard op alle knooppunten in de agentgroep. ManagedClusterAgentPoolProfilePropertiesNodeLabels
nodePublicIPPrefixID Dit is van de vorm: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} snaar
nodeTaints De taints die zijn toegevoegd aan nieuwe knooppunten tijdens het maken en schalen van knooppuntgroepen. Bijvoorbeeld key=value:NoSchedule. tekenreeks[]
orchestratorVersion Beide patchversie {major.minor.patch} (bijvoorbeeld 1.20.13) en {major.minor} (bijvoorbeeld 1.20) worden ondersteund. Wanneer {major.minor} is opgegeven, wordt automatisch de meest recente ondersteunde GA-patchversie gekozen. Het cluster bijwerken met hetzelfde {major.minor} nadat het is gemaakt (bijvoorbeeld 1.14.x -} 1.14) activeert geen upgrade, zelfs niet als er een nieuwere patchversie beschikbaar is. Als best practice moet u alle knooppuntgroepen in een AKS-cluster upgraden naar dezelfde Kubernetes-versie. De versie van de knooppuntgroep moet dezelfde primaire versie hebben als het besturingsvlak. De secundaire versie van de knooppuntgroep moet zich in twee secundaire versies van de versie van het besturingsvlak bevindt. De versie van de knooppuntgroep mag niet groter zijn dan de versie van het besturingsvlak. Zie een knooppuntgroep bijwerkenvoor meer informatie. snaar
osDiskSizeGB Grootte van besturingssysteemschijf in GB die moet worden gebruikt om de schijfgrootte op te geven voor elke computer in de hoofd-/agentgroep. Als u 0 opgeeft, wordt de standaard osDisk-grootte toegepast op basis van de opgegeven vmSize. Int

Beperkingen:
Minimumwaarde = 0
Maximumwaarde = 2048
osDiskType De standaardwaarde is 'kortstondig' als de VIRTUELE machine deze ondersteunt en een cacheschijf heeft die groter is dan de aangevraagde OSDiskSizeGB. Anders wordt standaard 'Beheerd' gebruikt. Kan niet worden gewijzigd na het maken. Zie kortstondige os-voor meer informatie. "Kortstondige"
"Beheerd"
osSKU Hiermee geeft u de SKU van het besturingssysteem op die wordt gebruikt door de agentgroep. De standaardwaarde is Ubuntu als OSType Linux is. De standaardwaarde is Windows2019 wanneer Kubernetes <= 1.24 of Windows2022 wanneer Kubernetes >= 1.25 als OSType Windows is. "AzureLinux"
"CBLMariner"
"Ubuntu"
"Windows2019"
"Windows2022"
osType Het type besturingssysteem. De standaardwaarde is Linux. "Linux"
"Windows"
podSubnetID Als u dit weglaat, worden pod-IP's statisch toegewezen aan het knooppuntsubnet (zie vnetSubnetID voor meer informatie). Dit is van het formulier: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} snaar
powerState Wanneer een agentgroep voor het eerst wordt gemaakt, wordt deze in eerste instantie uitgevoerd. De agentgroep kan worden gestopt door dit veld in te stellen op Gestopt. Een gestopte agentgroep stopt alle VM's en brengt geen factureringskosten met zich mee. Een agentgroep kan alleen worden gestopt als deze actief is en de inrichtingsstatus is geslaagd PowerState-
proximityPlacementGroupID De id voor nabijheidsplaatsingsgroep. snaar
scaleDownMode Dit heeft ook invloed op het gedrag van automatische schaalaanpassing van clusters. Als dit niet is opgegeven, wordt deze standaard verwijderd. "Toewijzing ongedaan maken"
"Verwijderen"
scaleSetEvictionPolicy Dit kan niet worden opgegeven tenzij de scaleSetPriority 'Spot' is. Als dit niet is opgegeven, is de standaardwaarde Verwijderen. "Toewijzing ongedaan maken"
"Verwijderen"
scaleSetPriority De prioriteit van de virtuele-machineschaalset. Als dit niet is opgegeven, is de standaardwaarde 'Normaal'. "Normaal"
"Spot"
spotMaxPrice Mogelijke waarden zijn een decimale waarde die groter is dan nul of -1 die de bereidheid aangeeft om een on-demand prijs te betalen. Zie prijzen voor spot-VM's voor meer informatie over spotprijzen Int
Tags De tags die moeten worden bewaard in de virtuele-machineschaalset van de agentgroep. object
type Het type agentgroep. "AvailabilitySet"
"VirtualMachineScaleSets"
upgradeSettings Instellingen voor het upgraden van de agentpool AgentPoolUpgradeSettings
vmSize Beschikbaarheid van VM-grootte verschilt per regio. Als een knooppunt onvoldoende rekenresources (geheugen, cpu, enzovoort) bevat, kunnen pods mogelijk niet correct worden uitgevoerd. Zie voor meer informatie over beperkte VM-grootten: /azure/aks/quotas-skus-regions snaar
vnetSubnetID Als dit niet is opgegeven, worden er een VNET en subnet gegenereerd en gebruikt. Als er geen podSubnetID is opgegeven, is dit van toepassing op knooppunten en pods, anders geldt dit voor alleen knooppunten. Dit is van het formulier: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName} snaar
workloadRuntime Bepaalt het type workload dat een knooppunt kan uitvoeren. "OCIContainer"
"WasmWasi"

CreationData

Naam Beschrijving Waarde
sourceResourceId Dit is de ARM-id van het bronobject dat moet worden gebruikt om het doelobject te maken. snaar

KubeletConfig

Naam Beschrijving Waarde
allowedUnsafeSysctls Toegestane lijst met onveilige sysctls of onveilige sysctl-patronen (eindigend op *). tekenreeks[]
containerLogMaxFiles Het maximum aantal containerlogboekbestanden dat aanwezig kan zijn voor een container. Het getal moet ≥ 2 zijn. Int

Beperkingen:
Minimumwaarde = 2
containerLogMaxSizeMB De maximale grootte (bijvoorbeeld 10Mi) van het containerlogboekbestand voordat het wordt gedraaid. Int
cpuCfsQuota De standaardwaarde is waar. Bool
cpuCfsQuotaPeriod De standaardwaarde is '100ms'. Geldige waarden zijn een reeks decimale getallen met een optionele breuk en een eenheidsachtervoegsel. Bijvoorbeeld: '300ms', '2h45m'. Ondersteunde eenheden zijn 'ns', 'us', 'ms', 's', 'm' en 'h'. snaar
cpuManagerPolicy De standaardwaarde is 'none'. Zie Kubernetes CPU-beheerbeleid voor meer informatie. Toegestane waarden zijn 'none' en 'static'. snaar
failSwapOn Als deze optie is ingesteld op true, kan de Kubelet niet worden gestart als wisselen is ingeschakeld op het knooppunt. Bool
imageGcHighThreshold Als u de garbagecollection van de installatiekopieën wilt uitschakelen, stelt u in op 100. De standaardwaarde is 85% Int
imageGcLowThreshold Dit kan niet hoger worden ingesteld dan imageGcHighThreshold. De standaardwaarde is 80% Int
podMaxPids Het maximum aantal processen per pod. Int
topologyManagerPolicy Zie Kubernetes Topology Managervoor meer informatie. De standaardwaarde is 'none'. Toegestane waarden zijn 'none', 'best-effort', 'restricted' en 'single-numa-node'. snaar

LinuxOSConfig

Naam Beschrijving Waarde
swapFileSizeMB De grootte in MB van een wisselbestand dat op elk knooppunt wordt gemaakt. Int
sysctls Sysctl-instellingen voor Linux-agentknooppunten. SysctlConfig-
transparentHugePageDefrag Geldige waarden zijn 'altijd', 'uitstellen', 'uitstellen+madvise', 'madvise' en 'nooit'. De standaardwaarde is 'madvise'. Zie Transparent Hugepagesvoor meer informatie. snaar
transparentHugePageEnabled Geldige waarden zijn 'altijd', 'madvise' en 'nooit'. De standaardwaarde is altijd. Zie Transparent Hugepagesvoor meer informatie. snaar

SysctlConfig

Naam Beschrijving Waarde
fsAioMaxNr Sysctl-instelling fs.aio-max-nr. Int
fsFileMax Sysctl setting fs.file-max. Int
fsInotifyMaxUserWatches Sysctl-instelling fs.inotify.max_user_watches. Int
fsNrOpen Sysctl-instelling fs.nr_open. Int
kernelThreadsMax Sysctl-instelling kernel.threads-max. Int
netCoreNetdevMaxBacklog Sysctl-instelling net.core.netdev_max_backlog. Int
netCoreOptmemMax Sysctl-instelling net.core.optmem_max. Int
netCoreRmemDefault Sysctl-instelling net.core.rmem_default. Int
netCoreRmemMax Sysctl-instelling net.core.rmem_max. Int
netCoreSomaxconn Sysctl setting net.core.somaxconn. Int
netCoreWmemDefault Sysctl-instelling net.core.wmem_default. Int
netCoreWmemMax Sysctl-instelling net.core.wmem_max. Int
netIpv4IpLocalPortRange Sysctl-instelling net.ipv4.ip_local_port_range. snaar
netIpv4NeighDefaultGcThresh1 Sysctl-instelling net.ipv4.neigh.default.gc_thresh1. Int
netIpv4NeighDefaultGcThresh2 Sysctl-instelling net.ipv4.neigh.default.gc_thresh2. Int
netIpv4NeighDefaultGcThresh3 Sysctl-instelling net.ipv4.neigh.default.gc_thresh3. Int
netIpv4TcpFinTimeout Sysctl-instelling net.ipv4.tcp_fin_timeout. Int
netIpv4TcpkeepaliveIntvl Sysctl-instelling net.ipv4.tcp_keepalive_intvl. Int

Beperkingen:
Minimumwaarde = 10
Maximumwaarde = 90
netIpv4TcpKeepaliveProbes Sysctl-instelling net.ipv4.tcp_keepalive_probes. Int
netIpv4TcpKeepaliveTime Sysctl-instelling net.ipv4.tcp_keepalive_time. Int
netIpv4TcpMaxSynBacklog Sysctl-instelling net.ipv4.tcp_max_syn_backlog. Int
netIpv4TcpMaxTwBuckets Sysctl-instelling net.ipv4.tcp_max_tw_buckets. Int
netIpv4TcpTwReuse Sysctl-instelling net.ipv4.tcp_tw_reuse. Bool
netNetfilterNfConntrackBuckets Sysctl-instelling net.netfilter.nf_conntrack_buckets. Int

Beperkingen:
Minimumwaarde = 65536
Maximumwaarde = 524288
netNetfilterNfConntrackMax Sysctl-instelling net.netfilter.nf_conntrack_max. Int

Beperkingen:
Minimumwaarde = 131072
Maximumwaarde = 2097152
vmMaxMapCount Sysctl-instelling vm.max_map_count. Int
vmSwappiness Sysctl-instelling vm.swappiness. Int
vmVfsCachePressure Sysctl-instelling vm.vfs_cache_pressure. Int

AgentPoolNetworkProfile

Naam Beschrijving Waarde
allowedHostPorts De poortbereiken waartoe toegang is toegestaan. De opgegeven bereiken mogen elkaar overlappen. PortRange[]
applicationSecurityGroups De id's van de toepassingsbeveiligingsgroepen die door de agentgroep worden gekoppeld wanneer deze worden gemaakt. tekenreeks[]
nodePublicIPTags IPTags van openbare IP-adressen op exemplaarniveau. IPTag[]

PortRange

Naam Beschrijving Waarde
portEnd De maximale poort die is opgenomen in het bereik. Het moet variëren van 1 tot 65535 en groter zijn dan of gelijk zijn aan portStart. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 65535
portStart De minimale poort die is opgenomen in het bereik. Het moet variëren van 1 tot 65535 en kleiner dan of gelijk aan portEnd. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 65535
protocol Het netwerkprotocol van de poort. "TCP"
"UDP"

IPTag

Naam Beschrijving Waarde
ipTagType Het TYPE IP-tag. Voorbeeld: RoutingPreference. snaar
label De waarde van de IP-tag die is gekoppeld aan het openbare IP-adres. Voorbeeld: Internet. snaar

ManagedClusterAgentPoolProfilePropertiesNodeLabels

Naam Beschrijving Waarde
{aangepaste eigenschap} snaar

PowerState

Naam Beschrijving Waarde
code Hiermee wordt aangegeven of het cluster wordt uitgevoerd of gestopt "Wordt uitgevoerd"
"Gestopt"

AgentPoolUpgradeSettings

Naam Beschrijving Waarde
drainTimeoutInMinutes De hoeveelheid tijd (in minuten) om te wachten op verwijdering van pods en respijtvolle beëindiging per knooppunt. Deze verwijderingswachttijd eert het wachten op budgetten voor podonderbreking. Als deze tijd wordt overschreden, mislukt de upgrade. Als dit niet is opgegeven, is de standaardwaarde 30 minuten. Int

Beperkingen:
Minimumwaarde = 1
Maximumwaarde = 1440
maxSurge Dit kan worden ingesteld op een geheel getal (bijvoorbeeld '5') of een percentage (bijvoorbeeld '50%'). Als een percentage is opgegeven, is dit het percentage van de totale grootte van de agentgroep op het moment van de upgrade. Voor percentages worden breukknooppunten naar boven afgerond. Als dit niet is opgegeven, is de standaardwaarde 1. Zie voor meer informatie, inclusief aanbevolen procedures: /azure/aks/upgrade-cluster#customize-node-surge-upgrade snaar
nodeSoakDurationInMinutes De hoeveelheid tijd (in minuten) die moet worden gewacht na het leegmaken van een knooppunt en voordat u het opnieuw opgeeft en verdergaat met het volgende knooppunt. Als dit niet is opgegeven, is de standaardwaarde 0 minuten. Int

Beperkingen:
Minimumwaarde = 0
Maximumwaarde = 30