Не удается обновить кластер AKS из-за ошибки NodePoolMcVersionIncompatible

2025-05-19

В этой статье описывается, как устранить ошибку NodePoolMcVersionIncompatible — пул узлов версии 1.x.y и плоскость управления версии 1.a.b несовместимы, которая возникает при обновлении пула узлов в кластере службы Microsoft Azure Kubernetes (AKS).

Предпосылки

Azure CLI

Симптомы

При обновлении пула узлов в кластере AKS вы получите одно из следующих сообщений об ошибках:

BadRequest — NodePoolMcVersionIncompatible

Ошибка: пул узлов версии 1.x.y и плоскость управления версии 1.a.b несовместимы. Минорная версия пула узлов не может отставать более чем на 2 версии от версии управляющей плоскости. Минорная версия пула узлов — x, а контрольной плоскости — a. Для получения дополнительной информации, пожалуйста, перейдите к https://aka.ms/version-skew-policy.

Идентификатор ресурса: /subscriptions/<subscription_id>/resourcegroups/<aks_cluster_resource_group>/providers/Microsoft.ContainerService/managedClusters/<aks_cluster_name>.

BadRequest — NodePoolMcVersionIncompatible

Ошибка: пул узлов версии 1.x.y и плоскость управления версии 1.a.b несовместимы. Минорная версия версии пула узлов x больше, чем версия контрольной плоскости a. За дополнительной информацией обратитесь к https://aka.ms/version-skew-policy.

Идентификатор ресурса: /subscriptions/<subscription_id>/resourcegroups/<aks_cluster_resource_group>/providers/Microsoft.ContainerService/managedClusters/<aks_cluster_name>.

Причина

Эти проблемы возникают, если вы пытаетесь обновить пул узлов, который более чем на две версии отстает от версии уровня управления AKS, или если вы пытаетесь добавить пул узлов, который имеет более новую версию, чем версия уровня управления.

При обновлении пула узлов необходимо выполнить следующие условия:

Версия пула узлов не может быть больше версии управления <основной>.<дополнительной>.<исправления>.
Версия пула узлов должна находиться в пределах двух минорных версий от версии уровня управления.

Дополнительные сведения см. в правилах проверки AKS для обновления.

Решение 1: Убедитесь, что версия пула узлов находится в пределах двух минорных версий от версии плоскости управления

Получите версию плоскости управления, выполнив команду az aks get-upgrades в Azure CLI.

Ниже приведен пример использования команды. Выходной MasterVersion столбец содержит версию плоскости управления.
```
az aks get-upgrades --resource-group aksrg --name testcluster1 --output table  
```
```
Name     ResourceGroup    MasterVersion    Upgrades
-------  ---------------  ---------------  -----------------------
default  aksrg            1.23.12          1.23.15, 1.24.6, 1.24.9
```
Обновите пул узлов, выполнив команду Azure CLI az aks nodepool upgrade и укажите версию Kubernetes, которая на два минорных обновления отличается от версии контрольной плоскости.

Например, если версия уровня управления имеет значение 1.23.12, можно указать версию Kubernetes пула узлов как 1.23.8 или 1.23.12.

Ниже приведен пример использования команды:
```
az aks nodepool upgrade \
    --resource-group aksrg \
    --cluster-name testcluster1 \
    --name mynodepool \
    --kubernetes-version 1.23.8 \
    --no-wait
```

Решение 2. Убедитесь, что версия пула узлов не больше версии контрольной панели.

Получите версию плоскости управления выполнив команду az aks get-upgrades в Azure CLI.

Ниже приведен пример использования команды. Выходной MasterVersion столбец содержит версию плоскости управления.
```
az aks get-upgrades --resource-group aksrg --name testcluster1 --output table  
```
```
Name     ResourceGroup    MasterVersion    Upgrades
-------  ---------------  ---------------  -----------------------
default  aksrg            1.23.12          1.23.15, 1.24.6, 1.24.9
```
Обновите пул узлов, выполнив команду az aks nodepool upgrade Azure CLI и укажите версию Kubernetes, которая менее или равна версии уровня управления.

Ниже приведен пример использования команды:
```
az aks nodepool upgrade \
    --resource-group aksrg \
    --cluster-name testcluster1 \
    --name mynodepool \
    --kubernetes-version 1.23.12 \
    --no-wait
```

Свяжитесь с нами для получения помощи

Если у вас есть вопросы или нужна помощь, создайте запрос на поддержку или обратитесь к поддержке сообщества Azure. Вы также можете отправить отзыв о продукте в сообщество отзывов Azure.