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

Внешние серверы подключаются в виде узлов к кластеру 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, необходимо установить на них системные компоненты.

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

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

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

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. Выберите в выпадающем списке нужный секрет.
   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
      

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

   1. Подключитесь к ВМ.

   2. Откройте файл конфигурации SSH:

      sudo vi /etc/ssh/sshd_config
      

   3. Измените значение PermitRootLogin на Yes и сохраните изменения.

   4. Откройте файл c SSH-ключом, который используется для подключения от root:

      sudo vi /root/.ssh/authorized_keys
      

   5. Удалите из файла все, кроме ключа, и сохраните изменения. В результате файл должен выглядеть так:

      ssh-ed25519 AAAAC3NzaC1lZDI1NTE5ABFLIFyapYheN7OZNhTaNqEHefjmU5mtzK******
      

   6. Перезапустите службу SSH, чтобы изменения вступили в силу:

      sudo systemctl restart sshd
      

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

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

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

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

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

   sudo mkdir -p /etc/yandex-maintainer
   sudo vi /etc/yandex-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
   

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

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

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

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

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

kubectl -n yandex-system get events

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

journalctl -u yandex-maintainer
journalctl -u kubelet

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