ManagedClusterAgentPoolProfile interface

Pacchetto:

@azure-rest/arm-containerservice

Profilatura per il pool di agenti del servizio contenitore.

Extends

ManagedClusterAgentPoolProfileProperties

Proprietà

name	I nomi del pool di agenti di Windows devono essere di almeno 6 caratteri.

Proprietà ereditate

availabilityZones	Elenco delle zone di disponibilità da usare per i nodi. Questa opzione può essere specificata solo se la proprietà AgentPoolType è "VirtualMachineScaleSets".
capacityReservationGroupID	Il servizio Azure Kubernetes assocerà il pool di agenti specificato al gruppo di prenotazioni di capacità.
count	Numero di agenti (VM) per ospitare contenitori Docker. I valori consentiti devono essere compresi nell'intervallo compreso tra 0 e 1000 (inclusi) per i pool di utenti e nell'intervallo compreso tra 1 e 1000 (inclusi) per i pool di sistema. Il valore predefinito è 1.
creationData	CreationData da usare per specificare l'ID snapshot di origine se il pool di nodi verrà creato/aggiornato usando uno snapshot.
enableAutoScaling	Se abilitare il ridimensionamento automatico
enableCustomCATrust	Se impostato su true, il servizio Azure Kubernetes distribuisce un daemonset e servizi host per sincronizzare le autorità di certificazione personalizzate da una mappa di configurazione fornita dall'utente in archivi attendibili dei nodi. Il valore predefinito è false.
enableEncryptionAtHost	Questa opzione è supportata solo in determinate dimensioni di vm e in determinate aree di Azure. Per altre informazioni, vedere: https://docs.microsoft.com/azure/aks/enable-host-encryption
enableFIPS	Per altri dettagli, vedere Aggiungere un pool di nodi abilitato per FIPS.
enableNodePublicIP	Alcuni scenari possono richiedere che i nodi in un pool di nodi ricevano i propri indirizzi IP pubblici dedicati. Uno scenario comune riguarda i carichi di lavoro di gioco, in cui una console deve stabilire una connessione diretta a una macchina virtuale cloud per ridurre al minimo gli hop. Per altre informazioni, vedere l'assegnazione di un indirizzo IP pubblico per nodo. Il valore predefinito è false.
enableUltraSSD	Se abilitare UltraSSD
gpuInstanceProfile	GPUInstanceProfile da usare per specificare il profilo di istanza MIG della GPU per lo SKU di VM GPU supportato.
hostGroupID	Questo è il formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Per altre informazioni, vedere host dedicati di Azure.
kubeletConfig	Configurazione di Kubelet nei nodi del pool di agenti.
kubeletDiskType	Determina la posizione dei volumi emptyDir, della radice dei dati di runtime del contenitore e dell'archiviazione temporanea di Kubelet.
linuxOSConfig	Configurazione del sistema operativo dei nodi dell'agente Linux.
maxCount	Numero massimo di nodi per il ridimensionamento automatico
maxPods	Numero massimo di pod che possono essere eseguiti in un nodo.
messageOfTheDay	Stringa con codifica base64 che verrà scritta in /etc/motd dopo la decodifica. In questo modo è possibile personalizzare il messaggio del giorno per i nodi Linux. Non deve essere specificato per i nodi Windows. Deve essere una stringa statica (ad esempio, verrà stampato non elaborato e non verrà eseguito come script).
minCount	Numero minimo di nodi per il ridimensionamento automatico
mode	Un cluster deve avere sempre almeno un pool di agenti "System". Per altre informazioni sulle restrizioni del pool di agenti e sulle procedure consigliate, vedere: https://docs.microsoft.com/azure/aks/use-system-pools
nodeLabels	Etichette dei nodi da rendere persistenti in tutti i nodi nel pool di agenti.
nodePublicIPPrefixID	Modulo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
nodeTaints	I contenitori aggiunti ai nuovi nodi durante la creazione e la scalabilità del pool di nodi. Ad esempio, key=value:NoSchedule.
orchestratorVersion	Sono supportate entrambe le versioni patch <> major.minor.patch e <> major.minor. Quando si specifica <> major.minor, viene scelta automaticamente la versione della patch supportata più recente. L'aggiornamento del pool di agenti con lo stesso <major.minor> dopo la creazione non attiverà un aggiornamento, anche se è disponibile una versione patch più recente. Come procedura consigliata, è consigliabile aggiornare tutti i pool di nodi in un cluster del servizio Azure Kubernetes alla stessa versione di Kubernetes. La versione del pool di nodi deve avere la stessa versione principale del piano di controllo. La versione secondaria del pool di nodi deve trovarsi all'interno di due versioni secondarie della versione del piano di controllo. La versione del pool di nodi non può essere maggiore della versione del piano di controllo. Per altre informazioni, vedere l'aggiornamento di un pool di nodi.
osDiskSizeGB	Dimensioni disco del sistema operativo in GB da usare per specificare le dimensioni del disco per ogni computer nel pool master/agente. Se si specifica 0, verrà applicata la dimensione osDisk predefinita in base all'opzione vmSize specificata.
osDiskType	Il valore predefinito è "Ephemeral" se la macchina virtuale lo supporta e ha un disco della cache maggiore di quello richiesto OSDiskSizeGB. In caso contrario, il valore predefinito è "Gestito". Non può essere modificato dopo la creazione. Per altre informazioni, vedere sistema operativo temporaneo.
osSKU	Specifica lo SKU del sistema operativo usato dal pool di agenti. Se non specificato, il valore predefinito è Ubuntu se OSType=Linux o Windows2019 se OSType=Windows. E il sistema operativo Windows predefinito verrà modificato in Windows2022 dopo che Windows2019 è deprecato.
osType	Tipo di sistema operativo. Il valore predefinito è Linux.
podSubnetID	Se omesso, gli indirizzi IP dei pod vengono assegnati in modo statico nella subnet del nodo (vedere vnetSubnetID per altri dettagli). Questo è il formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
powerState	Quando viene creato per la prima volta, un pool di agenti è in esecuzione inizialmente. Il pool di agenti può essere arrestato impostando questo campo su Arrestato. Un pool di agenti arrestato arresta tutte le macchine virtuali e non accumula addebiti per la fatturazione. Un pool di agenti può essere arrestato solo se è in esecuzione e lo stato di provisioning è Succeeded
proximityPlacementGroupID	ID del gruppo di posizionamento di prossimità.
scaleDownMode	Questo influisce anche sul comportamento del ridimensionamento automatico del cluster. Se non specificato, il valore predefinito è Delete.
scaleSetEvictionPolicy	Questa impostazione non può essere specificata a meno che scaleSetPriority non sia "Spot". Se non specificato, il valore predefinito è 'Delete'.
scaleSetPriority	Priorità del set di scalabilità di macchine virtuali. Se non specificato, il valore predefinito è 'Regular'.
spotMaxPrice	I valori possibili sono qualsiasi valore decimale maggiore di zero o -1 che indica la disponibilità a pagare qualsiasi prezzo su richiesta. Per altre informazioni sui prezzi spot, vedere prezzi delle macchine virtuali spot
tags	Tag da rendere persistenti nel set di scalabilità di macchine virtuali del pool di agenti.
type	Tipo di pool di agenti.
upgradeSettings	Impostazioni per l'aggiornamento del pool di agenti
vmSize	La disponibilità delle dimensioni della macchina virtuale varia in base all'area. Se un nodo contiene risorse di calcolo insufficienti (memoria, CPU e così via) i pod potrebbero non essere eseguiti correttamente. Per altre informazioni sulle dimensioni delle macchine virtuali con restrizioni, vedere: https://docs.microsoft.com/azure/aks/quotas-skus-regions
vnetSubnetID	Se non viene specificato, verrà generata e usata una rete virtuale e una subnet. Se non viene specificato alcun podSubnetID, questo vale per nodi e pod, altrimenti si applica solo ai nodi. Questo è il formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}
workloadRuntime	Determina il tipo di carico di lavoro che un nodo può eseguire.

Dettagli proprietà

name

I nomi del pool di agenti di Windows devono essere di almeno 6 caratteri.

name: string

Valore della proprietà

string

Dettagli proprietà ereditate

availabilityZones

Elenco delle zone di disponibilità da usare per i nodi. Questa opzione può essere specificata solo se la proprietà AgentPoolType è "VirtualMachineScaleSets".

availabilityZones?: string[]

Valore della proprietà

string[]

ereditato daManagedClusterAgentPoolProfileProperties.availabilityZones

capacityReservationGroupID

Il servizio Azure Kubernetes assocerà il pool di agenti specificato al gruppo di prenotazioni di capacità.

capacityReservationGroupID?: string

Valore della proprietà

string

ereditato daManagedClusterAgentPoolProfileProperties.capacityReservationGroupID

count

Numero di agenti (VM) per ospitare contenitori Docker. I valori consentiti devono essere compresi nell'intervallo compreso tra 0 e 1000 (inclusi) per i pool di utenti e nell'intervallo compreso tra 1 e 1000 (inclusi) per i pool di sistema. Il valore predefinito è 1.

count?: number

Valore della proprietà

number

ereditato daManagedClusterAgentPoolProfileProperties.count

creationData

CreationData da usare per specificare l'ID snapshot di origine se il pool di nodi verrà creato/aggiornato usando uno snapshot.

creationData?: CreationData

Valore della proprietà

CreationData

ereditato daManagedClusterAgentPoolProfileProperties.creationData

enableAutoScaling

Se abilitare il ridimensionamento automatico

enableAutoScaling?: boolean

Valore della proprietà

boolean

ereditato daManagedClusterAgentPoolProfileProperties.enableAutoScaling

enableCustomCATrust

Se impostato su true, il servizio Azure Kubernetes distribuisce un daemonset e servizi host per sincronizzare le autorità di certificazione personalizzate da una mappa di configurazione fornita dall'utente in archivi attendibili dei nodi. Il valore predefinito è false.

enableCustomCATrust?: boolean

Valore della proprietà

boolean

ereditato daManagedClusterAgentPoolProfileProperties.enableCustomCATrust

enableEncryptionAtHost

Questa opzione è supportata solo in determinate dimensioni di vm e in determinate aree di Azure. Per altre informazioni, vedere: https://docs.microsoft.com/azure/aks/enable-host-encryption

enableEncryptionAtHost?: boolean

Valore della proprietà

boolean

ereditato daManagedClusterAgentPoolProfileProperties.enableEncryptionAtHost

enableFIPS

Per altri dettagli, vedere Aggiungere un pool di nodi abilitato per FIPS.

enableFIPS?: boolean

Valore della proprietà

boolean

Ereditato daManagedClusterAgentPoolProfileProperties.enableFIPS

enableNodePublicIP

Alcuni scenari possono richiedere che i nodi in un pool di nodi ricevano i propri indirizzi IP pubblici dedicati. Uno scenario comune riguarda i carichi di lavoro di gioco, in cui una console deve stabilire una connessione diretta a una macchina virtuale cloud per ridurre al minimo gli hop. Per altre informazioni, vedere l'assegnazione di un indirizzo IP pubblico per nodo. Il valore predefinito è false.

enableNodePublicIP?: boolean

Valore della proprietà

boolean

ereditato daManagedClusterAgentPoolProfileProperties.enableNodePublicIP

enableUltraSSD

Se abilitare UltraSSD

enableUltraSSD?: boolean

Valore della proprietà

boolean

ereditato daManagedClusterAgentPoolProfileProperties.enableUltraSSD

gpuInstanceProfile

GPUInstanceProfile da usare per specificare il profilo di istanza MIG della GPU per lo SKU di VM GPU supportato.

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

Valore della proprietà

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

ereditato daManagedClusterAgentPoolProfileProperties.gpuInstanceProfile

hostGroupID

Questo è il formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Per altre informazioni, vedere host dedicati di Azure.

hostGroupID?: string

Valore della proprietà

string

ereditato daManagedClusterAgentPoolProfileProperties.hostGroupID

kubeletConfig

Configurazione di Kubelet nei nodi del pool di agenti.

kubeletConfig?: KubeletConfig

Valore della proprietà

KubeletConfig

ereditato daManagedClusterAgentPoolProfileProperties.kubeletConfig

kubeletDiskType

Determina la posizione dei volumi emptyDir, della radice dei dati di runtime del contenitore e dell'archiviazione temporanea di Kubelet.

kubeletDiskType?: "OS" | "Temporary"

Valore della proprietà

"OS" | "Temporary"

Ereditato daManagedClusterAgentPoolProfileProperties.kubeletDiskType

linuxOSConfig

Configurazione del sistema operativo dei nodi dell'agente Linux.

linuxOSConfig?: LinuxOSConfig

Valore della proprietà

LinuxOSConfig

ereditato daManagedClusterAgentPoolProfileProperties.linuxOSConfig

maxCount

Numero massimo di nodi per il ridimensionamento automatico

maxCount?: number

Valore della proprietà

number

ereditato daManagedClusterAgentPoolProfileProperties.maxCount

maxPods

Numero massimo di pod che possono essere eseguiti in un nodo.

maxPods?: number

Valore della proprietà

number

ereditato daManagedClusterAgentPoolProfileProperties.maxPods

messageOfTheDay

Stringa con codifica base64 che verrà scritta in /etc/motd dopo la decodifica. In questo modo è possibile personalizzare il messaggio del giorno per i nodi Linux. Non deve essere specificato per i nodi Windows. Deve essere una stringa statica (ad esempio, verrà stampato non elaborato e non verrà eseguito come script).

messageOfTheDay?: string

Valore della proprietà

string

ereditato daManagedClusterAgentPoolProfileProperties.messageOfTheDay

minCount

Numero minimo di nodi per il ridimensionamento automatico

minCount?: number

Valore della proprietà

number

ereditato daManagedClusterAgentPoolProfileProperties.minCount

mode

Un cluster deve avere sempre almeno un pool di agenti "System". Per altre informazioni sulle restrizioni del pool di agenti e sulle procedure consigliate, vedere: https://docs.microsoft.com/azure/aks/use-system-pools

mode?: "System" | "User"

Valore della proprietà

"System" | "User"

ereditato daManagedClusterAgentPoolProfileProperties.mode

nodeLabels

Etichette dei nodi da rendere persistenti in tutti i nodi nel pool di agenti.

nodeLabels?: Record<string, string>

Valore della proprietà

Record<string, string>

ereditato daManagedClusterAgentPoolProfileProperties.nodeLabels

nodePublicIPPrefixID

Modulo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}

nodePublicIPPrefixID?: string

Valore della proprietà

string

ereditato daManagedClusterAgentPoolProfileProperties.nodePublicIPPrefixID

nodeTaints

I contenitori aggiunti ai nuovi nodi durante la creazione e la scalabilità del pool di nodi. Ad esempio, key=value:NoSchedule.

nodeTaints?: string[]

Valore della proprietà

string[]

ereditato daManagedClusterAgentPoolProfileProperties.nodeTaints

orchestratorVersion

Sono supportate entrambe le versioni patch <> major.minor.patch e <> major.minor. Quando si specifica <> major.minor, viene scelta automaticamente la versione della patch supportata più recente. L'aggiornamento del pool di agenti con lo stesso <major.minor> dopo la creazione non attiverà un aggiornamento, anche se è disponibile una versione patch più recente. Come procedura consigliata, è consigliabile aggiornare tutti i pool di nodi in un cluster del servizio Azure Kubernetes alla stessa versione di Kubernetes. La versione del pool di nodi deve avere la stessa versione principale del piano di controllo. La versione secondaria del pool di nodi deve trovarsi all'interno di due versioni secondarie della versione del piano di controllo. La versione del pool di nodi non può essere maggiore della versione del piano di controllo. Per altre informazioni, vedere l'aggiornamento di un pool di nodi.

orchestratorVersion?: string

Valore della proprietà

string

ereditato daManagedClusterAgentPoolProfileProperties.orchestratorVersion

osDiskSizeGB

Dimensioni disco del sistema operativo in GB da usare per specificare le dimensioni del disco per ogni computer nel pool master/agente. Se si specifica 0, verrà applicata la dimensione osDisk predefinita in base all'opzione vmSize specificata.

osDiskSizeGB?: number

Valore della proprietà

number

ereditato daManagedClusterAgentPoolProfileProperties.osDiskSizeGB

osDiskType

Il valore predefinito è "Ephemeral" se la macchina virtuale lo supporta e ha un disco della cache maggiore di quello richiesto OSDiskSizeGB. In caso contrario, il valore predefinito è "Gestito". Non può essere modificato dopo la creazione. Per altre informazioni, vedere sistema operativo temporaneo.

osDiskType?: "Managed" | "Ephemeral"

Valore della proprietà

"Managed" | "Ephemeral"

ereditato daManagedClusterAgentPoolProfileProperties.osDiskType

osSKU

Specifica lo SKU del sistema operativo usato dal pool di agenti. Se non specificato, il valore predefinito è Ubuntu se OSType=Linux o Windows2019 se OSType=Windows. E il sistema operativo Windows predefinito verrà modificato in Windows2022 dopo che Windows2019 è deprecato.

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

Valore della proprietà

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

ereditato daManagedClusterAgentPoolProfileProperties.osSKU

osType

Tipo di sistema operativo. Il valore predefinito è Linux.

osType?: "Linux" | "Windows"

Valore della proprietà

"Linux" | "Windows"

ereditato daManagedClusterAgentPoolProfileProperties.osType

podSubnetID

Se omesso, gli indirizzi IP dei pod vengono assegnati in modo statico nella subnet del nodo (vedere vnetSubnetID per altri dettagli). Questo è il formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}

podSubnetID?: string

Valore della proprietà

string

ereditato daManagedClusterAgentPoolProfileProperties.podSubnetID

powerState

Quando viene creato per la prima volta, un pool di agenti è in esecuzione inizialmente. Il pool di agenti può essere arrestato impostando questo campo su Arrestato. Un pool di agenti arrestato arresta tutte le macchine virtuali e non accumula addebiti per la fatturazione. Un pool di agenti può essere arrestato solo se è in esecuzione e lo stato di provisioning è Succeeded

powerState?: PowerState

Valore della proprietà

PowerState

ereditato daManagedClusterAgentPoolProfileProperties.powerState

proximityPlacementGroupID

ID del gruppo di posizionamento di prossimità.

proximityPlacementGroupID?: string

Valore della proprietà

string

ereditato daManagedClusterAgentPoolProfileProperties.proximityPlacementGroupID

scaleDownMode

Questo influisce anche sul comportamento del ridimensionamento automatico del cluster. Se non specificato, il valore predefinito è Delete.

scaleDownMode?: "Delete" | "Deallocate"

Valore della proprietà

"Delete" | "Deallocate"

ereditato daManagedClusterAgentPoolProfileProperties.scaleDownMode

scaleSetEvictionPolicy

Questa impostazione non può essere specificata a meno che scaleSetPriority non sia "Spot". Se non specificato, il valore predefinito è 'Delete'.

scaleSetEvictionPolicy?: "Delete" | "Deallocate"

Valore della proprietà

"Delete" | "Deallocate"

ereditato daManagedClusterAgentPoolProfileProperties.scaleSetEvictionPolicy

scaleSetPriority

Priorità del set di scalabilità di macchine virtuali. Se non specificato, il valore predefinito è 'Regular'.

scaleSetPriority?: "Spot" | "Regular"

Valore della proprietà

"Spot" | "Regular"

ereditato daManagedClusterAgentPoolProfileProperties.scaleSetPriority

spotMaxPrice

I valori possibili sono qualsiasi valore decimale maggiore di zero o -1 che indica la disponibilità a pagare qualsiasi prezzo su richiesta. Per altre informazioni sui prezzi spot, vedere prezzi delle macchine virtuali spot

spotMaxPrice?: number

Valore della proprietà

number

ereditato daManagedClusterAgentPoolProfileProperties.spotMaxPrice

tags

Tag da rendere persistenti nel set di scalabilità di macchine virtuali del pool di agenti.

tags?: Record<string, string>

Valore della proprietà

Record<string, string>

ereditato daManagedClusterAgentPoolProfileProperties.tags

type

Tipo di pool di agenti.

type?: "VirtualMachineScaleSets" | "AvailabilitySet"

Valore della proprietà

"VirtualMachineScaleSets" | "AvailabilitySet"

ereditato daManagedClusterAgentPoolProfileProperties.type

upgradeSettings

Impostazioni per l'aggiornamento del pool di agenti

upgradeSettings?: AgentPoolUpgradeSettings

Valore della proprietà

AgentPoolUpgradeSettings

ereditato daManagedClusterAgentPoolProfileProperties.upgradeSettings

vmSize

La disponibilità delle dimensioni della macchina virtuale varia in base all'area. Se un nodo contiene risorse di calcolo insufficienti (memoria, CPU e così via) i pod potrebbero non essere eseguiti correttamente. Per altre informazioni sulle dimensioni delle macchine virtuali con restrizioni, vedere: https://docs.microsoft.com/azure/aks/quotas-skus-regions

vmSize?: string

Valore della proprietà

string

ereditato daManagedClusterAgentPoolProfileProperties.vmSize

vnetSubnetID

Se non viene specificato, verrà generata e usata una rete virtuale e una subnet. Se non viene specificato alcun podSubnetID, questo vale per nodi e pod, altrimenti si applica solo ai nodi. Questo è il formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}

vnetSubnetID?: string

Valore della proprietà

string

ereditato daManagedClusterAgentPoolProfileProperties.vnetSubnetID

workloadRuntime

Determina il tipo di carico di lavoro che un nodo può eseguire.

workloadRuntime?: "OCIContainer" | "WasmWasi"

Valore della proprietà

"OCIContainer" | "WasmWasi"

ereditato daManagedClusterAgentPoolProfileProperties.workloadRuntime