Установка

Внимание. Компоненты платформы необходимо развертывать на физических серверах (bare-metal).

Установка на виртуальные машины допустима только в демонстрационных целях, но при этом должна быть включена вложенная виртуализация (nested virtualization). Если платформа развернута на виртуальных машинах, техническая поддержка не предоставляется.

Возможности масштабирования платформы

Платформа поддерживает следующую конфигурацию:

• Максимальное количество узлов: 1000.
• Максимальное количество виртуальных машин: 50000.

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

Требования к аппаратному обеспечению

1. Отдельная машина для установки.

   Здесь будет запускаться установщик Deckhouse. Это может быть ноутбук администратора или любой другой компьютер, который не планируется добавлять в кластер. Требования к этой машине:

   • ОС: Windows 10+, macOS 10.15+, Linux (Ubuntu 18.04+, Fedora 35+);
   • Установленный Docker Engine или Docker Desktop (инструкции для Ubuntu, macOS, Windows);
   • HTTPS-доступ к хранилищу образов контейнеров registry.deckhouse.ru;
   • SSH-доступ по ключу к узлу, который будет master-узлом будущего кластера;
   • SSH-доступ по ключу к узлу, который будет worker-узлом будущего кластера (если кластер будет состоять не из одного master-узла).

2. Сервер для master-узла.

   Серверов для запуска управляющих компонентов кластера может быть несколько. Для установки достаточно одного сервера, а остальные нужно будет добавить через механизмы управления узлами.

   Требования к физическому bare metal-серверу:

   • Ресурсы:
     • Процессор:
       • Архитектура x86_64;
       • Поддержка инструкций Intel-VT (VMX) или AMD-V (SVM);
       • не менее 4 ядер;
     • ОЗУ не менее 8 ГБ;
     • Дисковое пространство:
       • не менее 60 ГБ;
       • быстрый диск (400+ IOPS);
   • ОС из списка поддерживаемых:
     • ядро Linux версии 5.7 или новее;
   • Уникальный hostname среди всех серверов будущего кластера;
   • Сетевые доступы:
     • HTTPS-доступ к хранилищу образов контейнеров registry.deckhouse.ru;
     • доступ к репозиториям пакетов используемой ОС;
     • SSH-доступ от машины для установки (см. п.1) по ключу;
     • сетевой доступ от машины для установки (см. п.1) по порту 22322/TCP;
   • Требуемое ПО:
     • пакеты cloud-utils и cloud-init должны быть установлены.

   Важно. Container runtime будет установлен автоматически, поэтому пакеты containerd и/или docker не должны быть установлены.

3. Серверы для worker-узлов.

   Это узлы, где будут запускаться виртуальные машины, поэтому ресурсов на этих серверах должно хватать для запуска планируемого количества виртуальных машин. При использовании программно-определяемого хранилища могут потребоваться дополнительные диски.

   Требования к физическому bare metal-серверу:

   • Ресурсы:
     • Процессор:
       • Архитектура x86_64;
       • Поддержка инструкций Intel-VT (VMX) или AMD-V (SVM);
       • не менее 4 ядер.
     • ОЗУ не менее 8 ГБ.
     • Дисковое пространство:
       • не менее 60 ГБ;
       • быстрый диск (400+ IOPS);
       • дополнительные диски для программно-определяемого хранилища.
   • ОС из списка поддерживаемых:
     • ядро Linux версии 5.7 или новее.
   • Уникальный hostname среди всех серверов будущего кластера;
   • Сетевые доступы:
     • HTTPS-доступ к хранилищу образов контейнеров registry.deckhouse.ru;
     • доступ к репозиториям пакетов используемой ОС;
     • SSH-доступ от машины для установки (см. п.1) по ключу.
   • Требуемое ПО:
     • пакеты cloud-utils и cloud-init должны быть установлены (названия могут отличаться в зависимости от выбранной ОС).

   Важно. Container runtime будет установлен автоматически, поэтому пакеты containerd и/или docker не должны быть установлены.

4. Оборудование для хранилища.

В зависимости от выбранного хранилища могут потребоваться дополнительные ресурсы. Подробности смотрите в разделе Управление хранилищами.

Поддерживаемые ОС для узлов платформы

Поддерживаемые гостевые ОС

Платформа виртуализации поддерживает операционные системы, работающие на архитектурах x86 и x86_64, в качестве гостевых ОС. Для корректной работы в режиме паравиртуализации необходимо установить драйверы VirtIO, обеспечивающие эффективное взаимодействие между виртуальной машиной и гипервизором.

Успешный запуск операционной системы определяется следующими критериями:

• корректная установка и загрузка ОС;
• бесперебойная работа основных компонентов, таких как сеть и хранилище;
• отсутствие сбоев или ошибок в процессе работы.

Для операционных систем семейства Linux рекомендуется использовать образы гостевых ОС с поддержкой cloud-init, что позволяет выполнять инициализацию виртуальных машин после их создания.

Для операционных систем семейства Windows платформа поддерживает инициализацию с помощью встроенной утилиты sysprep.

Поддерживаемые конфигурации виртуальных машин

Максимальное число поддерживаемых ядер: 254 Максимальный объем оперативной памяти: 1024 Гб

Поддерживаемые хранилища

Виртуальные машины используют ресурсы PersistentVolume. Для управления этими ресурсами и выделения дискового пространства в кластере должно быть установлено одно или несколько поддерживаемых хранилищ:

Порядок установки

1. Разверните кластер Deckhouse Kubernetes Platform по инструкции.

2. Для хранения данных виртуальных машин (виртуальные диски и образы) необходимо включить один или несколько поддерживаемых хранилищ.

3. Установите StorageClass по умолчанию.

4. Включите модуль console, который позволит управлять компонентами виртуализации через графический интерфейс (данная возможность доступна только пользователям EE-редакции).

5. Включите модуль virtualization:

Для включения модуля virtualization, необходимо создать ресурс ModuleConfig содержащий настройки модуля.

Пример конфигурации модуля:

d8 k apply -f - <<EOF
apiVersion: deckhouse.io/v1alpha1
kind: ModuleConfig
metadata:
  name: virtualization
spec:
  enabled: true # Включить модуль.
  settings:
    dvcr:
      storage:
        persistentVolumeClaim:
          size: 50G
        type: PersistentVolumeClaim
    virtualMachineCIDRs:
      - 10.66.10.0/24
  version: 1
EOF

Блок .spec.settings.dvcr описывает настройки для репозитория для хранения образов виртуальных машин, в нём указывается размер хранилища предоставляемого для хранения образов .spec.settings.dvcr.storage.persistentVolumeClaim.size.

В блоке .spec.settings.virtualMachineCIDRs задается список подсетей. Адреса виртуальных машин будут выделяться автоматически или по по запросу из заданных диапазонов подсетей по порядку.

Отследить готовность модуля можно с использованием следующей команды:

d8 k get modules virtualization

Пример вывода:

# NAME             WEIGHT   STATE     SOURCE     STAGE   STATUS
# virtualization   900      Enabled   Embedded           Ready

Статус модуля должен быть Ready.

Обновление платформы

Deckhouse Virtualization Platform использует пять каналов обновлений, предназначенных для использования в разных окружениях, к которым с точки зрения надежности применяются разные требования:

Компоненты Deckhouse Virtualization Platform могут обновляться автоматически, либо с ручным подтверждением по мере выхода обновлений в каналах обновления.

Информацию по версиям, доступных на каналах обновления, можно получить на сайте https://releases.deckhouse.ru/