Deckhouse Platform в Yandex Cloud

1
Выбор инфраструктуры
2
Информация об установке
3
Подготовка окружения
4
Установка
5
Получение доступа к кластеру
6
Куда двигаться дальше?
Подготовка окружения

Перед установкой обязательно проверьте:

  • Квоты облачного провайдера для развёртывания кластера.
  • На ВМ установлен пакет cloud-init. После старта ВМ запущены службы cloud-config.service, cloud-final.service, cloud-init.service.
  • В шаблоне виртуальной машины присутствует только один диск.
  • Правила межсетевого экрана и группы безопасности разрешают UDP-трафик между узлами кластера. Новый кластер по умолчанию использует CNI Cilium с туннелированием трафика подов через VXLAN. Для работы Cilium на узлах требуется ядро Linux версии 5.8 или новее, а список портов приведён в разделе «Сетевое взаимодействие компонентов платформы».

Дополнительные требования и сведения

  • Для ContainerdV2 на узлах кластера ОС на виртуальных машинах должна соответствовать требованиям:
    • ядро Linux версии 5.8 и новее, за исключением диапазонов 6.12.0–6.12.28 или 6.14.0–6.14.6 (эти версии подвержены уязвимости CVE-2025-37999 в EROFS);
    • поддержка CgroupsV2;
    • systemd версии 244 и новее;
    • поддержка модуля ядра erofs.

    Подробнее в разделе «ClusterConfiguration».

  • Начиная с версии 1.74 в Deckhouse Platform появился механизм контроля целостности модулей (защита от подмены и модификаций). Он включается автоматически, если на узлах ОС поддерживает модуль ядра erofs. Если erofs недоступен, Deckhouse Platform продолжит работать как раньше, но контроль целостности будет отключён, и в мониторинге появится алерт о недоступности механизма.

Подготовьте окружение Yandex Cloud, чтобы Deckhouse Platform мог управлять ресурсами в облаке. Полная инструкция приведена на странице подготовки окружения модуля cloud-provider-yandex.

Создайте сервисный аккаунт для Deckhouse Platform и назначьте ему роли compute.editor, vpc.admin и load-balancer.editor:

  1. Создайте сервисный аккаунт с именем deckhouse:

    yc iam service-account create --name deckhouse

    В ответ вернутся параметры сервисного аккаунта:

    id: <userID>
folder_id: <folderID>
created_at: "YYYY-MM-DDTHH:MM:SSZ"
name: deckhouse

  2. Назначьте роли сервисному аккаунту в каталоге:

    yc resource-manager folder add-access-binding --id <folderID> --role compute.editor --subject serviceAccount:<userID>
yc resource-manager folder add-access-binding --id <folderID> --role vpc.admin --subject serviceAccount:<userID>
yc resource-manager folder add-access-binding --id <folderID> --role load-balancer.editor --subject serviceAccount:<userID>

  3. Создайте JSON-файл с авторизованным ключом сервисного аккаунта. Deckhouse Platform использует его для доступа к облаку:

    yc iam key create --service-account-name deckhouse --output deckhouse-sa-key.json
Вернуться назад Далее: Установка