Подключение внешних узлов к кластеру

Внешние серверы подключаются в виде узлов к кластеру Managed Service for Kubernetes с помощью специальных ресурсов Kubernetes API. Определения (CustomResourceDefinitions) этих ресурсов автоматически предустановлены в кластер Managed Service for Kubernetes.

Если в качестве внешних узлов планируется использовать виртуальные машины Yandex Compute Cloud, то при их создании нужно указать в метаданных для ключа user-data параметр disable_root: false. Если параметр не указан, в кластере появятся ошибки.

#cloud-config
datasource:
 Ec2:
  strict_id: false
disable_root: false
users:
- name: <имя_пользователя>
  sudo: ALL=(ALL) NOPASSWD:ALL
  shell: /bin/bash
  ssh_authorized_keys:
  - ssh-rsa <публичный_ключ_доступа_к_ВМ>

Перед началом работыПеред началом работы

1. Создайте кластер Managed Service for Kubernetes любой подходящей конфигурации.

   Для создания внешней группы узлов кластер Managed Service for Kubernetes должен работать в туннельном режиме. Он включается только при создании кластера.

2. Установите kubectl и настройте его на работу с созданным кластером.

Создание группы узловСоздание группы узлов

Изменение группы узловИзменение группы узлов

При необходимости группу узлов можно изменить — например, чтобы добавить дополнительные IP-адреса.

kubectl -n yandex-system edit nodegroup external-node-group

Установка системных компонентовУстановка системных компонентов

Чтобы подключить серверы к кластеру Managed Service for Kubernetes, необходимо установить на них системные компоненты.

Установить системные компоненты можно одним из двух способов:

• Автоматическая установка.
• Полуавтоматическая установка.

Автоматическая установкаАвтоматическая установка

При автоматической установке кластер Managed Service for Kubernetes самостоятельно подключается к серверу по SSH и устанавливает на него все необходимые системные компоненты.

Чтобы выполнить автоматическую установку:

1. Создайте в кластере Managed Service for Kubernetes секрет, содержащий приватный SSH-ключ для подключения к серверу:

   kubectl -n yandex-system create secret generic <имя_секрета> \
     --from-file=ssh-privatekey=<путь_к_файлу_SSH-ключа> \
     --type=kubernetes.io/ssh-auth
   

2. В спецификации группы узлов укажите имя секрета:

   Консоль управления

   CLI

   1. На странице кластера Managed Service for Kubernetes перейдите на вкладку Управление кластером и выберите раздел Группы узлов.
   2. В строке созданной группы узлов нажмите значок и выберите Редактировать.
   3. В поле Секрет с приватным SSH-ключом выберите в выпадающем списке имя созданного секрета.
   4. Нажмите Сохранить.

   1. Выполните команду:

      kubectl -n yandex-system edit nodegroup external-node-group
      

   2. Отредактируйте спецификацию:

      apiVersion: mks.yandex.cloud/v1alpha1
      kind: NodeGroup
      metadata:
        name: external-node-group
        namespace: yandex-system
      spec:
        ips:
        ...
        provisionBySsh:
          sshKeySecret:
            name: <имя_секрета>
            namespace: yandex-system
      

Полуавтоматическая установкаПолуавтоматическая установка

При полуавтоматической установке вы вручную подготавливаете сервер, устанавливая на него компонент maintainer и задавая настройки доступа к кластеру Managed Service for Kubernetes. После этого компонент maintainer автоматически загрузит и установит остальные системные компоненты.

Чтобы выполнить полуавтоматическую установку:

1. С помощью kubectl получите секрет, содержащий kubeconfig для использования на подключаемом сервере, и сохраните его в файл:

   kubectl -n yandex-system get secret <имя_группы_узлов>-maintainer-kube-config \
     -o json | jq -r '.data."kube-config"' | base64 -d > kube.config
   

   Секрет становится доступен после создания группы узлов в кластере Managed Service for Kubernetes.

2. Перенесите файл kube.config на сервер:

   scp kube.config root@<публичный_IP-адрес_сервера>:/
   

3. Подключитесь к серверу:

   ssh root@<публичный_IP-адрес_сервера>
   

4. Создайте каталог /etc/yandex-maintainer и переместите в него файл kube.config:

   sudo mkdir -p /etc/yandex-maintainer
   sudo mv /kube.config /etc/yandex-maintainer/
   

5. Выполните следующие команды на подключаемом сервере:

   sudo mkdir -p /home/kubernetes/bin
   sudo curl --output /home/kubernetes/bin/maintainer https://storage.yandexcloud.kz/mk8s-maintainer/v1/maintainer
   sudo chmod +x /home/kubernetes/bin/maintainer
   sudo /home/kubernetes/bin/maintainer install
   

Проверка состояния внешних узловПроверка состояния внешних узлов

После установки системных компонентов серверы начнут подключение к кластеру Managed Service for Kubernetes. Когда подключение завершится, новые узлы кластера перейдут в состояние Ready.

Чтобы проверить состояние узлов:

kubectl get node -o wide -w

NAME       STATUS  ROLES   AGE    VERSION  INTERNAL-IP  EXTERNAL-IP  OS-IMAGE            KERNEL-VERSION    CONTAINER-RUNTIME
...
ext-node2  Ready   <none>  4m03s  v1.20.6  10.130.0.4   <none>       Ubuntu 20.04.3 LTS  5.4.0-42-generic  docker://20.10.8
ext-node1  Ready   <none>  4m25s  v1.20.6  10.130.1.5   <none>       Ubuntu 20.04.3 LTS  5.4.0-42-generic  docker://20.10.8

Отключение внешних узловОтключение внешних узлов

Диагностика проблемДиагностика проблем

При возникновении проблем в первую очередь обратитесь к событиям в пространстве имен yandex-system:

kubectl -n yandex-system get events

Если информации недостаточно, обратитесь к логам системных компонентов на соответствующем подключаемом сервере:

journalctl -u yandex-maintainer
journalctl -u kubelet

Учитывайте требования для подключения внешних узлов Managed Service for Kubernetes.

Полезные ссылкиПолезные ссылки

• Настройка WireGuard-шлюзов для подключения внешних узлов
• Настройка IPSec-шлюзов для подключения внешних узлов