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

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

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

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. Выберите созданную группу узлов Managed Service for Kubernetes в списке.
   3. В правом верхнем углу нажмите кнопку Редактировать.
   4. В поле Секрет с приватным SSH-ключом выберите в выпадающем списке имя созданного секрета.
   5. Нажмите Сохранить.

   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.net/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-шлюзов для подключения внешних узлов