Compartir a través de


Uso de etiquetas de clúster en AKS habilitadas por Azure Arc

Se aplica a: Azure Local, versión 23H2

Si tiene varios grupos de nodos, es posible que quiera agregar una etiqueta durante la creación del grupo de nodos. Las etiquetas de Kubernetes controlan las reglas de programación de los nodos.

En este artículo se describe cómo usar etiquetas en un clúster de Kubernetes en AKS habilitado por Arc.

Creación de un clúster de Kubernetes con una etiqueta

  1. Cree un clúster de Kubernetes con una etiqueta mediante el az aksarc create comando y especifique el parámetro para establecer las --node-labels etiquetas. Las etiquetas deben ser un par clave-valor y tener una sintaxis válida.

    az aksarc create --resource-group myResourceGroup --name myAKSCluster --node-count 2 --nodepool-labels dept=IT
    
  2. Compruebe que las etiquetas se establecieron mediante el kubectl get nodes --show-labels comando :

    kubectl get nodes --show-labels | grep -e "dept=IT"
    

Creación de un grupo de nodos con una etiqueta

  1. Cree un grupo de nodos con una etiqueta con el comando az aksarc nodepool add y especifique un nombre para los parámetros --name y las etiquetas del parámetro --labels. Las etiquetas deben ser un par clave-valor y tener una sintaxis válida.

    En el ejemplo siguiente se crea un grupo de nodos denominado labelnp con la etiqueta dept=HR:

    az aksarc nodepool add --resource-group myResourceGroup --cluster-name myAKSCluster --name labelnp --node-count 1 --labels dept=HR –no-wait
    

    En la salida de ejemplo siguiente del az aksarc nodepool list comando se muestra que el labelnp grupo de nodos crea nodos con el especificado nodeLabels:

    [
      {
        ...
        "count": 1,
        ...
        "name": "labelnp",
        "orchestratorVersion": "1.15.7",
        ...
        "provisioningState": "Creating",
        ...
        "nodeLabels":  {
          "costcenter": "5000",
          "dept": "HR"
        },
        ...
      },
     ...
    ]
    
  2. Compruebe que las etiquetas se establecieron mediante el kubectl get nodes --show-labels comando :

    kubectl get nodes --show-labels | grep -e "dept=HR"
    

Actualización de etiquetas en grupos de nodos existentes

  1. Actualice una etiqueta en un grupo de nodos existente mediante el comando az aksarc nodepool update . La actualización de etiquetas en grupos de nodos existentes sobrescribe las etiquetas antiguas con las nuevas etiquetas. Las etiquetas deben ser pares clave-valor y tener una sintaxis válida.

    az aksarc nodepool update --resource-group myResourceGroup --cluster-name myAKSCluster --name labelnp --labels dept=ACCT costcenter=6000 --no-wait
    
  2. Compruebe que las etiquetas se han establecido con el comando kubectl get nodes --show-labels.

    kubectl get nodes --show-labels | grep -e "costcenter=6000" -e "dept=ACCT"
    

Etiquetas no disponibles

AKS habilitado por Azure Arc sigue las mismas reglas que AKS:

  • No se puede cambiar la etiqueta reservada del sistema. Si intenta hacerlo, se devuelve un error.
  • Los prefijos reservados de Kubernetes y AKS no se pueden usar para ningún nodo.

Para obtener más información, consulte Etiquetas no disponibles en la documentación de AKS.

Pasos siguientes

Para más información sobre las etiquetas de Kubernetes, consulte la documentación de Kubernetes.