Usar rótulos de cluster no AKS habilitado pelo Azure Arc

Artigo
11/23/2024

Aplica-se a: Azure Local, versão 23H2

Se você tiver vários pools de nós, convém adicionar um rótulo durante a criação do pool de nós. Os rótulos do Kubernetes lidam com as regras de agendamento para nós.

Este artigo descreve como usar rótulos em um cluster Kubernetes no AKS habilitado pelo Arc.

Criar um cluster Kubernetes com um rótulo

Crie um cluster Kubernetes com um rótulo usando o az aksarc create comando e especifique o --node-labels parâmetro para definir seus rótulos. Os rótulos devem ser um par chave/valor e ter sintaxe válida.
```
az aksarc create --resource-group myResourceGroup --name myAKSCluster --node-count 2 --nodepool-labels dept=IT
```
Verifique se os rótulos foram definidos usando o kubectl get nodes --show-labels comando:
```
kubectl get nodes --show-labels | grep -e "dept=IT"
```

Criar um conjunto de nós com uma etiqueta

Crie um pool de nós com um rótulo usando o az aksarc nodepool add comando e especifique um nome para os --name parâmetros e rótulos para o --labels parâmetro. Os rótulos devem ser um par chave/valor e ter sintaxe válida.

O exemplo a seguir cria um pool de nós nomeado labelnp com o rótulo dept=HR:
```
az aksarc nodepool add --resource-group myResourceGroup --cluster-name myAKSCluster --name labelnp --node-count 1 --labels dept=HR –no-wait
```
O exemplo de saída a seguir do comando mostra que az aksarc nodepool list o labelnp pool de nós cria nós com o especificado nodeLabels:
```
[
  {
    ...
    "count": 1,
    ...
    "name": "labelnp",
    "orchestratorVersion": "1.15.7",
    ...
    "provisioningState": "Creating",
    ...
    "nodeLabels":  {
      "costcenter": "5000",
      "dept": "HR"
    },
    ...
  },
 ...
]
```
Verifique se os rótulos foram definidos usando o kubectl get nodes --show-labels comando:
```
kubectl get nodes --show-labels | grep -e "dept=HR"
```

Atualizar rótulos em pools de nós existentes

Atualize um rótulo em um pool de nós existente usando o comando az aksarc nodepool update . A atualização de rótulos em pools de nós existentes substitui os rótulos antigos pelos novos rótulos. Os rótulos devem ser pares chave/valor e ter uma sintaxe válida.
```
az aksarc nodepool update --resource-group myResourceGroup --cluster-name myAKSCluster --name labelnp --labels dept=ACCT costcenter=6000 --no-wait
```
Verifique se os rótulos foram definidos usando o kubectl get nodes --show-labels comando.
```
kubectl get nodes --show-labels | grep -e "costcenter=6000" -e "dept=ACCT"
```

Etiquetas indisponíveis

O AKS habilitado pelo Azure Arc segue as mesmas regras do AKS:

Não é possível alterar o rótulo do sistema reservado. Se você tentar fazer isso, um erro será retornado.
Os prefixos reservados Kubernetes e AKS não podem ser usados para nenhum nó.

Para obter mais informações, consulte Rótulos indisponíveis na documentação do AKS.

Próximos passos

Para obter mais informações sobre rótulos do Kubernetes, consulte a documentação do Kubernetes.

Partilhar via