ManagedClusterAgentPoolProfileProperties interface
Propriedades para o perfil do pool de agentes de serviço de contêiner.
Propriedades
| availability |
A lista de zonas de disponibilidade a serem usadas para nós. Isso só pode ser especificado se a propriedade AgentPoolType for 'VirtualMachineScaleSets'. |
| capacity |
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. |
| creation |
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. |
| enable |
Se o dimensionador automático deve ser ativado |
| enable |
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. |
| enable |
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. |
| enable |
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. |
| enable |
Se o UltraSSD deve ser ativado |
| gpu |
GPUInstanceProfile a ser usado para especificar o perfil de instância MIG da GPU para GPU VM SKU suportado. |
| host |
Este é o formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/hostGroups/{hostGroupName}. Para obter mais informações, consulte hosts dedicados do Azure. |
| kubelet |
A configuração do Kubelet nos nós do pool de agentes. |
| kubelet |
Determina o posicionamento de volumes emptyDir, raiz de dados de tempo de execução do contêiner e armazenamento efêmero do Kubelet. |
| linux |
A configuração do sistema operacional dos nós do agente Linux. |
| max |
O número máximo de nós para dimensionamento automático |
| max |
O número máximo de pods que podem ser executados em um nó. |
| message |
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). |
| min |
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 |
| node |
Os rótulos de nó a serem persistidos em todos os nós no pool de agentes. |
| node |
Este é o formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/publicIPPrefixes/{publicIPPrefixName} |
| node |
As manchas adicionadas aos novos nós durante a criação e dimensionamento do pool de nós. Por exemplo, key=value:NoSchedule. |
| orchestrator |
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. |
| os |
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. |
| os |
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. |
| os |
O tipo de sistema operacional. O padrão é Linux. |
| pod |
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} |
| power |
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 |
| proximity |
A ID do Grupo de Posicionamento de Proximidade. |
| scale |
Isso também afeta o comportamento do autoscaler do cluster. Se não for especificado, o padrão será Excluir. |
| scale |
Isso não pode ser especificado, a menos que o scaleSetPriority seja 'Spot'. Se não for especificado, o padrão é 'Excluir'. |
| scale |
A prioridade do Conjunto de Dimensionamento de Máquina Virtual. Se não for especificado, o padrão é 'Regular'. |
| spot |
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. |
| upgrade |
Configurações para atualizar o agentpool |
| vm |
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 |
| vnet |
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} |
| workload |
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
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"