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

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

Требования для подключения внешних узлов к кластеруТребования для подключения внешних узлов к кластеру

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

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

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

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

3. Создайте объект группы узлов в Kubernetes API кластера Managed Service for Kubernetes.

   После создания объекта группы вы можете добавлять узлы в кластер Managed Service for Kubernetes и удалять узлы из кластера.

   При возникновении проблем с подключением обратитесь к разделу Диагностика проблем.

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

Добавление узлов в кластерДобавление узлов в кластер

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

После этого необходимо установить на подключаемые серверы системные компоненты.

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

Подключение узлов к кластеру 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

Установка системных компонентов на подключаемые серверыУстановка системных компонентов на подключаемые серверы

Для установки системных компонентов и добавления узлов в кластер Managed Service for Kubernetes можно воспользоваться одним из двух способов:

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

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

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

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

В спецификации ресурса NodeGroup укажите имя соответствующего секрета:

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

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

На всех внешних узлах Managed Service for Kubernetes должна быть доступна возможность подключения с логином root и указанным SSH-ключом.

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

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

1. После создания объекта NodeGroup в кластере Managed Service for Kubernetes становится доступен секрет, содержащий kubeconfig для использования на подключаемых серверах. Получите его с помощью kubectl, настроенного на работу с кластером Managed Service for Kubernetes, и сохраните его в файл:

   kubectl -n yandex-system get secret <имя_объекта_NodeGroup>-maintainer-kube-config -o json | jq -r '.data."kube-config"' | base64 -d
   

2. Сохраните полученный kubeconfig на подключаемом сервере:

   sudo mkdir -p /etc/maintainer
   sudo vi /etc/maintainer/kube.config # Сохраните в этот файл содержимое `kubeconfig`, полученное на предыдущем шаге.
   

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

   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
   

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

kubectl -n yandex-system edit nodegroup

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

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

kubectl -n yandex-system get events

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

journalctl -u maintainer
journalctl -u kubelet

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