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

Основные возможности

• Автоматическая проверка — периодическая проверка наличия новых версий
• Уведомления в интерфейсе — визуальные индикаторы о доступных обновлениях
• Информация о версии — отображение текущей и доступных версий
• Описание изменений — подробная информация о нововведениях в обновлениях
• Контроль конфиденциальности — возможность отключения автоматической проверки

Типы обновлений

Как работает автоматическая проверка?

1. Система периодически обращается к серверу обновлений
2. Отправляет информацию о текущей версии и конфигурации:
   • Идентификатор инсталляции
   • Версия INFRAX
   • Количество пользователей (для проверки лицензии)
   • Количество узлов (для проверки лицензии)
3. Получает информацию о доступных обновлениях
4. Сохраняет данные для отображения уведомлений
5. Показывает индикатор обновлений в интерфейсе

Что отображает индикатор?

• Количество доступных обновлений — число новых версий
• Версии обновлений — номера доступных версий
• Краткое описание — основные изменения в обновлениях
• Ссылка на подробности — информация о том, как получить обновление

Формат: MAJOR.MINOR.PATCH

• MAJOR — крупные изменения, возможны несовместимости
• MINOR — новые функции с обратной совместимостью
• PATCH — исправления ошибок и патчи

Пример: версия 1.2.3

• Major: 1
• Minor: 2
• Patch: 3

1. Запустите меню управления INFRAX
2. Выберите пункт "5. 🔄 Обновить приложение"
3. Система проверит доступность репозитория и наличие обновлений
4. Если обновления доступны, будет показана информация о версиях
5. Система остановит приложение
6. Будет предложено создать резервную копию (настоятельно рекомендуется!)
7. Обновится код из Git-репозитория
8. Загрузятся новые Docker-образы
9. Система предложит запустить обновленное приложение

При запуске обновления система автоматически определяет доступные варианты:

• Есть архивы в ./updates/ и есть интернет — система предложит выбрать между онлайн и офлайн режимом
• Есть архивы в ./updates/, нет интернета — автоматически использует офлайн-режим
• Нет архивов, есть интернет — использует онлайн-режим
• Нет архивов, нет интернета — обновление невозможно, выводится ошибка

На системе с доступом к интернету:

1. Убедитесь, что установлена нужная версия INFRAX (переключитесь на нужный канал обновлений при необходимости)
2. Запустите меню управления INFRAX
3. Выберите пункт "8. 📦 Подготовить пакет для замкнутой среды"
4. Система автоматически:
   • Скачает все необходимые Docker-образы
   • Сохранит их в папку ./images/ в формате .tar
   • Создаст сжатый архив .tar.gz со всем приложением и образами
   • Поместит готовый пакет в папку ./updates/
   • Очистит папку ./images/ после создания архива
5. Готовый пакет будет иметь имя вида: ./updates/1.0.0.tar.gz (версия из versions.json)

1. Скопируйте архив из папки ./updates/ на съемный носитель
2. Перенесите его в замкнутую сеть
3. Поместите архив в папку ./updates/ на целевой системе

На целевой системе в замкнутой среде:

1. Убедитесь, что архив находится в папке ./updates/
2. Запустите меню управления INFRAX
3. Выберите пункт "5. 🔄 Обновить приложение"
4. Система автоматически обнаружит архивы в ./updates/
5. Если есть доступ к интернету, будет предложен выбор между онлайн и офлайн режимом
6. Выберите "2. Офлайн обновление (из архива)"
7. Система покажет список доступных архивов с размерами и датами
8. Выберите нужный архив по номеру
9. Подтвердите установку
10. Система:
    • Остановит приложение
    • Предложит создать резервную копию
    • Распакует архив
    • Загрузит Docker-образы в локальный Docker
    • Удалит файлы образов после загрузки
    • Предложит запустить обновленное приложение

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

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

• ✅ Работа в полностью изолированных сетях без доступа к интернету
• ✅ Контроль версий — можно хранить несколько пакетов разных версий
• ✅ Быстрое развертывание — не требуется загрузка из интернета
• ✅ Надежность — пакет проверяется на системе с интернетом перед переносом
• ✅ Безопасность — все компоненты предварительно скачаны и проверены

📋 Регулярно проверяйте обновления

Даже если автоматическая проверка отключена, периодически проверяйте наличие обновлений вручную. Обновления могут содержать важные исправления безопасности.

🔒 Устанавливайте патчи безопасности

Обновления типа PATCH часто содержат исправления уязвимостей безопасности. Устанавливайте их как можно быстрее после выхода.

💾 Всегда делайте резервные копии

Перед любым обновлением создавайте полную резервную копию базы данных и конфигурации. Это единственный способ безопасного отката в случае проблем.

🧪 Тестируйте в тестовой среде

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

📝 Читайте описание изменений

Всегда читайте Changelog перед установкой обновления. Обратите особое внимание на breaking changes и новые требования.

⏰ Планируйте обновления

Устанавливайте обновления в период минимальной нагрузки на систему и предупреждайте пользователей заранее.

🔄 Обновляйте агенты

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

📞 Держите контакты поддержки

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

📊 Мониторьте систему после обновления

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