Использование собственного подключаемого модуля CNI для службы Azure Kubernetes (AKS)

Kubernetes по умолчанию не предоставляет систему сетевого интерфейса. Вместо этого сетевые плагины предоставляют эту функцию. Служба Azure Kubernetes (AKS) предоставляет несколько поддерживаемых плагинов сетевого интерфейса контейнеров (CNI). Для получения информации о поддерживаемых плагинах см. раздел Концепции сетевого взаимодействия для приложений в службе Azure Kubernetes.

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

В этой статье показано, как развернуть кластер AKS без предварительно установленного подключаемого модуля CNI. После этого можно установить любой CNI плагин, совместимый с Azure.

Поддержка

Служба поддержки Microsoft не может помочь с проблемами, связанными с CNI, в кластерах, развернутых с использованием собственного подключаемого модуля CNI. Например, проблемы, связанные с CNI, охватывают большую часть трафика "восток-запад" (модуль-модуль), а также команды вида kubectl proxy и подобные. Если требуется поддержка CNI, используйте поддерживаемый сетевой подключаемый модуль AKS или обратитесь за поддержкой поставщика подключаемого модуля CNI.

Корпорация Майкрософт по-прежнему предоставляет поддержку проблем, которые не связаны с CNI.

Предварительные условия

Для Azure Resource Manager или Bicep используйте по крайней мере шаблон версии 2022-01-02-preview или 2022-06-01.
Для Azure CLI используйте по крайней мере версию 2.39.0.
Виртуальная сеть для кластера AKS должна разрешать исходящее подключение к Интернету.
Кластеры AKS не могут использовать 169.254.0.0/16, 172.30.0.0/16, 172.31.0.0/16 или 192.0.2.0/24 в качестве диапазона адресов для службы Kubernetes, pods или виртуальной сети кластера.
Идентификатор кластера, который использует кластер AKS, должен иметь как минимум разрешения участника сети в подсети в вашей виртуальной сети. Если вы хотите определить пользовательскую роль вместо использования встроенной роли участника сети, необходимы следующие разрешения:
- Microsoft.Network/virtualNetworks/subnets/join/action
- Microsoft.Network/virtualNetworks/subnets/read
Подсеть, назначенная пулу узлов AKS, не может быть делегированной подсетью.
AKS не применяет группы безопасности сети (NSG) к своей подсети или не изменяет группы безопасности сети, связанные с этой подсетью. Если вы предоставляете собственную подсеть и добавляете группы безопасности (NSG), связанные с ней, необходимо убедиться, что правила безопасности в NSG позволяют трафику в диапазоне маршрутизации без классов (CIDR) узла. Дополнительные сведения см. в разделе Группы безопасности сети.
AKS не создает таблицу маршрутов в управляемой виртуальной сети.
Необходимо указать Pod CIDR (диапазон IP-адресов для подов). Плоскость управления AKS использует этот диапазон для маршрутизации внутреннего трафика к подам, даже если назначение IP-адресов будет управляться вашим пользовательским CNI. Если CIDR для pod не предоставлен, может возникнуть сбой или неправильная маршрутизация вобщении между управляющей плоскостью и pod. Необходимо выбрать CIDR pod, который не конфликтует с какой-либо другой сетью в вашей среде и избегает зарезервированных диапазонов Azure, таких как, 169.254.0.0/16, 172.30.0.0/16172.31.0.0/16или192.0.2.0/24. Например, можно использовать диапазон, например 10.XX.0.0/16 уникальный для кластера. Это гарантирует, что плоскость управления может направляться непосредственно в IP-адреса pod на узлах, и при интеграции с другими сетями или кластерами ip-адреса не пересекаются.

Создание кластера AKS без предварительно установленного подключаемого модуля CNI

Создайте группу ресурсов Azure для кластера AKS с помощью az group create команды.
```
az group create --location eastus --name myResourceGroup
```

Создайте кластер AKS с помощью az aks create команды. Передайте параметр --network-plugin со значением параметра none.

az aks create \
    --location eastus \
    --resource-group myResourceGroup \
    --name myAKSCluster \
    --network-plugin none \
    --pod-cidr "10.10.0.0/16" \
    --generate-ssh-keys

Сведения о развертывании следующего шаблона см. в документации по шаблону ARM.

{
  "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "parameters": {
    "clusterName": {
      "type": "string",
      "defaultValue": "aksbyocni"
    },
    "location": {
      "type": "string",
      "defaultValue": "[resourceGroup().location]"
    },
    "kubernetesVersion": {
      "type": "string",
      "defaultValue": "1.22"
    },
    "nodeCount": {
      "type": "int",
      "defaultValue": 3
    },
    "nodeSize": {
      "type": "string",
      "defaultValue": "Standard_B2ms"
    }
  },
  "resources": [
    {
      "type": "Microsoft.ContainerService/managedClusters",
      "apiVersion": "2022-06-01",
      "name": "[parameters('clusterName')]",
      "location": "[parameters('location')]",
      "identity": {
        "type": "SystemAssigned"
      },
      "properties": {
        "agentPoolProfiles": [
          {
            "name": "nodepool1",
            "count": "[parameters('nodeCount')]",
            "mode": "System",
            "vmSize": "[parameters('nodeSize')]"
          }
        ],
        "dnsPrefix": "[parameters('clusterName')]",
        "kubernetesVersion": "[parameters('kubernetesVersion')]",
        "networkProfile": {
          "networkPlugin": "none",
          "podCidr": "[parameters('pod-cidr')]"
        }
      }
    }
  ]
}

Сведения о развертывании следующего шаблона см. в документации по шаблону Bicep.

param clusterName string = 'aksbyocni'
param location string = resourceGroup().location
param kubernetesVersion string = '1.22'
param nodeCount int = 3
param nodeSize string = 'Standard_B2ms'
param podCidr string = '10.2.0.0/16'

resource aksCluster 'Microsoft.ContainerService/managedClusters@2022-06-01' = {
  name: clusterName
  location: location
  identity: {
    type: 'SystemAssigned'
  }
  properties: {
    agentPoolProfiles: [
      {
        name: 'nodepool1'
        count: nodeCount
        mode: 'System'
        vmSize: nodeSize
      }
    ]
    dnsPrefix: clusterName
    kubernetesVersion: kubernetesVersion
    networkProfile: {
      networkPlugin: 'none'
      podCidr: podCidr
    }
  }
}

Развертывание подключаемого модуля CNI

После завершения подготовки AKS кластер находится в сети. Но все узлы находятся в NotReady состоянии, как показано в следующем примере:

  $ kubectl get nodes
  NAME                                STATUS     ROLES   AGE    VERSION
  aks-nodepool1-23902496-vmss000000   NotReady   agent   6m9s   v1.21.9

  $ kubectl get node -o custom-columns='NAME:.metadata.name,STATUS:.status.conditions[?(@.type=="Ready")].message'
  NAME                                STATUS
  aks-nodepool1-23902496-vmss000000   container runtime network not ready: NetworkReady=false reason:NetworkPluginNotReady message:Network plugin returns error: cni plugin not initialized

На этом этапе кластер готов к установке плагина CNI.

Обратная связь

Были ли сведения на этой странице полезными?

Last updated on 2026-02-05

Поделиться через

Использование собственного подключаемого модуля CNI для службы Azure Kubernetes (AKS)

Поддержка

Рекомендации по планированию IP-адресов

Размер виртуальной сети и подсети

Диапазон адресов службы Kubernetes

Управление сетями Pod и IP-адресами

Максимальное число подов на узле

Предварительные условия

Создание кластера AKS без предварительно установленного подключаемого модуля CNI

Развертывание подключаемого модуля CNI

Связанный контент

Обратная связь

Дополнительные ресурсы