Usar etiquetas en un clúster de Azure Kubernetes Service (AKS)
Artículo
Si tiene varios grupos de nodos, puede agregar una etiqueta durante la creación del grupo de nodos. Las etiquetas de Kubernetes controlan las reglas de programación de los nodos. Puede agregar etiquetas a un grupo de nodos en cualquier momento y aplicarlas a todos los nodos del grupo de nodos.
En esta guía paso a paso, aprenderá a usar etiquetas en un clúster de Azure Kubernetes Service (AKS).
Requisitos previos
Es preciso que esté instalada y configurada la versión 2.2.0 de la CLI de Azure, o cualquier otra posterior. Ejecute az --version para encontrar la versión. Si necesita instalarla o actualizarla, vea Instalación de la CLI de Azure.
Creación de un clúster de AKS con una etiqueta
Cree un clúster de AKS con una etiqueta con el comando az aks create y especifique el parámetro --node-labels para establecer las etiquetas. Las etiquetas deben ser un par clave-valor y tener una sintaxis válida.
az aks create \
--resource-group myResourceGroup \
--name myAKSCluster \
--node-count 2 \
--nodepool-labels dept=IT costcenter=9000 \
--generate-ssh-keys
Compruebe que las etiquetas se han establecido con el comando kubectl get nodes --show-labels.
kubectl get nodes --show-labels | grep -e "costcenter=9000" -e "dept=IT"
Creación de un grupo de nodos con una etiqueta
Cree un grupo de nodos con una etiqueta con el comando az aks 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
El siguiente comando de ejemplo crea un grupo de nodos denominado labelnp con las etiquetas dept=HR y costcenter=5000.
En la siguiente salida de ejemplo del comando az aks nodepool list se puede ver que el grupo de nodos labelnp está Creando nodos con el valor nodeLabels especificado:
Compruebe que las etiquetas se han establecido con el comando kubectl get nodes --show-labels.
kubectl get nodes --show-labels | grep -e "costcenter=5000" -e "dept=HR"
Actualización de etiquetas en grupos de nodos existentes
Actualice una etiqueta en un grupo de nodos existente mediante el comando az aks nodepool update. La actualización de etiquetas en grupos de nodos existentes sobrescribe las etiquetas antiguas con las nuevas etiquetas. Las etiquetas deben ser un par clave-valor y tener una sintaxis válida.
az aks nodepool update \
--resource-group myResourceGroup \
--cluster-name myAKSCluster \
--name labelnp \
--labels dept=ACCT costcenter=6000 \
--no-wait
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
Etiquetas reservadas del sistema
Desde la versión 2021-08-19 de AKS, AKS ha detenido la capacidad de hacer cambios en las etiquetas reservadas de AKS. Si intenta cambiar estas etiquetas, se produce un mensaje de error.
Las etiquetas siguientes son etiquetas reservadas de AKS. El uso del nodo virtual especifica si estas etiquetas podrían ser una característica del sistema admitida en los nodos virtuales. Algunas propiedades que cambian estas características del sistema no están disponibles en los nodos virtuales, ya que requieren modificar el host.
Etiqueta
Value
Ejemplo/Opciones
Uso del nodo virtual
kubernetes.azure.com/agentpool
<nombre del grupo de agentes>
nodepool1
Iguales
kubernetes.io/arch
AMD64
runtime.GOARCH
N/D
kubernetes.io/os
<OS Type> (Tipo de SO)
Linux y Windows
Iguales
node.kubernetes.io/instance-type
<Tamaño de VM>
Standard_NC6s_v3
Las máquinas
topology.kubernetes.io/region
<Región de Azure>
westus2
Iguales
topology.kubernetes.io/zone
<Zona de Azure>
0
Iguales
kubernetes.azure.com/cluster
<MC_RgName>
MC_aks_myAKSCluster_westus2
Iguales
kubernetes.azure.com/mode
<mode>
Usuario o sistema
Usuario
kubernetes.azure.com/role
agente
Agente
Iguales
kubernetes.azure.com/scalesetpriority
<Prioridad de VMSS>
De acceso puntual o regular
N/D
kubernetes.io/hostname
<hostname>
aks-nodepool-00000000-vmss000000
Iguales
kubernetes.azure.com/storageprofile
<Perfil de almacenamiento en disco del sistema operativo>
Administrado
N/D
kubernetes.azure.com/storagetier
<Nivel de almacenamiento de disco del sistema operativo>
Lo mismo se incluye en los lugares donde los valores esperados para las etiquetas no difieren entre un grupo de nodos estándar y un grupo de nodos virtual. Dado que los pods de nodo virtual no exponen ninguna máquina virtual (VM) subyacente, los valores de SKU de máquina virtual se reemplazan por la SKU Virtual.
Las siguientes etiquetas están previstas para desuso con el lanzamiento de Kubernetes v1.24. Debe cambiar las referencias de etiqueta al sustituto recomendado.
El origen de este contenido se puede encontrar en GitHub, donde también puede crear y revisar problemas y solicitudes de incorporación de cambios. Para más información, consulte nuestra guía para colaboradores.
Comentarios de Azure Kubernetes Service
Azure Kubernetes Service es un proyecto de código abierto. Seleccione un vínculo para proporcionar comentarios:
Explore las estrategias que puede usar en Azure para optimizar el proceso de desarrollo de aplicaciones nativas de nube con Azure Kubernetes Service (AKS).