Версия платформы

Модулю требуется Basis Dynamix версии 4.6 или новее. Начиная с версии 4.6, Basis Dynamix создаёт диски и виртуальные машины только с указанной политикой хранения (storage policy).

До создания ресурсов в облаке dhctl bootstrap выполняет preflight-проверку dynamix-storage-policy. На Basis Dynamix версии ниже 4.6 эта проверка останавливает установку.

Права учётной записи

Модуль работает с Basis Dynamix через пользовательский API (/restmachine/cloudapi/*). Используйте для модуля учётную запись без прав администратора платформы (/restmachine/cloudbroker/*). С правами администратора модуль получает доступ к ресурсам других аккаунтов, и изоляция аккаунтов нарушается.

Учётной записи, указанной в секции provider DynamixClusterConfiguration, должны быть доступны следующие группы пользовательского API:

Группа Компонент Назначение
account, locations, rg Все компоненты Поиск аккаунта, локации и группы ресурсов по имени
extnet, vins Terraform, CAPD Внешние и внутренние сети
image Terraform, CAPD Образы ОС для узлов
storage_policy Terraform, CAPD, CSI, cloud-data-discoverer Получение списка политик хранения, доступных аккаунту, поиск политики по имени, привязка политик к группе ресурсов кластера
disks Terraform, CSI Диски master-узлов и PersistentVolume
compute, kvmx86 Terraform, CCM, CAPD, CSI Виртуальные машины и подключение дисков
lb CCM Балансировщики нагрузки для Service типа LoadBalancer

Политики хранения в группе ресурсов кластера

Basis Dynamix создаёт виртуальную машину, только если её политика хранения привязана к группе ресурсов. Поэтому при создании группы ресурсов кластера модуль привязывает к ней все политики хранения аккаунта в статусе ENABLED.

Список привязанных политик хранения обновляется при выполнении dhctl converge и при автоматическом применении изменений модулем terraform-manager. При обновлении модуль:

  • привязывает политики хранения, которые стали доступны аккаунту;
  • отвязывает политики хранения, которые стали недоступны аккаунту или перешли из статуса ENABLED в другой статус.

Отключайте политику хранения, только когда её не используют узлы и тома кластера. Когда политика хранения становится недоступной аккаунту, модуль удаляет её StorageClass из кластера. Тома, созданные в этой политике, сохраняются.

При удалении кластера или отмене установки модуль принудительно удаляет группу ресурсов кластера минуя корзину. Вместе с группой безвозвратно удаляется всё, что в ней осталось, в том числе диски томов, балансировщики нагрузки и виртуальные машины групп узлов. Диски etcd master-узлов и ViNS тоже удаляются минуя корзину. Перенесите нужные данные из кластера до его удаления.

Подготовка образа операционной системы

Вендоры операционных систем предоставляют специальные образы ОС (сборки), подготовленные для работы в облачной среде. Эти образы, как правило, содержат драйверы для виртуального оборудования, пакет cloud-init, гостевые агенты систем виртуализации и распространяются в виде образов дисков в форматах IMG или QCOW2. Мы рекомендуем использовать именно такие образы в качестве ОС на узлах ваших кластеров.

Образ операционной системы должен быть размещен в разделе «Образы» → «Шаблонные образы» на портале Basis Dynamix.

В случае, если в инфраструктуре отсутствует DNS-сервер, доступ к порталу Basis Dynamix из кластера можно организовать добавлением IP-адреса и доменов, связанных с порталом Basis Dynamix, в шаблон cloud-init для генерации файла hosts. Данный шаблон расположен в папке /etc/cloud/templates/. Название шаблона зависит от ОС.

Провайдер поддерживает работу только с одним диском в шаблоне виртуальной машины. Убедитесь, что шаблон содержит только один диск.

После добавления данных в файл hosts и перед созданием шаблона из виртуальной машины, выполните команду cloud-init clean.

Замена образа ОС

Образ ОС задаётся параметром imageName ресурса DynamixInstanceClass для узлов типа CloudEphemeral и в секции instanceClass ресурса DynamixClusterConfiguration для узлов типа CloudPermanent и master-узлов.

Порядок замены описан в разделе «Как заменить образ ОС в облачном кластере?».