Gerenciar pools de nós para um cluster (AKS no Azure Stack HCI 22H2)
Aplica-se a: AKS no Azure Stack HCI 22H2, AKS no Windows Server
Observação
Para obter informações sobre como gerenciar pools de nós no AKS no Azure Stack HCI 23H2, consulte Gerenciar pools de nós.
No AKS habilitado pelo Azure Arc, os nós da mesma configuração são agrupados em pools de nós. Esses pools de nós contêm as VMs subjacentes que executam seus aplicativos. Este artigo mostra como criar e gerenciar pools de nós para um cluster no AKS Arc.
Observação
Esse recurso permite maior controle sobre como criar e gerenciar vários pools de nós. Como resultado, comandos separados são necessários para operações de criação, atualização e exclusão. Anteriormente, as operações de cluster por meio de New-AksHciCluster ou Set-AksHciCluster eram a única opção para criar ou dimensionar um cluster com um pool de nós do Windows e um pool de nós do Linux. Esse recurso expõe um conjunto de operações separado para pools de nós que exigem o uso dos comandos do pool de nós New-AksHciNodePool, Set-AksHciNodePool, Get-AksHciNodePool e Remove-AksHciNodePool para executar operações em um pool de nós individual.
Antes de começar
Recomendamos que você instale a versão 1.1.6. Se você já tiver o módulo do PowerShell instalado, execute o seguinte comando para localizar a versão:
Get-Command -Module AksHci
Se você precisar atualizar o PowerShell, siga as instruções em Atualizar o host do AKS.
Criar um cluster AKS
Para começar a usá-lo, crie um cluster do AKS com um único pool de nós. O exemplo a seguir usa o comando New-AksHciCluster para criar um novo cluster do Kubernetes com um pool de nós do Linux chamado linuxnodepool, que tem um nó. Se você já tiver um cluster implantado com uma versão mais antiga do AKS e quiser continuar usando sua implantação antiga, ignore esta etapa. Você ainda pode usar o novo conjunto de comandos do pool de nós para adicionar mais pool de nós ao cluster existente.
New-AksHciCluster -name mycluster -nodePoolName linuxnodepool -nodeCount 1 -osType linux
Observação
O parâmetro antigo definido para New-AksHciCluster ainda tem suporte.
Adicionar um pool de nós
O cluster chamado mycluster*', criado na etapa anterior, tem um único pool de nós. Você pode adicionar um segundo pool de nós ao cluster existente usando o comando New-AksHciNodePool . O exemplo a seguir cria um pool de nós do Windows chamado windowsnodepool com um nó. Verifique se o nome do pool de nós não é o mesmo nome que qualquer pool de nós existente.
New-AksHciNodePool -clusterName mycluster -name windowsnodepool -count 1 -osType Windows -osSku Windows2022
Obter informações de configuração de um pool de nós
Para ver as informações de configuração dos pools de nós, use o comando Get-AksHciNodePool .
Get-AksHciNodePool -clusterName mycluster
Saída de exemplo:
ClusterName : mycluster
NodePoolName : linuxnodepool
Version : v1.20.7
OsType : Linux
NodeCount : 1
VmSize : Standard_K8S3_v1
Phase : Deployed
ClusterName : mycluster
NodePoolName : windowsnodepool
Version : v1.20.7
OsType : Windows
NodeCount : 1
VmSize : Standard_K8S3_v1
Phase : Deployed
Para ver as informações de configuração de um pool de nós específico, use o -name parâmetro em Get-AksHciNodePool.
Get-AksHciNodePool -clusterName mycluster -name linuxnodepool
Saída de exemplo:
ClusterName : mycluster
NodePoolName : linuxnodepool
Version : v1.20.7
OsType : Linux
NodeCount : 1
VmSize : Standard_K8S3_v1
Phase : Deployed
Get-AksHciNodePool -clusterName mycluster -name windowsnodepool
Saída de exemplo:
ClusterName : mycluster
NodePoolName : windowsnodepool
Version : v1.20.7
OsType : Windows
NodeCount : 1
VmSize : Standard_K8S3_v1
Phase : Deployed
Observação
Se você usar os novos conjuntos de parâmetros no para implantar um cluster e, em New-AksHciCluster seguida, executar Get-AksHciCluster para obter as informações do cluster, os campos WindowsNodeCount e LinuxNodeCount na saída retornarão 0. Para obter o número preciso de nós em cada pool de nós, use o comando Get-AksHciNodePool com o nome do cluster especificado.
Dimensionar um pool de nós
Você pode escalar ou reduzir verticalmente o número de nós em um pool de nós.
Para dimensionar o número de nós em um pool de nós, use o comando Set-AksHciNodePool . O exemplo a seguir dimensiona o número de nós para 3 em um pool de nós chamado linuxnodepool no mycluster cluster.
Set-AksHciNodePool -clusterName mycluster -name linuxnodepool -count 3
Dimensionar nós do painel de controle
O gerenciamento de nós do painel de controle não mudou. A maneira como elas são criadas, dimensionadas e removidas permanece a mesma. Você ainda implantará nós do painel de controle com o comando New-AksHciCluster com os parâmetros controlPlaneNodeCount e controlPlaneVmSize com os valores padrão de 1 e Standard_A4_V2, respectivamente, se você não fornecer nenhum valor.
Talvez seja necessário dimensionar os nós do painel de controle à medida que a demanda de carga de trabalho de seus aplicativos mudar. Para dimensionar os nós do painel de controle, use o comando Set-AksHciCluster . O exemplo a seguir dimensiona os nós do painel de controle para 3 no mycluster cluster, que foi criado nas etapas anteriores.
Set-AksHciCluster -name mycluster -controlPlaneNodeCount 3
Excluir um pool de nós
Se você precisar excluir um pool de nós, use o comando Remove-AksHciNodePool . O exemplo a seguir remove o pool de nós chamado windowsnodepool do mycluster cluster.
Remove-AksHciNodePool -clusterName mycluster -name windowsnodepool
Especificar um taint para um pool de nós
Ao criar um pool de nós, você pode adicionar taints a esse pool de nós. Quando você adiciona um taint, todos os nós dentro desse pool de nós também obtêm esse taint. Para obter mais informações sobre taints e tolerations, consulte Taints e Tolerations do Kubernetes.
Configurar taints do pool de nós
Para criar um pool de nós com um taint, use New-AksHciNodePool. Especifique o nome taintnpe use o -taints parâmetro para especificar sku=gpu:noSchedule para o taint.
New-AksHciNodePool -clusterName mycluster -name taintnp -count 1 -osType linux -taints sku=gpu:NoSchedule
Observação
Um taint só pode ser definido para os pools de nós durante a criação do pool de nós.
Execute o comando a seguir para verificar se o pool de nós foi implantado com êxito com o taint especificado.
Get-AksHciNodePool -clusterName mycluster -name taintnp
Saída
Status : {Phase, Details}
ClusterName : mycluster
NodePoolName : taintnp
Version : v1.20.7-kvapkg.1
OsType : Linux
NodeCount : 1
VmSize : Standard_K8S3_v1
Phase : Deployed
Taints : {sku=gpu:NoSchedule}
Na etapa anterior, você aplicou o taint sku=gpu:NoSchedule ao criar o pool de nós. O manifesto YAML de exemplo básico a seguir usa um toleration para permitir que o agendador do Kubernetes execute um pod NGINX em um nó nesse pool de nós.
Crie um arquivo chamado nginx-toleration.yamle copie as informações no texto a seguir.
apiVersion: v1
kind: Pod
metadata:
name: mypod
spec:
containers:
- image: mcr.microsoft.com/oss/nginx/nginx:1.15.9-alpine
name: mypod
resources:
requests:
cpu: 100m
memory: 128Mi
limits:
cpu: 1
memory: 2G
tolerations:
- key: "sku"
operator: "Equal"
value: "gpu"
effect: "NoSchedule"
Em seguida, agende o pod usando o comando a seguir.
kubectl apply -f nginx-toleration.yaml
Para verificar se o pod foi implantado, execute o seguinte comando:
kubectl describe pod mypod
[...]
Tolerations: node.kubernetes.io/not-ready:NoExecute op=Exists for 300s
node.kubernetes.io/unreachable:NoExecute op=Exists for 300s
sku=gpu:NoSchedule
Events:
Type Reason Age From Message
---- ------ ---- ---- -------
Normal Scheduled 32s default-scheduler Successfully assigned default/mypod to moc-lk4iodl7h2y
Normal Pulling 30s kubelet Pulling image "mcr.microsoft.com/oss/nginx/nginx:1.15.9-alpine"
Normal Pulled 26s kubelet Successfully pulled image "mcr.microsoft.com/oss/nginx/nginx:1.15.9-alpine" in 4.529046457s
Normal Created 26s kubelet Created container mypod