Alauda Container Platform
  • Русский

    • Настройка NodeLocal DNSCache

    Содержание

    ОбзорКлючевые возможностиВажные примечанияУстановкаУстановка через MarketplaceПринцип работыАрхитектураКонфигурацияНастройка NetworkPolicy

    Обзор

    NodeLocal DNSCache — это кластерный плагин, который повышает производительность DNS в кластере за счёт запуска DNS caching proxy на узлах кластера. Этот плагин снижает задержку DNS-запросов и повышает стабильность кластера, кэшируя DNS-ответы локально на каждом узле и уменьшая нагрузку на центральную DNS-службу.

    Ключевые возможности

    • Локальное кэширование DNS: кэширует DNS-ответы локально на каждом узле, чтобы снизить задержку запросов
    • Повышенная производительность: значительно сокращает время DNS lookup для приложений

    Важные примечания

    WARNING

    Особенности развертывания:

    1. Режим Kube-OVN Underlay: плагин не поддерживает развертывание в режиме Kube-OVN Underlay. Если его развернуть, это может привести к сбоям DNS-запросов.

    2. Перезапуск Kubelet: развертывание этого плагина приведёт к перезапуску kubelet.

    3. Требуется перезапуск Pod: после успешного развертывания плагина он не повлияет на уже запущенные Pod, а начнёт действовать только для вновь созданных Pod. Когда CNI — Kube-OVN, необходимо вручную добавить параметр --node-local-dns-ip=(IP address of the local DNS cache server) в kube-ovn-controller.

    4. Конфигурация NetworkPolicy: если в кластере настроен NetworkPolicy, необходимо дополнительно разрешить входящее и исходящее направления для node CIDR и nodeLocalDNSIP в networkPolicy, чтобы обеспечить корректное взаимодействие.

    5. Обновление кластера через пересоздание: если кластер обновляется путём пересоздания узлов (re-provisioning), изменения конфигурации kubelet будут потеряны. Чтобы сохранить конфигурацию NodeLocal DNS между обновлениями, необходимо добавить параметр --cluster-dns в kubeletExtraArgs в следующих трёх местах шаблона кластера:

      • KubeadmControlPlane → initConfiguration → nodeRegistration → kubeletExtraArgs
      • KubeadmControlPlane → joinConfiguration → nodeRegistration → kubeletExtraArgs
      • KubeadmConfigTemplate → template → spec → joinConfiguration → nodeRegistration → kubeletExtraArgs

      Добавьте следующий параметр в каждый из указанных разделов kubeletExtraArgs:

      cluster-dns: "<NodeLocal_DNS_IP>"  # e.g., 169.254.20.10
    WARNING

    Примечания к обновлению до версии 4.2.x

    При обновлении этого плагина с версий ниже 4.2.0 (не включая 4.2.0) до 4.2.x из-за проблем совместимости ResourcePatch необходимо выполнить следующие шаги:

    Перед обновлением:

    • Запишите значение параметра --node-local-dns-ip из конфигурации ResourcePatch для kube-ovn-controller
    • Удалите ResourcePatch для ресурса deploy/kube-ovn-controller

    После обновления:

    • Вручную добавьте записанное значение параметра --node-local-dns-ip обратно в конфигурацию kube-ovn-controller

    Примечание: эта проблема совместимости устранена в версии 4.3 и выше, поэтому при обновлении до 4.3+ ручное вмешательство не требуется.

    Установка

    Установка через Marketplace

    1. Перейдите в Administrator > Marketplace > Cluster Plugins.

    2. Найдите "Alauda Build of NodeLocal DNSCache" в списке плагинов.

    3. Нажмите Install, чтобы открыть страницу конфигурации установки.

    4. Настройте необходимые параметры:

      ПараметрОписаниеПример значения
      IPIP-адрес local DNS cache server на узле. Для IPv4 рекомендуется использовать адрес из диапазона 169.254.0.0/16, предпочтительно 169.254.20.10. Для IPv6 рекомендуется использовать адрес из диапазона fd00::/8, предпочтительно fd00::10.169.254.20.10

    5. Проверьте примечания к развертыванию и убедитесь, что ваша среда соответствует требованиям.

    6. Нажмите Install, чтобы завершить установку.

    7. Дождитесь, пока статус плагина изменится на "Ready".

    Принцип работы

    Архитектура

    Pod → NodeLocal DNSCache → [Cache Hit] → Pod
           ↓
    [Cache Miss] → CoreDNS → Response → Cache & Pod

    Конфигурация

    Настройка NetworkPolicy

    Важно: если в вашем кластере включён NetworkPolicy, необходимо настроить корректные правила, чтобы разрешить DNS-трафик к NodeLocal DNSCache. Без этих правил Pod могут не иметь возможности разрешать DNS-запросы.

    При использовании NetworkPolicy убедитесь, что разрешён следующий DNS-трафик:

    apiVersion: networking.k8s.io/v1
kind: NetworkPolicy
metadata:
  name: allow-dns-cache
spec:
  podSelector: {}
  policyTypes:
    - Ingress
    - Egress
  ingress:
    - from:
        - ipBlock:
            cidr: 169.254.20.10/32 # NodeLocal DNS IP address
      ports:
        - protocol: UDP
          port: 53
        - protocol: TCP
          port: 53
  egress:
    - to:
        - ipBlock:
            cidr: 169.254.20.10/32 # NodeLocal DNS IP address
      ports:
        - protocol: UDP
          port: 53
        - protocol: TCP
          port: 53