Главная / Документация / Установка и обновлениеУстановка в Kubernetes и DeckhouseКак поставить volrix.pm в существующий кластер Kubernetes или Deckhouse из браузера: мастер внутри кластера, без терминала и своего реестра образов.Обновлено 15.10.2026volrix.pm ставится в уже работающий кластер Kubernetes - например, Deckhouse - мастером установки в браузере. Кластер мастер не разворачивает: он ставит в него базу данных, хранилище файлов и само приложение. Терминал не нужен, если запустить мастер прямо в кластере из веб-консоли платформы. Установка на обычные серверы описана в статье Установка volrix.pm.Что нужно от кластера

**Kubernetes 1.28 или новее.** Проверено на Deckhouse CE (Kubernetes 1.33).

**Права администратора кластера** для мастера: если в кластере нет оператора баз данных CloudNativePG, мастер ставит его сам.

**Класс хранилища** (StorageClass) для томов базы данных и файлов. Подойдет класс по умолчанию; если его нет, мастер предложит первый из имеющихся.

**Ingress-контроллер** - через него сотрудники открывают систему (в Deckhouse - nginx).

**cert-manager** для сертификата HTTPS - желательно. Без него положите сертификат в секрет volrix-tls сами.

**Доступ узлов кластера в интернет к volrix.ru** - образы volrix.pm узлы скачивают из публичного реестра volrix.ru/volrix без регистрации. Без интернета - реестр организации, раздел «Закрытый контур» ниже.

**Ресурсы:** около 5 vCPU и 7 ГБ памяти в запросах подов; диски - три тома базы данных (по умолчанию по 10 ГБ) и три тома файлов по 50 ГБ.

**Имя системы в DNS**, например volrix.company.ru, - указывает на Ingress кластера: адреса узлов с Ingress или балансировщик перед ними.

Установка без терминала: мастер в кластере

Скачайте манифест мастера Откройте volrix.ru/download/k8s-installer.yaml и скопируйте весь текст. В первых строках - адрес мастера с вашим личным ключом доступа вида https://IP-узла:30943/?key=... Сохраните его. Ключ новый при каждом скачивании.

Создайте мастер в кластере В веб-консоли платформы выберите создание ресурса из YAML (в Deckhouse - «Консоль» или Kubernetes Dashboard), вставьте текст и подтвердите. В кластере появятся пространство имен volrix-installer, учетная запись мастера, его ключ и служба на порту 30943 узлов.

Откройте мастер Через минуту откройте сохраненный адрес, подставив IP любого узла кластера. Сертификат мастера самоподписанный - браузер предупредит, это нормально. Мастер работает внутри кластера и видит его сам: kubeconfig вводить не нужно.

Шаг «Платформа» Мастер проверит кластер и покажет, что нашел: версию Kubernetes, оператор баз данных, классы хранилища и Ingress. Хранилище, Ingress, сертификат и источник образов он подберет сам. Впишите имя системы и при необходимости поправьте остальное - поля описаны ниже.

Шаг «Итог» Проверьте, что будет сделано: адрес, версия, база данных и ее диски, хранилище файлов, откуда образы, сертификат. Нажмите «Развернуть».

Развертывание Мастер показывает ход установки. Обычно 3-15 минут; первая установка дольше - узлы скачивают образы. В конце - адрес системы, логин info@volrix.ru и пароль администратора. Сохраните пароль.

Мастер работает с правами администратора кластера. После установки его можно оставить - через него ставится новая версия - или удалить: пространство имен volrix-installer и ClusterRoleBinding volrix-installer. volrix.pm от этого не зависит.Поля шага «Платформа»

Поле

Что выбрать

Имя, по которому сотрудники откроют volrix.pm

Обязательное. Например volrix.company.ru. По этому же имени - ссылки в письмах системы.

Сертификат HTTPS

ClusterIssuer cert-manager. selfsigned - самоподписанный: работает сразу, браузер предупреждает. letsencrypt - настоящий, если имя доступно из интернета. «Без cert-manager» - сертификат кладете сами в секрет volrix-tls.

Класс хранилища

Для томов базы данных и файлов. Для рабочей системы - класс с репликацией или на быстрых дисках.

Диск базы данных на каждый из трех экземпляров

По умолчанию 10Gi. База - три экземпляра PostgreSQL: при отказе узла роль основного переходит к реплике сама.

Файлы пользователей

«В кластере, отдельное хранилище S3» - три экземпляра SeaweedFS, каждый файл в двух копиях. «В базе данных» - без отдельного хранилища, для небольших установок.

Откуда кластер возьмет программу

«Публичный реестр Volrix» - узлы скачают образы с volrix.ru. «Реестр организации» - для закрытого контура.

Дополнительно → Пространство имен

Где в кластере будут объекты volrix.pm. По умолчанию volrix.

Дополнительно → Класс Ingress

Через какой Ingress-контроллер открывать систему.

Закрытый контурЕсли у узлов нет доступа к volrix.ru, выберите в мастере «Реестр организации» и укажите реестр с путем, например registry.company.ru/volrix, и логин, если реестр его требует. Мастер скопирует туда образы volrix-app и volrix-web своей версии и передаст кластеру секрет доступа к реестру. Если интернета нет и у самого мастера, загрузите эти два образа в реестр заранее и отметьте «Образы уже загружены в реестр».Кроме образов volrix.pm, кластеру нужны образы, которые ставятся из открытых реестров: valkey/valkey и chrislusf/seaweedfs (Docker Hub), оператор и PostgreSQL CloudNativePG (ghcr.io). В закрытом контуре они должны быть доступны через зеркало реестров платформы.Мастер на отдельном сервереЕсли создавать ресурсы в кластере из консоли нельзя, мастер запускается на отдельном сервере Linux командой с страницы установки, как для установки на серверы, и выбирается вариант «Kubernetes». Тогда мастеру нужен kubeconfig - файл доступа к кластеру с правами администратора:

**Deckhouse с опубликованным API** (модуль user-authn, параметр publishAPI): страница kubeconfig.<домен кластера> выдает готовый файл после входа - его можно вставлять как есть.

**С узла управления:** файл /root/.kube/config (читается через sudo). В нем адрес API https://127.0.0.1:6445 - он работает только на самом узле. Перед вставкой замените его на адрес, доступный с сервера мастера, например https://IP-узла:6443.

Вставьте файл в поле «kubeconfig» на шаге «Платформа» и нажмите «Сохранить и проверить». Дальше - те же шаги, что выше.Что появится в кластере

Компонент

Как устроен

Приложение

Deployment volrix-app: два пода (веб и сервер в каждом), автомасштабирование до 12 по нагрузке процессора, PodDisruptionBudget - обслуживание узлов не останавливает систему.

База данных

PostgreSQL под оператором CloudNativePG: три экземпляра с синхронной репликацией, пулы соединений для записи и чтения.

Служебное состояние

Valkey с Sentinel, три экземпляра.

Файлы

SeaweedFS, три экземпляра - если выбрано хранилище S3 в кластере.

Вход

Ingress на имя системы с сертификатом cert-manager.

Ограничения сети

NetworkPolicy: к Valkey и хранилищу файлов подключаются только поды приложения (и мониторинг платформы). Доступ к PostgreSQL закрывает оператор CloudNativePG.

Наблюдение

Метрики PostgreSQL для Prometheus платформы и правила оповещений (PrometheusRule) - в Deckhouse их подхватывает модуль monitoring.

Миграции базы выполняются заданием перед раскаткой новой версии подов. Пароль администратора хранится в секрете volrix-secrets пространства имен volrix (ключ admin_password).Если не получается

Что видно

Причина и что сделать

«Нет доступа к кластеру: The connection to the server 127.0.0.1:6445 was refused»

Вставлен kubeconfig с узла управления как есть. Замените адрес https://127.0.0.1:6445 на адрес API, доступный с сервера мастера, или возьмите kubeconfig со страницы kubeconfig.<домен> Deckhouse.

Мастер не открывается по адресу с портом 30943

Под мастера еще запускается (около минуты) или порт 30943 узлов закрыт межсетевым экраном. Проверьте под в пространстве имен volrix-installer в консоли платформы.

Поды базы данных или файлов в ожидании (Pending), «unbound PersistentVolumeClaim»

Выбранный класс хранилища не выдает тома. Выберите другой класс на шаге «Платформа» и нажмите «Развернуть» снова.

Поды приложения в ожидании, «Insufficient cpu» или «Insufficient memory»

Не хватает ресурсов узлов: нужно около 5 vCPU и 7 ГБ памяти в запросах. Добавьте узлы или освободите ресурсы.

Поды не стартуют, ошибка загрузки образа (ImagePullBackOff)

Узлы не достают до volrix.ru. Откройте доступ или выберите «Реестр организации».

Браузер предупреждает о сертификате системы

Выбран самоподписанный сертификат (selfsigned). Для рабочей системы - letsencrypt или сертификат организации.

Установка volrix.pm

Подготовка сервера

Обновление и откат

Один сервер и отказоустойчивый кластер на серверахЧто нужно до установки на серверыНовая версия и возврат к прежней

Скачать volrix.pm и лицензирование

Частые вопросы