Перейти к основному содержимому
Managed Kubernetes: быстрый старт

Managed Kubernetes: быстрый старт

Работать с кластером Managed Kubernetes можно в панели управления и через API Managed Kubernetes.

  1. Создайте кластер в панели управления.
  2. Подключитесь к кластеру.
  3. Настройте Ingress.

Создать кластер на облачном сервере в панели управления⁠

  1. Настройте кластер на облачном сервере.
  2. Настройте группу нод.
  3. Настройте автоматизацию.

1. Настроить кластер на облачном сервере⁠

  1. В панели управления перейдите в раздел Облачная платформа → Kubernetes.

  2. Нажмите Создать кластер.

  3. Введите имя кластера. Имя будет отображаться в именах объектов кластера: группах нод, нодах, балансировщиках, сетях и дисках. Например, если имя кластера kelsie, то имя группы нод будет kelsie-node-gdc8q, а загрузочного диска — kelsie-node-gdc8q-volume.

  4. Выберите регион и пул. После создания кластера пул нельзя изменить.

  5. Выберите версию Kubernetes. После создания кластера можно обновить версию Kubernetes.

  6. Выберите тип кластера:

    • отказоустойчивый — Control Plane размещен на трех мастер-нодах, которые запускаются на разных хостах в разных сегментах одного пула. Если одна из трех мастер-нод недоступна, Control Plane продолжит работать;
    • базовый — Control Plane размещен на одной мастер-ноде, которая запускается на одном хосте в одном сегменте пула. Если мастер-нода недоступна, Control Plane не будет работать.

    После создания кластера тип кластера нельзя изменить.

  7. Опционально: чтобы кластер был доступен по приватной сети и был недоступен из интернета, отметьте чекбокс Приватный kube API. По умолчанию кластер создается в публичной сети и ему автоматически присваивается публичный IP-адрес kube API, доступный из интернета. После создания кластера тип доступа к kube API нельзя изменить.

  8. В блоке Сеть выберите приватную подсеть без доступа из интернета, в которую будут объединены все ноды кластера.

    Чтобы создать приватную подсеть, в поле Подсеть для нод выберите Новая приватная подсеть. Автоматически будут созданы приватная сеть cluster_name-network, приватная подсеть и роутер <cluster_name>-router, где cluster_name — название кластера. CIDR назначается автоматически.

    Если приватная подсеть создана, в поле Подсеть для нод выберите существующую подсеть. Подсеть должна соответствовать условиям:

    • подсеть должна быть подключена к облачному роутеру;
    • подсеть не должна пересекаться с диапазонами 10.250.0.0/16, 10.10.0.0/16 и 10.96.0.0/12. Эти диапазоны участвуют во внутренней адресации Managed Kubernetes;
    • в подсети должен быть выключен DHCP.

  9. Нажмите Продолжить.

2. Настроить группу нод⁠

  1. В поле Тип сервера выберите Облачный сервер.

  2. Выберите сегмент пула, в котором будут располагаться все рабочие ноды в группе. После создания кластера сегмент пула нельзя изменить.

  3. Нажмите Выбрать конфигурацию и выберите конфигурацию рабочих нод в группе:

    • произвольную — можно указать любое соотношение ресурсов;
    • или фиксированную с GPU — готовые конфигурации нод с графическими процессорами и с заданным соотношением ресурсов.

    Если стандартные конфигурации не подходят, после создания кластера можно добавить группу нод с фиксированной конфигурацией облачного сервера через API Managed Kubernetes.

    3.1. Если вы выбрали произвольную конфигурацию, укажите количество vCPU, RAM, выберите загрузочный диск. Укажите размер диска.

    3.2. Если вы выбрали фиксированную конфигурацию с GPU, выберите готовую конфигурацию нод с графическими процессорами, загрузочный диск и укажите размер диска. Чтобы установить драйверы GPU самостоятельно, отключите тумблер Драйверы GPU. По умолчанию тумблер Драйверы GPU включен и в кластере используются предустановленные драйверы.

    3.3. Нажмите Сохранить.

  4. Укажите количество рабочих нод в группе.

  5. Опционально: чтобы включить автомасштабирование, отметьте чекбокс Автомасштабирование группы нод. Установите минимальное и максимальное количество нод в группе — значение нод будет меняться только в этом диапазоне.

  6. Опционально: чтобы добавить метки группы нод, откройте блок Дополнительные настройки — метки, тейнты, user data. В поле Метки нажмите Добавить. Введите ключ и значение метки. Нажмите Добавить.

  7. Опционально: чтобы добавить тейнты группы нод, откройте блок Дополнительные настройки — метки, тейнты, user data. В поле Тейнты нажмите Добавить. Введите ключ и значение тейнта. Выберите эффект:

    • NoSchedule — новые поды не будут добавляться, а существующие продолжат работу;
    • PreferNoSchedule — новые поды будут добавляться, если в кластере нет других свободных мест;
    • NoExecute — запущенные поды без tolerations будут убраны.

    Нажмите Добавить.

  8. Опционально: чтобы добавить скрипт с пользовательскими параметрами для настройки кластера Managed Kubernetes, откройте блок Дополнительные настройки — метки, тейнты, user data. В поле User Data вставьте скрипт. Примеры скриптов и поддерживаемые форматы можно посмотреть в инструкции User data.

  9. Опционально: чтобы добавить дополнительную группу рабочих нод в кластере, нажмите Добавить группу нод. Можно создать кластер с группами рабочих нод в разных сегментах одного пула. Это повысит отказоустойчивость и поможет сохранить доступность приложения, если случится авария в одном из сегментов.

  10. В блоке Сеть выберите приватную подсеть без доступа из интернета, в которую будут объединены все ноды кластера.

    Чтобы создать приватную подсеть, в поле Подсеть для нод выберите Новая приватная подсеть. Автоматически будут созданы приватная сеть cluster_name-network, приватная подсеть и роутер <cluster_name>-router, где cluster_name — название кластера. CIDR назначается автоматически.

    Если приватная подсеть создана, в поле Подсеть для нод выберите существующую подсеть. Подсеть должна соответствовать условиям:

    • подсеть должна быть подключена к облачному роутеру;
    • подсеть не должна пересекаться с диапазонами 10.250.0.0/16, 10.10.0.0/16 и 10.96.0.0/12. Эти диапазоны участвуют во внутренней адресации Managed Kubernetes;
    • в подсети должен быть выключен DHCP.

  11. Нажмите Продолжить.

3. Настроить автоматизацию⁠

  1. Опционально: чтобы включить автовосстановление нод, отметьте чекбокс Восстанавливать ноды. Если у кластера всего одна рабочая нода, то автовосстановление недоступно.

  2. Опционально: чтобы включить автообновление патч-версий, отметьте чекбокс Устанавливать патч-версии. Если у кластера всего одна рабочая нода, то автообновление патч-версий Kubernetes недоступно.

  3. Выберите окно обслуживания кластера — время, в которое будут происходить автоматические действия по обслуживанию кластера.

  4. Нажмите Создать. Создание кластера занимает несколько минут, в это время кластер будет находиться в статусе CREATING. Кластер будет готов к работе, когда перейдет в статус ACTIVE.

Подключиться к кластеру⁠

Для начала работы с кластером нужно настроить kubectl.

к сведению

Мы рекомендуем производить все действия с нодами, балансировщиками и дисками кластера только через kubectl.

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

  1. Установите консольный клиент Kubernetes kubectl по официальной инструкции.

  2. В панели управления перейдите в раздел Облачная платформа → Kubernetes.

  3. Откройте страницу кластера → вкладка Настройки.

  4. Если вы используете приватный kube API, проверьте доступ к нему. IP-адрес указан в поле Kube API.

  5. Нажмите Скачать kubeconfig.

  6. Экспортируйте в переменную окружения KUBECONFIG путь к kubeconfig-файлу:

    export KUBECONFIG=<path>

    Укажите <path> — путь к kubeconfig-файлу имя_кластера.yaml.

  7. Проверьте корректность настройки — обратитесь к кластеру через kubectl:

    kubectl get nodes

    Ноды должны быть в статусе Ready.

Настроить Ingress⁠

Создайте Ingress и Ingress Controller, чтобы организовать для кластера входящий трафик.