Microsoft.ContainerService managedClusters/agentPools 2024-01-01
- meest recente
- 2024-06-02-preview-
- 2024-05-02-preview-
- 2024-05-01
- 2024-04-02-preview-
- 2024-03-02-preview-
- 2024-02-01
- 2024-01-02-preview-
- 2024-01-01
- 2023-11-02-preview-
- 2023-11-01
- 2023-10-02-preview
- 2023-10-01
- 2023-09-02-preview-
- 2023-09-01
- 2023-08-02-preview-
- 2023-08-01
- 2023-07-02-preview-
- 2023-07-01
- 2023-06-02-preview-
- 2023-06-01
- 2023-05-02-preview-
- 2023-05-01
- 2023-04-02-preview-
- 2023-04-01
- 2023-03-02-preview-
- 2023-03-01
- 2023-02-02-preview-
- 2023-02-01
- 2023-01-02-preview
- 2023-01-01
- 2022-11-02-preview
- 2022-11-01
- 2022-10-02-preview-
- 2022-09-01
- 2022-08-03-preview-
- 2022-08-02-preview-
- 2022-07-01
- 2022-06-01
- 2022-04-01
- 2022-03-01
- 2022-02-01
- 2022-01-01
- 2021-10-01
- 2021-09-01
- 2021-08-01
- 2021-07-01
- 2021-05-01
- 2021-03-01
- 2021-02-01
- 2020-12-01
- 2020-11-01
- 2020-09-01
Bicep-resourcedefinitie
Het resourcetype managedClusters/agentPools kan worden geïmplementeerd met bewerkingen die zijn gericht op:
- Resourcegroepen - Zie opdrachten voor de implementatie van 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 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- |
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:
- Resourcegroepen - Zie opdrachten voor de implementatie van 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 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- |
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 |