Partilhar via


ManagedClusterAgentPoolProfileProperties interface

Propriedades para o perfil do pool de agentes de serviço de contêiner.

Propriedades

availabilityZones

A lista de zonas de disponibilidade a serem usadas para nós. Isso só pode ser especificado se a propriedade AgentPoolType for 'VirtualMachineScaleSets'.

capacityReservationGroupID

O AKS associará o pool de agentes especificado ao Grupo de Reserva de Capacidade.

count

Número de agentes (VMs) para hospedar contêineres do docker. Os valores permitidos devem estar no intervalo de 0 a 1000 (inclusive) para grupos de usuários e no intervalo de 1 a 1000 (inclusive) para pools de sistema. O valor padrão é 1.

creationData

CreationData a ser usado para especificar o ID do instantâneo de origem se o pool de nós for criado/atualizado usando um instantâneo.

enableAutoScaling

Se o dimensionador automático deve ser ativado

enableCustomCATrust

Quando definido como true, o AKS implanta um daemonset e serviços de host para sincronizar autoridades de certificação personalizadas de um mapa de configuração fornecido pelo usuário em repositórios confiáveis de nó. O padrão é false.

enableEncryptionAtHost

Isso só é suportado em determinados tamanhos de VM e em determinadas regiões do Azure. Para mais informações, consulte: https://docs.microsoft.com/azure/aks/enable-host-encryption

enableFIPS

Consulte Adicionar um pool de nós habilitado para FIPS para obter mais detalhes.

enableNodePublicIP

Alguns cenários podem exigir que os nós em um pool de nós recebam seus próprios endereços IP públicos dedicados. Um cenário comum é para cargas de trabalho de jogos, onde um console precisa fazer uma conexão direta com uma máquina virtual em nuvem para minimizar saltos. Para obter mais informações, consulte atribuição de um IP público por nó. O padrão é false.

enableUltraSSD

Se o UltraSSD deve ser ativado

gpuInstanceProfile

GPUInstanceProfile a ser usado para especificar o perfil de instância MIG da GPU para GPU VM SKU suportado.

hostGroupID

Este é o formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Para obter mais informações, consulte hosts dedicados do Azure.

kubeletConfig

A configuração do Kubelet nos nós do pool de agentes.

kubeletDiskType

Determina o posicionamento de volumes emptyDir, raiz de dados de tempo de execução do contêiner e armazenamento efêmero do Kubelet.

linuxOSConfig

A configuração do sistema operacional dos nós do agente Linux.

maxCount

O número máximo de nós para dimensionamento automático

maxPods

O número máximo de pods que podem ser executados em um nó.

messageOfTheDay

Uma string codificada em base64 que será gravada em /etc/motd após a decodificação. Isso permite a personalização da mensagem do dia para nós Linux. Ele não deve ser especificado para nós do Windows. Deve ser uma string estática (ou seja, será impressa crua e não será executada como um script).

minCount

O número mínimo de nós para dimensionamento automático

mode

Um cluster deve ter pelo menos um Pool de Agentes do 'Sistema' o tempo todo. Para obter informações adicionais sobre restrições e práticas recomendadas do pool de agentes, consulte: https://docs.microsoft.com/azure/aks/use-system-pools

nodeLabels

Os rótulos de nó a serem persistidos em todos os nós no pool de agentes.

nodePublicIPPrefixID

Este é o formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}

nodeTaints

As manchas adicionadas aos novos nós durante a criação e dimensionamento do pool de nós. Por exemplo, key=value:NoSchedule.

orchestratorVersion

A versão do patch <o> major.minor.patch e <> major.minor são suportados. Quando <> major.minor é especificado, a versão mais recente do patch suportado é escolhida automaticamente. Atualizar o pool de agentes com o mesmo <> major.minor depois de criado não acionará uma atualização, mesmo que uma versão de patch mais recente esteja disponível. Como prática recomendada, você deve atualizar todos os pools de nós em um cluster AKS para a mesma versão do Kubernetes. A versão do pool de nós deve ter a mesma versão principal do plano de controle. A versão secundária do pool de nós deve estar dentro de duas versões secundárias da versão do plano de controle. A versão do pool de nós não pode ser maior do que a versão do plano de controle. Para obter mais informações, consulte atualizando um pool de nós.

osDiskSizeGB

Tamanho do disco do SO em GB a ser usado para especificar o tamanho do disco para cada máquina no pool mestre/agente. Se você especificar 0, ele aplicará o tamanho osDisk padrão de acordo com o vmSize especificado.

osDiskType

O padrão é 'Ephemeral' se a VM suportar e tiver um disco de cache maior do que o OSDiskSizeGB solicitado. Caso contrário, o padrão será 'Gerenciado'. Não pode ser alterado após a criação. Para obter mais informações, consulte Ephemeral OS.

osSKU

Especifica a SKU do sistema operacional usada pelo pool de agentes. Se não for especificado, o padrão é Ubuntu se OSType = Linux ou Windows2019 se OSType = Windows. E o OSSKU padrão do Windows será alterado para Windows2022 depois que o Windows2019 for preterido.

osType

O tipo de sistema operacional. O padrão é Linux.

podSubnetID

Se omitidos, os IPs pod são atribuídos estaticamente na sub-rede do nó (consulte vnetSubnetID para obter mais detalhes). Este é o formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}

powerState

Quando um pool de agentes é criado pela primeira vez, ele é inicialmente em execução. O Pool de Agentes pode ser interrompido definindo este campo como Parado. Um Pool de Agentes interrompido interrompe todas as suas VMs e não acumula encargos de cobrança. Um pool de agentes só pode ser interrompido se estiver em execução e o estado de provisionamento for bem-sucedido

proximityPlacementGroupID

A ID do Grupo de Posicionamento de Proximidade.

scaleDownMode

Isso também afeta o comportamento do autoscaler do cluster. Se não for especificado, o padrão será Excluir.

scaleSetEvictionPolicy

Isso não pode ser especificado, a menos que o scaleSetPriority seja 'Spot'. Se não for especificado, o padrão é 'Excluir'.

scaleSetPriority

A prioridade do Conjunto de Dimensionamento de Máquina Virtual. Se não for especificado, o padrão é 'Regular'.

spotMaxPrice

Os valores possíveis são qualquer valor decimal superior a zero ou -1 que indique a vontade de pagar qualquer preço sob demanda. Para obter mais detalhes sobre preços spot, consulte de preços de VMs spot

tags

As marcas a serem persistidas no conjunto de dimensionamento de máquina virtual do pool de agentes.

type

O tipo de pool de agentes.

upgradeSettings

Configurações para atualizar o agentpool

vmSize

A disponibilidade do tamanho da VM varia de acordo com a região. Se um nó contiver recursos de computação insuficientes (memória, cpu, etc), os pods podem falhar ao funcionar corretamente. Para obter mais detalhes sobre tamanhos restritos de VM, consulte: https://docs.microsoft.com/azure/aks/quotas-skus-regions

vnetSubnetID

Se isso não for especificado, uma VNET e uma sub-rede serão geradas e usadas. Se nenhum podSubnetID for especificado, isso se aplicará a nós e pods, caso contrário, se aplicará apenas a nós. Este é o formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}

workloadRuntime

Determina o tipo de carga de trabalho que um nó pode executar.

Detalhes de Propriedade

availabilityZones

A lista de zonas de disponibilidade a serem usadas para nós. Isso só pode ser especificado se a propriedade AgentPoolType for 'VirtualMachineScaleSets'.

availabilityZones?: string[]

Valor de Propriedade

string[]

capacityReservationGroupID

O AKS associará o pool de agentes especificado ao Grupo de Reserva de Capacidade.

capacityReservationGroupID?: string

Valor de Propriedade

string

count

Número de agentes (VMs) para hospedar contêineres do docker. Os valores permitidos devem estar no intervalo de 0 a 1000 (inclusive) para grupos de usuários e no intervalo de 1 a 1000 (inclusive) para pools de sistema. O valor padrão é 1.

count?: number

Valor de Propriedade

number

creationData

CreationData a ser usado para especificar o ID do instantâneo de origem se o pool de nós for criado/atualizado usando um instantâneo.

creationData?: CreationData

Valor de Propriedade

enableAutoScaling

Se o dimensionador automático deve ser ativado

enableAutoScaling?: boolean

Valor de Propriedade

boolean

enableCustomCATrust

Quando definido como true, o AKS implanta um daemonset e serviços de host para sincronizar autoridades de certificação personalizadas de um mapa de configuração fornecido pelo usuário em repositórios confiáveis de nó. O padrão é false.

enableCustomCATrust?: boolean

Valor de Propriedade

boolean

enableEncryptionAtHost

Isso só é suportado em determinados tamanhos de VM e em determinadas regiões do Azure. Para mais informações, consulte: https://docs.microsoft.com/azure/aks/enable-host-encryption

enableEncryptionAtHost?: boolean

Valor de Propriedade

boolean

enableFIPS

Consulte Adicionar um pool de nós habilitado para FIPS para obter mais detalhes.

enableFIPS?: boolean

Valor de Propriedade

boolean

enableNodePublicIP

Alguns cenários podem exigir que os nós em um pool de nós recebam seus próprios endereços IP públicos dedicados. Um cenário comum é para cargas de trabalho de jogos, onde um console precisa fazer uma conexão direta com uma máquina virtual em nuvem para minimizar saltos. Para obter mais informações, consulte atribuição de um IP público por nó. O padrão é false.

enableNodePublicIP?: boolean

Valor de Propriedade

boolean

enableUltraSSD

Se o UltraSSD deve ser ativado

enableUltraSSD?: boolean

Valor de Propriedade

boolean

gpuInstanceProfile

GPUInstanceProfile a ser usado para especificar o perfil de instância MIG da GPU para GPU VM SKU suportado.

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

Valor de Propriedade

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

hostGroupID

Este é o formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Para obter mais informações, consulte hosts dedicados do Azure.

hostGroupID?: string

Valor de Propriedade

string

kubeletConfig

A configuração do Kubelet nos nós do pool de agentes.

kubeletConfig?: KubeletConfig

Valor de Propriedade

kubeletDiskType

Determina o posicionamento de volumes emptyDir, raiz de dados de tempo de execução do contêiner e armazenamento efêmero do Kubelet.

kubeletDiskType?: "OS" | "Temporary"

Valor de Propriedade

"OS" | "Temporary"

linuxOSConfig

A configuração do sistema operacional dos nós do agente Linux.

linuxOSConfig?: LinuxOSConfig

Valor de Propriedade

maxCount

O número máximo de nós para dimensionamento automático

maxCount?: number

Valor de Propriedade

number

maxPods

O número máximo de pods que podem ser executados em um nó.

maxPods?: number

Valor de Propriedade

number

messageOfTheDay

Uma string codificada em base64 que será gravada em /etc/motd após a decodificação. Isso permite a personalização da mensagem do dia para nós Linux. Ele não deve ser especificado para nós do Windows. Deve ser uma string estática (ou seja, será impressa crua e não será executada como um script).

messageOfTheDay?: string

Valor de Propriedade

string

minCount

O número mínimo de nós para dimensionamento automático

minCount?: number

Valor de Propriedade

number

mode

Um cluster deve ter pelo menos um Pool de Agentes do 'Sistema' o tempo todo. Para obter informações adicionais sobre restrições e práticas recomendadas do pool de agentes, consulte: https://docs.microsoft.com/azure/aks/use-system-pools

mode?: "System" | "User"

Valor de Propriedade

"System" | "User"

nodeLabels

Os rótulos de nó a serem persistidos em todos os nós no pool de agentes.

nodeLabels?: Record<string, string>

Valor de Propriedade

Record<string, string>

nodePublicIPPrefixID

Este é o formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName}

nodePublicIPPrefixID?: string

Valor de Propriedade

string

nodeTaints

As manchas adicionadas aos novos nós durante a criação e dimensionamento do pool de nós. Por exemplo, key=value:NoSchedule.

nodeTaints?: string[]

Valor de Propriedade

string[]

orchestratorVersion

A versão do patch <o> major.minor.patch e <> major.minor são suportados. Quando <> major.minor é especificado, a versão mais recente do patch suportado é escolhida automaticamente. Atualizar o pool de agentes com o mesmo <> major.minor depois de criado não acionará uma atualização, mesmo que uma versão de patch mais recente esteja disponível. Como prática recomendada, você deve atualizar todos os pools de nós em um cluster AKS para a mesma versão do Kubernetes. A versão do pool de nós deve ter a mesma versão principal do plano de controle. A versão secundária do pool de nós deve estar dentro de duas versões secundárias da versão do plano de controle. A versão do pool de nós não pode ser maior do que a versão do plano de controle. Para obter mais informações, consulte atualizando um pool de nós.

orchestratorVersion?: string

Valor de Propriedade

string

osDiskSizeGB

Tamanho do disco do SO em GB a ser usado para especificar o tamanho do disco para cada máquina no pool mestre/agente. Se você especificar 0, ele aplicará o tamanho osDisk padrão de acordo com o vmSize especificado.

osDiskSizeGB?: number

Valor de Propriedade

number

osDiskType

O padrão é 'Ephemeral' se a VM suportar e tiver um disco de cache maior do que o OSDiskSizeGB solicitado. Caso contrário, o padrão será 'Gerenciado'. Não pode ser alterado após a criação. Para obter mais informações, consulte Ephemeral OS.

osDiskType?: "Managed" | "Ephemeral"

Valor de Propriedade

"Managed" | "Ephemeral"

osSKU

Especifica a SKU do sistema operacional usada pelo pool de agentes. Se não for especificado, o padrão é Ubuntu se OSType = Linux ou Windows2019 se OSType = Windows. E o OSSKU padrão do Windows será alterado para Windows2022 depois que o Windows2019 for preterido.

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

Valor de Propriedade

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

osType

O tipo de sistema operacional. O padrão é Linux.

osType?: "Linux" | "Windows"

Valor de Propriedade

"Linux" | "Windows"

podSubnetID

Se omitidos, os IPs pod são atribuídos estaticamente na sub-rede do nó (consulte vnetSubnetID para obter mais detalhes). Este é o formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}

podSubnetID?: string

Valor de Propriedade

string

powerState

Quando um pool de agentes é criado pela primeira vez, ele é inicialmente em execução. O Pool de Agentes pode ser interrompido definindo este campo como Parado. Um Pool de Agentes interrompido interrompe todas as suas VMs e não acumula encargos de cobrança. Um pool de agentes só pode ser interrompido se estiver em execução e o estado de provisionamento for bem-sucedido

powerState?: PowerState

Valor de Propriedade

proximityPlacementGroupID

A ID do Grupo de Posicionamento de Proximidade.

proximityPlacementGroupID?: string

Valor de Propriedade

string

scaleDownMode

Isso também afeta o comportamento do autoscaler do cluster. Se não for especificado, o padrão será Excluir.

scaleDownMode?: "Delete" | "Deallocate"

Valor de Propriedade

"Delete" | "Deallocate"

scaleSetEvictionPolicy

Isso não pode ser especificado, a menos que o scaleSetPriority seja 'Spot'. Se não for especificado, o padrão é 'Excluir'.

scaleSetEvictionPolicy?: "Delete" | "Deallocate"

Valor de Propriedade

"Delete" | "Deallocate"

scaleSetPriority

A prioridade do Conjunto de Dimensionamento de Máquina Virtual. Se não for especificado, o padrão é 'Regular'.

scaleSetPriority?: "Spot" | "Regular"

Valor de Propriedade

"Spot" | "Regular"

spotMaxPrice

Os valores possíveis são qualquer valor decimal superior a zero ou -1 que indique a vontade de pagar qualquer preço sob demanda. Para obter mais detalhes sobre preços spot, consulte de preços de VMs spot

spotMaxPrice?: number

Valor de Propriedade

number

tags

As marcas a serem persistidas no conjunto de dimensionamento de máquina virtual do pool de agentes.

tags?: Record<string, string>

Valor de Propriedade

Record<string, string>

type

O tipo de pool de agentes.

type?: "VirtualMachineScaleSets" | "AvailabilitySet"

Valor de Propriedade

"VirtualMachineScaleSets" | "AvailabilitySet"

upgradeSettings

Configurações para atualizar o agentpool

upgradeSettings?: AgentPoolUpgradeSettings

Valor de Propriedade

vmSize

A disponibilidade do tamanho da VM varia de acordo com a região. Se um nó contiver recursos de computação insuficientes (memória, cpu, etc), os pods podem falhar ao funcionar corretamente. Para obter mais detalhes sobre tamanhos restritos de VM, consulte: https://docs.microsoft.com/azure/aks/quotas-skus-regions

vmSize?: string

Valor de Propriedade

string

vnetSubnetID

Se isso não for especificado, uma VNET e uma sub-rede serão geradas e usadas. Se nenhum podSubnetID for especificado, isso se aplicará a nós e pods, caso contrário, se aplicará apenas a nós. Este é o formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/virtualNetworks/{virtualNetworkName}/subnets/{subnetName}

vnetSubnetID?: string

Valor de Propriedade

string

workloadRuntime

Determina o tipo de carga de trabalho que um nó pode executar.

workloadRuntime?: "OCIContainer" | "WasmWasi"

Valor de Propriedade

"OCIContainer" | "WasmWasi"