Использование меток в кластере Службы Azure Kubernetes (AKS)

При наличии нескольких пулов узлов может потребоваться добавить метку во время создания пула узлов. Метки Kubernetes обрабатывают правила планирования узлов. Вы можете добавлять метки в пул узлов в любое время и применять их ко всем узлам в пуле узлов.

В этом руководстве описано, как использовать метки в кластере Служба Azure Kubernetes (AKS).

Необходимые компоненты

Необходимо установить и настроить Azure CLI версии 2.2.0 или более поздней. Чтобы узнать версию, выполните команду az --version. Если вам необходимо выполнить установку или обновление, см. статью Установка Azure CLI 2.0.

Создание кластера AKS с меткой

1. Создайте кластер AKS с меткой с помощью az aks create команды и укажите параметр для задания --node-labels меток. Метки также должны быть парой "ключ-значение" и иметь допустимый синтаксис.

   az aks create \
       --resource-group myResourceGroup \
       --name myAKSCluster \
       --node-count 2 \
       --nodepool-labels dept=IT costcenter=9000 \
       --generate-ssh-keys
   

2. Убедитесь, что метки были заданы с помощью kubectl get nodes --show-labels команды.

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

Создание пула узлов с меткой

1. Создайте пул узлов с меткой с помощью az aks nodepool add команды и укажите имя --name параметров и меток для --labels параметра. Метки также должны быть парой "ключ-значение" и иметь допустимый синтаксис.

   В следующем примере команды создается пул узлов с именем labelnp с метками dept=HR и costcenter=5000.

   az aks nodepool add \
       --resource-group myResourceGroup \
       --cluster-name myAKSCluster \
       --name labelnp \
       --node-count 1 \
       --labels dept=HR costcenter=5000 \
       --no-wait
   

   В следующем примере выходных данных команды az aks nodepool list показано, что пул узлов labelnp — создание узлов с указанными nodeLabels:

   [
     {
       ...
       "count": 1,
       ...
       "name": "labelnp",
       "orchestratorVersion": "1.15.7",
       ...
       "provisioningState": "Creating",
       ...
       "nodeLabels":  {
         "costcenter": "5000",
         "dept": "HR"
       },
       ...
     },
    ...
   ]
   

2. Убедитесь, что метки были заданы с помощью kubectl get nodes --show-labels команды.

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

Обновление меток на существующих пулах узлов

1. Обновите метку в существующем пуле az aks nodepool update узлов с помощью команды. Обновление меток в существующих пулах узлов перезаписывает старые метки новыми метками. Метки также должны быть парой "ключ-значение" и иметь допустимый синтаксис.

   az aks nodepool update \
       --resource-group myResourceGroup \
       --cluster-name myAKSCluster \
       --name labelnp \
       --labels dept=ACCT costcenter=6000 \
       --no-wait
   

2. Убедитесь, что метки были заданы с помощью kubectl get nodes --show-labels команды.

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

Недоступные метки

Зарезервированные системные метки

С момента выпуска AKS 2021-08-19 AKS AKS перестал вносить изменения в зарезервированные метки AKS. Попытка изменить эти метки приводит к возникновению сообщения об ошибке.

Ниже приведены зарезервированные метки AKS. Использование виртуальных узлов указывает, могут ли эти метки поддерживать системную функцию на виртуальных узлах. Некоторые свойства, которые изменяются системными функциями, недоступны на виртуальных узлах, так как им требуется изменить узел.

• Вариант Аналогично указывается там, где ожидаемые значения меток совпадают в стандартном пуле узлов и пуле виртуальных узлов. Поскольку объекты pod виртуальных узлов не предоставляют ни одной виртуальной машины, значения номера SKU виртуальной машины заменяются номером SKU Виртуальная.
• Версия виртуального узла — это текущая версия выпуска виртуального соединителя Kubelet-ACI.
• Имя подсети виртуального узла — это имя подсети, в которой объекты pod виртуальных узлов развертываются в Экземпляр контейнера Azure (ACI).
• Виртуальная сеть виртуального узла — это имя виртуальной сети, которая содержит подсеть, в которой объекты pod виртуальных узлов развертываются в ACI.

Зарезервированные префиксы

Следующие префиксы являются зарезервированными префиксами AKS и не могут использоваться для любого узла:

• kubernetes.azure.com/
• kubernetes.io/

Дополнительные сведения о зарезервированных префиксах см. в разделе "Известные метки Kubernetes", "заметки" и "Заметки".

Нерекомендуемые метки

Следующие метки планируется указать как нерекомендуемые в выпуске Kubernetes версии 1.24. Вы должны изменить ссылки на метки на рекомендуемую замену.

*Не рекомендуется использовать. Дополнительные сведения см. в заметках о выпуске.

Следующие шаги

Дополнительные сведения о метках Kubernetes см. в документации по меткам Kubernetes.