ManagedClusterAgentPoolProfile interface
Perfil para o pool de agentes de serviço de contêiner.
Propriedades
| name | Os nomes do pool de agentes do Windows devem ter 6 caracteres ou menos. |
Propriedades Herdadas
| 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
name
Os nomes do pool de agentes do Windows devem ter 6 caracteres ou menos.
name: string
Valor de Propriedade
string
Detalhes da Propriedade Herdada
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[]
herdada deManagedClusterAgentPoolProfileProperties.availabilityZones
capacityReservationGroupID
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
herdada deManagedClusterAgentPoolProfileProperties.creationData
enableAutoScaling
Se o dimensionador automático deve ser ativado
enableAutoScaling?: boolean
Valor de Propriedade
boolean
herdado deManagedClusterAgentPoolProfileProperties.enableAutoScaling
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
herdado de ManagedClusterAgentPoolProfileProperties.enableCustomCATrust
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
herdado de ManagedClusterAgentPoolProfileProperties.enableEncryptionAtHost
enableFIPS
Consulte Adicionar um pool de nós habilitado para FIPS para obter mais detalhes.
enableFIPS?: boolean
Valor de Propriedade
boolean
herdado de ManagedClusterAgentPoolProfileProperties.enableFIPS
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
herdado de ManagedClusterAgentPoolProfileProperties.enableNodePublicIP
enableUltraSSD
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"
herdado de ManagedClusterAgentPoolProfileProperties.gpuInstanceProfile
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
herdado deManagedClusterAgentPoolProfileProperties.hostGroupID
kubeletConfig
kubeletDiskType
linuxOSConfig
maxCount
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
herdado deManagedClusterAgentPoolProfileProperties.messageOfTheDay
minCount
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>
herdado deManagedClusterAgentPoolProfileProperties.nodeLabels
nodePublicIPPrefixID
nodeTaints
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
herdado doManagedClusterAgentPoolProfileProperties.orchestratorVersion
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
herdado doManagedClusterAgentPoolProfileProperties.osDiskSizeGB
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"
herdado de ManagedClusterAgentPoolProfileProperties.osDiskType
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
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
herdado de ManagedClusterAgentPoolProfileProperties.podSubnetID
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
herdado de ManagedClusterAgentPoolProfileProperties.powerState
proximityPlacementGroupID
A ID do Grupo de Posicionamento de Proximidade.
proximityPlacementGroupID?: string
Valor de Propriedade
string
herdado deManagedClusterAgentPoolProfileProperties.proximityPlacementGroupID
scaleDownMode
scaleSetEvictionPolicy
scaleSetPriority
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
herdado deManagedClusterAgentPoolProfileProperties.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
herdado deManagedClusterAgentPoolProfileProperties.upgradeSettings
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
herdado de ManagedClusterAgentPoolProfileProperties.vnetSubnetID