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, talvez queira adicionar um rótulo durante a criação do pool de nós. Os Rótulos de Kubernetes identificam as regras de agendamento para nós.

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

Criar um cluster do Kubernetes com um rótulo

Crie um cluster do 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 pool de nós com um rótulo

Crie um pool de nós com um rótulo usando o comando az aksarc nodepool add e especifique um nome para os parâmetros --name e rótulos para o parâmetro --labels. 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 com os 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 comando kubectl get nodes --show-labels.
```
kubectl get nodes --show-labels | grep -e "costcenter=6000" -e "dept=ACCT"
```

Rótulos indisponíveis

O AKS habilitado pelo Azure Arc segue as mesmas regras que o AKS:

Não é possível alterar o rótulo do sistema reservado. Se você tentar fazer isso, um erro será retornado.
Os prefixos reservados do Kubernetes e do 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óximas etapas

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

Compartilhar via