Обновления системы

ℹ️ О системе обновлений

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

Содержание раздела

Обзор системы обновлений
Проверка обновлений
Уведомления об обновлениях
Информация о версии
Процесс обновления (онлайн)
Офлайн-обновления (замкнутая среда)
Настройка проверки обновлений
Рекомендации

Обзор системы обновлений

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

Что видит пользователь

Где	Что отображается
Шапка интерфейса	Оранжевая кнопка с бейджем, где показывается количество доступных обновлений
Окно обновлений	Список версий, даты релизов, описание изменений, ссылка на документацию и кнопки `Больше не показывать` и `Закрыть`
О программе	Текущая версия и кнопка `Выгрузить информацию для технической поддержки`
Меню управления	Пункты для обновления приложения, переключения канала обновлений и подготовки офлайн-пакета

Кому показываются уведомления

Индикатор и модальное окно доступны только пользователям, у которых есть права на системные разделы INFRAX.
Уведомление открывается автоматически после входа, если найден новый набор релизов и пользователь не скрывал его ранее.
Если уведомление уже скрыто, оно вернется только тогда, когда появится новая комбинация доступных версий.

Проверка обновлений

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

Что отправляется при проверке

Данные	Назначение
`appId`	Идентификатор инсталляции
`version`	Текущая версия INFRAX
`usersCount`	Количество активных пользователей
`nodesCount`	Количество узлов сети типа Endpoint
`anonymousStatsEnabled`	Флаг анонимной статистики

ℹ️ Конфиденциальность

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

Если параметр выключен, автоматическая проверка не запускается и новые релизы не подгружаются в фоне.

Уведомления об обновлениях

Индикатор обновлений

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

Что видно в модальном окне

Версия - номер релиза в виде бейджа
Предрелиз - метка для pre-release сборок
Beta - метка для release candidate сборок
Дата выпуска - дата релиза в локальном формате
Описание - changelog, отрендеренный из Markdown
Документация - ссылка на инструкции по обновлению

Действия в окне обновлений

Кнопка	Что делает
Шеврон в заголовке выпуска (`Показать описание выпуска`)	Раскрывает и сворачивает описание выпуска. Появляется, только когда выпусков больше одного; раскрытое описание прокручивается внутри своей рамки
`Больше не показывать`	Сохраняет скрытие текущего уведомления для пользователя
`Закрыть`	Закрывает окно без изменения настроек скрытия

✅ Как работает скрытие

Кнопка Больше не показывать сохраняет идентификатор текущего уведомления в настройках пользователя. Окно не появится снова, пока не будет собран новый набор релизов.

Информация о версии

Текущую версию INFRAX можно посмотреть в разделе О программе. Если версия не определена, интерфейс показывает значение Не определена.

Где смотреть версию

Раздел	Что показывает
О программе	`Текущая версия` и кнопку `Выгрузить информацию для технической поддержки`
Окно обновлений	Версии релизов, дату выпуска и маркировку pre-release или Beta
Документация по обновлениям	Инструкции по онлайн- и офлайн-обновлению

Процесс обновления (онлайн)

Обновление приложения выполняется из меню управления INFRAX. В зависимости от установки меню запускается через bash infrax.sh, sudo infrax или аналогичный скрипт. Пункт "5. 🔄 Обновить приложение" проверяет доступные варианты и запускает обновление в выбранном режиме.

Что происходит при онлайн-обновлении

Система проверяет репозиторий и доступные обновления.
Если найдено несколько вариантов, отображается выбор между онлайн и офлайн режимом.
Приложение останавливается.
Пользователю предлагают создать резервную копию.
Обновляется код из репозитория и загружаются новые Docker-образы.
Система предлагает запустить обновленное приложение.

Канал обновлений

Пункт "6. 🔀 Переключить канал обновлений" позволяет выбрать стабильный или бета-канал. Стабильный канал подходит для продуктивных систем, а бета-канал - для тестовых инсталляций.

Офлайн-обновления (замкнутая среда)

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

Подготовка офлайн-пакета

Запустите меню управления INFRAX на системе с интернетом.
Выберите пункт "8. 📦 Подготовить пакет для замкнутой среды".
Система скачает Docker-образы, сохранит их в ./images/ как .tar и соберет архив .tar.gz.
Готовый пакет будет помещен в папку ./updates/.

Первичная установка в закрытой сети

Если на целевой системе INFRAX ещё не установлен:

Убедитесь, что на целевой системе установлены Docker и Docker Compose.
Скопируйте архив .tar.gz на целевую систему.
Распакуйте архив: mkdir -p /opt/infrax && tar -xzf <версия>.tar.gz -C /opt/infrax
Запустите bash infrax.sh и выберите пункт "1. ▶️ Запустить/Перезапустить приложение".
Система автоматически загрузит Docker-образы из архива и запустит все сервисы.

Обновление в закрытой сети

Если INFRAX уже установлен и нужно обновить его до новой версии:

Убедитесь, что на целевой системе установлен Git.
Скопируйте архив .tar.gz в папку ./updates/ на целевой системе.
Запустите пункт "5. 🔄 Обновить приложение".
Выберите "2. Офлайн обновление (из архива)".
Выберите нужную версию из списка и подтвердите установку.

Что входит в пакет

Компонент	Описание
Docker-образы	Все необходимые образы контейнеров в формате `.tar`
Файлы приложения	Код, скрипты, конфигурация и `docker-compose.yml`
`.git/`	История версий и данные репозитория

Из пакета исключаются:

./data/ - пользовательские данные и база данных
./backups/ - резервные копии
./updates/ - другие архивы обновлений
.env - пользовательские настройки

Настройка проверки обновлений

Автоматическая проверка обновлений настраивается в Настройки → Основные настройки → Обновления и статистика.

Параметры раздела

Параметр	Что делает
Проверять обновления приложения	Включает фоновую проверку новых версий и отправляет текущую версию, количество пользователей и количество узлов сети для проверки лицензирования
Разрешить отправку анонимной статистики	Разрешает отправку анонимной статистики использования приложения для улучшения продукта

ℹ️ Приватность

При проверке обновлений отправляются только технические данные, связанные с лицензированием и размером инсталляции. Никакие персональные данные, IP-адреса или содержимое сети не передаются.