Utilizar etiquetas de cluster no AKS ativadas pelo Azure Arc

Artigo
08/01/2024

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

Se tiver vários conjuntos de nós, poderá querer adicionar uma etiqueta durante a criação do conjunto de nós. As etiquetas do Kubernetes processam as regras de agendamento dos nós.

Este artigo descreve como utilizar etiquetas num cluster do Kubernetes no AKS ativado pelo Arc.

Criar um cluster do Kubernetes com uma etiqueta

Crie um cluster do Kubernetes com uma etiqueta com o az aksarc create comando e especifique o --node-labels parâmetro para definir as etiquetas. As etiquetas têm de 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 as etiquetas foram definidas com 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 conjunto de nós com uma etiqueta com o az aksarc nodepool add comando e especifique um nome para os --name parâmetros e etiquetas para o --labels parâmetro. As etiquetas têm de ser um par chave/valor e ter sintaxe válida.

O exemplo seguinte cria um conjunto de nós com o nome labelnp com a etiqueta dept=HR:
```
az aksarc nodepool add –resource-group myResourceGroup –cluster-name myAKSCluster –name labelnp –node-count 1 –labels dept=HR –no-wait
```
O seguinte exemplo de saída do az aksarc nodepool list comando mostra que o labelnp conjunto 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 as etiquetas foram definidas com o kubectl get nodes --show-labels comando:
```
kubectl get nodes --show-labels | grep -e "dept=HR"
```

Atualizar etiquetas em conjuntos de nós existentes

Atualize uma etiqueta num conjunto de nós existente com o comando az aksarc nodepool update . Atualizar etiquetas em conjuntos de nós existentes substitui as etiquetas antigas com as novas etiquetas. As etiquetas têm de 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 as etiquetas foram definidas com o kubectl get nodes --show-labels comando .
```
kubectl get nodes --show-labels | grep -e "costcenter=6000" -e "dept=ACCT"
```

Etiquetas indisponíveis

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

Não pode alterar a etiqueta do sistema reservado. Se tentar fazê-lo, é devolvido um erro.
Os prefixos reservados do Kubernetes e do AKS não podem ser utilizados para nenhum nó.

Para obter mais informações, veja Etiquetas indisponíveis na documentação do AKS.

Passos seguintes

Para obter mais informações sobre as etiquetas do Kubernetes, veja a documentação do Kubernetes.

Partilhar via