Что такое vStack OS
vStack OS — операционная система узла гиперконвергентной платформы vStack HCP. Это собственная сборка FreeBSD: базовая система, ядро и набор контроллеров, которые превращают обычный сервер в узел кластера. На каждом узле одновременно работают виртуальные машины, хранилище и сеть, отдельных СХД и сетевых контроллеров в кластере нет.
Управляет кластером vStack Center. Он живёт в управляющей ВМ на этом же кластере, и у него своя документация: vStack Center. Здесь описано то, что лежит ниже: сами узлы, их установка, обновление и утилиты, которыми администратор работает на узле.
Из чего состоит узел
| Слой | Что делает | Как это видно администратору |
|---|---|---|
| Гипервизор bhyve | Исполняет виртуальные машины. Процессом каждой ВМ управляет контроллер vstack-vm | ВМ пула работают на узле, который держит этот пул |
| Хранение на ZFS | Каждый пул собран как raidz из одного диска с каждого узла. Свои диски узел подключает локально, чужие получает по iSCSI. Если ВМ работает не на узле-владельце своего пула, её диски приезжают по NVMe-oF/TCP | Пулы называются z01, z02 и так далее. Пул переживает потерю стольких узлов, сколько задано уровнем избыточности N+1…N+3 |
| Программная сеть | Сети ВМ, изолированные сети поверх VXLAN, точки доступа наружу | Физически это два агрегата LACP, lagg10 и lagg20, с VLAN поверх |
| Cluster Manager | Кластерный фреймворк: следит за узлами, решает, какой узел держит какой пул, и переносит пулы при отказе узла. На узле это демон ccrd | Каждый пул представлен сервисом zpool_<пул>, например zpool_z01. Состояние кластера показывает CLI узла |
В vStack Center этот компонент называется так же, Cluster Manager, поэтому между двумя документациями термин не меняется.
Кто чем управляет
vStack Center не трогает узлы напрямую. Когда администратор включает узел, отключает его или переносит пул, Center передаёт команду в Cluster Manager, а тот доводит её до узлов. Отсюда два следствия.
Первое. Кластер не останавливается вместе с Center. Если управляющая ВМ лежит, работающие ВМ продолжают работать, а Cluster Manager по-прежнему переносит пулы при отказе узла. Пропадают веб-интерфейс и API, и заодно тот, кто поднимает ВМ перенесённого пула: запуск машин после переноса делает Center.
Второе. Управляющая ВМ сама живёт на одном из пулов кластера, обычно на
z01, и в списке ВМ пула у неё номер 0. Пул с управляющей ВМ нельзя
переносить из интерфейса Center: Center выключит сам себя посреди операции.
Такой пул переносят с узла, утилитой кластера. Как это делается, описано в
разделе про обновление узла.
Роли вне этого разделения тоже есть. Установку узла и первичную сборку
кластера делает установщик vStack OS, Center в этот момент ещё не существует.
Он разворачивается сам при первой загрузке узлов. Обновление ОС узла тоже
выполняется на самом узле, штатным скриптом vStack.update.sh.
Версии
Актуальная версия — 3.2.0 (25.09.2026), база FreeBSD 14.2. Предыдущие выпуски линии 3.x: 3.1.0 (09.09.2026) и 3.0.11 (31.08.2026). Узлы линии 2.x работают на FreeBSD 13.2 и переходят на 3.x отдельной процедурой, вместе с технической поддержкой vStack.
Что изменилось в каждой версии, смотрите в разделе «Что нового».
Карта документации
| Раздел | Что там |
|---|---|
| Требования к оборудованию и сети | Процессоры, контроллеры дисков и сетевые карты, раскладка дисков хранения, коммутация и VLAN |
| Установка узла и сборка кластера | Установка с носителя, диалоги установщика, первая загрузка кластера |
| Обновление до 3.2 | Поочерёдное обновление узлов штатным скриптом, проверки и откат |
| Снятие конфигурации узла | Копия конфигурации узла перед обновлением или переустановкой |
| CLI узла | Утилита кластера и vStack.update.sh: команды, ключи, коды возврата |
| Что нового | Изменения по релизам |
Виртуальные машины, ВЦОД, сети, пользователи и роли настраиваются в vStack Center. Это описано в его документации.