Добавление статических DNS-записей

Компонент Node Hosts Injector позволяет автоматизировать управление статическими DNS-записями на узлах кластера Managed Kubernetes. После установки компонента на каждом узле кластера запускается контроллер DaemonSet, который переносит DNS-записи из ресурса ConfigMap в файл /etc/hosts и поддерживает файл в актуальном состоянии. При удалении компонента добавленные им DNS-записи удаляются автоматически.

Чтобы установить и начать использовать компонент Node Hosts Injector:

1. Подготовьте окружение для работы с кластером Managed Kubernetes.
2. Создайте файл конфигурации.
3. Установите Node Hosts Injector.
4. Проверьте результат.

1. Создайте сервисный аккаунт с именем sa-mk8s и ролью registry.puller.

2. Для сервисного аккаунта sa-mk8s создайте API-ключ и сохраните его.

3. Создайте кластер Managed Kubernetes с публичным эндпоинтом и группу узлов для него. При создании группы используйте сервисный аккаунт sa-mk8s.

4. Создайте NAT-шлюз для подсети, в которой развернут кластер Managed Kubernetes.

5. Для прохождения руководства вам понадобится устройство, поддерживающее работу с командной строкой. Используйте личный компьютер или создайте промежуточную ВМ в той же сети, где расположен кластер Managed Kubernetes.

1. Подключитесь к терминалу на вашем компьютере или к промежуточной ВМ.

2. Установите и настройте утилиту MWS CLI:

   1. Установите утилиту.
   2. Инициализируйте профиль.

3. Установите Helm.

4. Аутентифицируйтесь в Artifact Registry:

   1
   helm registry login -u apikey -p <API-ключ> registry.mwsapis.ru

5. Установите утилиту командной строки kubectl.

6. Подключитесь к кластеру.

Создайте файл конфигурации values.yaml, в котором указываются DNS-записи и задаются параметры работы контроллера DaemonSet:

1
cat <<EOF > values.yaml
2
image:
3
  repository: registry.mwsapis.ru/mws-mk8s-images/customer/node-hosts-injector
4
  tag: "1.0.0"
5
  pullPolicy: IfNotPresent
6

7
imagePullSecrets: []
8

9
hostsEntries:
10
  - ip: 10.0.0.10
11
    hostnames: api.internal.example.com
12
  - ip: 10.0.0.11
13
    hostnames: db.internal.example.com
14
  - ip: 10.0.0.12
15
    hostnames: cache.internal.example.com
16
  - ip: 10.0.0.13
17
    hostnames: mq.internal.example.com
18

19
pollInterval: 30
20

21
tolerateControlPlane: true
22

23
tolerations: []
24

25
nodeSelector: {}
26

27
affinity: {}
28

29
resources:
30
  requests:
31
    cpu: 10m
32
    memory: 16Mi
33
  limits:
34
    cpu: 20m
35
    memory: 32Mi
36

37
updateStrategy:
38
  type: RollingUpdate
39
  rollingUpdate:
40
    maxUnavailable: "25%"
41

42
terminationGracePeriodSeconds: 15
43

44
podLabels: {}
45
podAnnotations: {}
46
EOF

Здесь:

• hostsEntries — список DNS-записей, который будет сохранен в ресурсе ConfigMap.
• pollInterval — частота (в секундах), с которой DaemonSet будет проверять наличие изменений в ресурсе ConfigMap.
• tolerateControlPlane — параметр, который разрешает (true) или запрещает (false) запускать контроллер DaemonSet на управляющих узлах.

Подробнее конфигурация DaemonSet описана в официальной документации.

Файл values.yaml будет использоваться при установке компонента Node Hosts Injector.

1. Установите компонент:

   1
   helm install hosts-injector oci://registry.mwsapis.ru/mws-mk8s-images/customer/charts/hosts-injector --version 0.1.0 -f values.yaml

   Ожидаемый результат:

   1
   ...
   2
   NAME: hosts-injector
   3
   LAST DEPLOYED: Tue Jun 23 12:25:04 2026
   4
   NAMESPACE: default
   5
   STATUS: deployed
   6
   REVISION: 1
   7
   TEST SUITE: None
   8
   ...

2. Убедитесь, что поды компонента запущены (Running) на нужных узлах:

   1
   kubectl get pods -l app.kubernetes.io/name=hosts-injector -o wide

   Ожидаемый результат:

   1
   NAME                   READY   STATUS    RESTARTS   AGE     IP                NODE
   2
   hosts-injector-pxfcg   1/1     Running   0          8m37s   <IP-адрес узла>   <имя узла>

Проверьте содержимое файла /etc/hosts на одном из узлов:

1
kubectl debug node/<имя узла> \
2
--profile=general \
3
-it \
4
--image=busybox \
5
-- cat /host/etc/hosts

В выводе должны быть перечислены DNS-записи, которые вы указали в hostsEntries файла values.yaml:

1
# BEGIN CUSTOM-HOSTS-INJECTOR
2
# Managed by DaemonSet custom-hosts-injector
3
# Source: ConfigMap custom-hosts-entries
4
# Updated: 2026-06-23T01:25:10Z
5
10.0.0.10   api.internal.example.com
6
10.0.0.11   db.internal.example.com
7
10.0.0.12   cache.internal.example.com
8
10.0.0.13   mq.internal.example.com
9
# END CUSTOM-HOSTS-INJECTOR

Ресурсы, созданные в руководстве, тарифицируются. Если вы больше не планируете использовать их:

1. Удалите кластер Managed Kubernetes.
2. Удалите NAT-шлюз.
3. Удалите промежуточную ВМ, если вы ее создавали.