ManagedClusterAgentPoolProfilePropertiesOutput interface
Proprietà per il profilo del pool di agenti del servizio contenitore.
Proprietà
| availability |
Elenco delle zone di disponibilità da usare per i nodi. Questa opzione può essere specificata solo se la proprietà AgentPoolType è "VirtualMachineScaleSets". |
| capacity |
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. |
| creation |
CreationData da usare per specificare l'ID snapshot di origine se il pool di nodi verrà creato/aggiornato usando uno snapshot. |
| current |
Se orchestratorVersion è una versione completamente specificata <major.minor.patch>, questo campo sarà esattamente uguale a esso. Se orchestratorVersion è stato <>major.minor , questo campo conterrà la versione< principale.secondaria.patch completa >. |
| enable |
Se abilitare il ridimensionamento automatico |
| enable |
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. |
| enable |
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. |
| enable |
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. |
| enable |
Se abilitare UltraSSD |
| gpu |
GPUInstanceProfile da usare per specificare il profilo di istanza MIG della GPU per lo SKU di VM GPU supportato. |
| host |
Questo è il formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Per altre informazioni, vedere host dedicati di Azure. |
| kubelet |
Configurazione di Kubelet nei nodi del pool di agenti. |
| kubelet |
Determina la posizione dei volumi emptyDir, della radice dei dati di runtime del contenitore e dell'archiviazione temporanea di Kubelet. |
| linux |
Configurazione del sistema operativo dei nodi dell'agente Linux. |
| max |
Numero massimo di nodi per il ridimensionamento automatico |
| max |
Numero massimo di pod che possono essere eseguiti in un nodo. |
| message |
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). |
| min |
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 |
| node |
Versione dell'immagine del nodo |
| node |
Etichette dei nodi da rendere persistenti in tutti i nodi nel pool di agenti. |
| node |
Modulo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} |
| node |
I contenitori aggiunti ai nuovi nodi durante la creazione e la scalabilità del pool di nodi. Ad esempio, key=value:NoSchedule. |
| orchestrator |
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. |
| os |
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. |
| os |
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. |
| os |
Tipo di sistema operativo. Il valore predefinito è Linux. |
| pod |
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} |
| power |
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 |
| provisioning |
Stato di distribuzione o provisioning corrente. |
| proximity |
ID del gruppo di posizionamento di prossimità. |
| scale |
Questo influisce anche sul comportamento del ridimensionamento automatico del cluster. Se non specificato, il valore predefinito è Delete. |
| scale |
Questa impostazione non può essere specificata a meno che scaleSetPriority non sia "Spot". Se non specificato, il valore predefinito è 'Delete'. |
| scale |
Priorità del set di scalabilità di macchine virtuali. Se non specificato, il valore predefinito è 'Regular'. |
| spot |
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. |
| upgrade |
Impostazioni per l'aggiornamento del pool di agenti |
| vm |
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 |
| vnet |
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} |
| workload |
Determina il tipo di carico di lavoro che un nodo può eseguire. |
Dettagli proprietà
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[]
capacityReservationGroupID
Il servizio Azure Kubernetes assocerà il pool di agenti specificato al gruppo di prenotazioni di capacità.
capacityReservationGroupID?: string
Valore della proprietà
string
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
creationData
CreationData da usare per specificare l'ID snapshot di origine se il pool di nodi verrà creato/aggiornato usando uno snapshot.
creationData?: CreationDataOutput
Valore della proprietà
currentOrchestratorVersion
Se orchestratorVersion è una versione completamente specificata <major.minor.patch>, questo campo sarà esattamente uguale a esso. Se orchestratorVersion è stato <>major.minor , questo campo conterrà la versione< principale.secondaria.patch completa >.
currentOrchestratorVersion?: string
Valore della proprietà
string
enableAutoScaling
Se abilitare il ridimensionamento automatico
enableAutoScaling?: boolean
Valore della proprietà
boolean
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
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
enableFIPS
Per altri dettagli, vedere Aggiungere un pool di nodi abilitato per FIPS.
enableFIPS?: boolean
Valore della proprietà
boolean
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
enableUltraSSD
Se abilitare UltraSSD
enableUltraSSD?: boolean
Valore della proprietà
boolean
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"
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
kubeletConfig
Configurazione di Kubelet nei nodi del pool di agenti.
kubeletConfig?: KubeletConfigOutput
Valore della proprietà
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"
linuxOSConfig
Configurazione del sistema operativo dei nodi dell'agente Linux.
linuxOSConfig?: LinuxOSConfigOutput
Valore della proprietà
maxCount
Numero massimo di nodi per il ridimensionamento automatico
maxCount?: number
Valore della proprietà
number
maxPods
Numero massimo di pod che possono essere eseguiti in un nodo.
maxPods?: number
Valore della proprietà
number
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
minCount
Numero minimo di nodi per il ridimensionamento automatico
minCount?: number
Valore della proprietà
number
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"
nodeImageVersion
Versione dell'immagine del nodo
nodeImageVersion?: string
Valore della proprietà
string
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>
nodePublicIPPrefixID
Modulo: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}
nodePublicIPPrefixID?: string
Valore della proprietà
string
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[]
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
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
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"
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"
osType
Tipo di sistema operativo. Il valore predefinito è Linux.
osType?: "Linux" | "Windows"
Valore della proprietà
"Linux" | "Windows"
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
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?: PowerStateOutput
Valore della proprietà
provisioningState
Stato di distribuzione o provisioning corrente.
provisioningState?: string
Valore della proprietà
string
proximityPlacementGroupID
ID del gruppo di posizionamento di prossimità.
proximityPlacementGroupID?: string
Valore della proprietà
string
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"
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"
scaleSetPriority
Priorità del set di scalabilità di macchine virtuali. Se non specificato, il valore predefinito è 'Regular'.
scaleSetPriority?: "Spot" | "Regular"
Valore della proprietà
"Spot" | "Regular"
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>
type
Tipo di pool di agenti.
type?: "VirtualMachineScaleSets" | "AvailabilitySet"
Valore della proprietà
"VirtualMachineScaleSets" | "AvailabilitySet"
upgradeSettings
Impostazioni per l'aggiornamento del pool di agenti
upgradeSettings?: AgentPoolUpgradeSettingsOutput
Valore della proprietà
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
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
workloadRuntime
Determina il tipo di carico di lavoro che un nodo può eseguire.
workloadRuntime?: "OCIContainer" | "WasmWasi"
Valore della proprietà
"OCIContainer" | "WasmWasi"