Обновление версий

Инструкции для перехода с более ранних релизов ядра на актуальную поставку 1.0.13 и опциональный модуль «Медиатека файлов» 1.0.0. Новая установка — в разделе Установка и первый запуск. История изменений — журнал версий.

1. Обновление с 1.0.10

Версия 1.0.11 — техническое обновление без новых экранов админки и без изменений Public API для интеграторов. Gateway Ops из 1.0.10 сохраняется.

1.1. Подготовка

1. Сохраните backup config.yml, секретов и snapshot базы данных.
2. Зафиксируйте текущую версию — должна быть 1.0.10.
3. Остановите сервис: sudo systemctl stop cascad360.

1.2. Установка 1.0.11

Linux (tar.gz):

tar xzf cascad360-1.0.11-linux-x86_64.tar.gz -C /opt/
/opt/cascad360/install.sh

Debian:

sudo dpkg -i cascad360_1.0.11_amd64.deb
sudo apt-get install -f

1.3. Конфигурация production

app:
  distribution: binary

На staging и dev оставьте distribution: dev (значение по умолчанию).

1.4. Запуск и проверка

1. Запустите сервис: sudo systemctl start cascad360.
2. Миграции БД для 1.0.11 обычно не требуются — при наличии pending revisions выполните alembic upgrade head.
3. Проверьте вход в админку, сервисы, маршрутизацию, почту и Public Auth.
4. Health-check: curl http://localhost:5000/api/health — в ответе "version":"1.0.11".

1.5. Откат

При проблемах: остановите сервис, установите пакет 1.0.10, восстановите backup config.yml.

2. Обновление с 1.0.11

Версия 1.0.12 — релиз для команд эксплуатации: управление плагинами и более предсказуемая админ-панель. Public API для интеграторов не меняется.

2.1. Подготовка

1. Сохраните backup config.yml — изменения настроек плагинов из админки записываются в файл.
2. Зафиксируйте текущую версию — должна быть 1.0.11.
3. Остановите сервис: sudo systemctl stop cascad360.

2.2. Установка 1.0.12

tar xzf cascad360-1.0.12-linux-x86_64.tar.gz -C /opt/
/opt/cascad360/install.sh

sudo dpkg -i cascad360_1.0.12_amd64.deb
sudo apt-get install -f

2.3. Запуск и проверка

1. Запустите сервис: sudo systemctl start cascad360.
2. Откройте раздел Плагины — проверьте статусы и настройки.
3. Обновите страницу админки в браузере.
4. Health-check: curl http://localhost:5000/api/health — "version":"1.0.12".

2.4. Проверка админ-панели после 1.0.12

1. Файлы — таблица и сообщения об ошибках, не бесконечный спиннер.
2. Безопасность — все вкладки показывают содержимое.
3. Настройки и интеграции — вкладки переключаются.
4. Пользователи — модалки открываются.

2.5. Откат

При проблемах: установите пакет 1.0.11, восстановите backup config.yml.

3. Обновление с 1.0.12

Релиз Module Files: медиатека вынесена в модуль «Медиатека файлов» 1.0.0. Сначала ядро 1.0.13, затем при необходимости модуль. Клиенты Files API — см. документацию модуля.

3.1. Подготовка

1. Backup config.yml и каталога загрузок.
2. Текущая версия ядра — 1.0.12.
3. sudo systemctl stop cascad360

3.2. Шаг 1 — ядро 1.0.13

sudo dpkg -i cascad360_1.0.13_amd64.deb
sudo apt-get install -f

3.3. Шаг 2 — модуль «Медиатека файлов» 1.0.0

Полная процедура — установка модуля в инструкции по первому запуску.

1. Установите пакет модуля (.deb или tar.gz) с cascad360.ru/downloads/modules/….
2. Добавьте модуль в modules.installed, files.enabled: true, настройте storage.
3. Restart или Модули → Включить; nginx для /media/ при необходимости.

3.4. Проверка

1. Health: "version":"1.0.13".
2. Раздел Файлы — upload и список (если модуль установлен).
3. Files API — upload и delivery для public файла.

3.5. Откат

При проблемах: верните пакет 1.0.12, восстановите backup конфигурации.