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

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

1. Обновление с 1.0.8–1.0.11 (архивные пакеты)

Релизы ядра 1.0.8–1.0.11 сняты с cascad360.ru/downloads. Пошаговые цепочки «10 → 11 → 12» больше недоступны: установите ближайший опубликованный пакет — обычно сразу 1.0.15 (рекомендуется) или промежуточный 1.0.12 / 1.0.13 / 1.0.14, если нужен поэтапный переход.

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

1. Backup config.yml, секретов и snapshot базы данных.
2. Зафиксируйте текущую версию (1.0.8 … 1.0.11).
3. sudo systemctl stop cascad360

1.2. Установка доступного релиза

Debian (пример — актуальное ядро 1.0.15):

wget https://cascad360.ru/downloads/core/1.0.15/cascad360_1.0.15_amd64.deb
sudo dpkg -i cascad360_1.0.15_amd64.deb
sudo apt-get install -f

Tar.gz — каталог downloads/core/1.0.15/ или 1.0.12/ по инструкции по установке.

1.3. После прыжка через несколько minor

• Миграции БД выполняются при старте; при ошибках — alembic upgrade head по runbook вашей команды.
• Для production после 1.0.11+ рекомендуется app.distribution: binary — см. справочник config.yml.
• На 1.0.14 — шаги лицензии и маркета: §3.
• На 1.0.12 — чеклист админки: §2.5; далее при необходимости §2 и §3.

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

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

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

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

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

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

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

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

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

2.4. Проверка

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

2.5. Чеклист админ-панели (после перехода на 1.0.12+)

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

2.6. Откат

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

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

Релиз Market Licensing: файл лицензии license.cascad, ограниченный режим без лицензии, маркет расширений в составе пакета ядра.

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

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

3.2. Установка 1.0.14

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

Или tar.gz с cascad360.ru/downloads/core/1.0.14/.

SHA-256: .deb c4359477331b972e639b3d445f550ec23b3beb4e31e31682c1c3adb71016508e · tar.gz 3522542a83cd0b88f06d4cbc16c54b5b357207285a8858076762cba745b00063

3.3. Лицензия

1. После первого запуска без файла лицензии платформа работает в ограниченном режиме (баннер в админке).
2. Загрузите license.cascad в разделе лицензирования админки (файл выдаётся КАСКАД 360 или вашим договором).
3. Перезапустите сервис в production (без --dev), чтобы ядро перечитало лицензию с диска.

3.4. Маркет и медиатека

• Маркет — уже в поставке 1.0.14; проверьте market.enabled: true и раздел «Маркет» в админке.
• Медиатека — optional module files; для новых установок и после перехода на 1.0.14 рекомендуется 1.0.1 (обновление с 1.0.0).

3.5. Проверка

1. Health: "version":"1.0.14".
2. Раздел лицензирования — статус после upload.
3. Маркет — каталог или уведомление в restricted (если лицензии ещё нет).

3.6. Откат

При проблемах: пакет 1.0.13, backup config.yml. Учтите отличия формата лицензии.

4. Обновление с 1.0.14

Релиз Plugin Database Gateway: стабильнее админка и интеграции, настройка базы данных для плагинов через интерфейс (как для сервисов). Public API для интеграторов — без намеренных breaking changes. Лицензия license.cascad и маркет — как в 1.0.14.

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

1. Backup config.yml, license.cascad и каталога данных.
2. Текущая версия ядра — 1.0.14.
3. sudo systemctl stop cascad360

4.2. Установка 1.0.15

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

Или tar.gz с cascad360.ru/downloads/core/1.0.15/.

SHA-256: .deb f75fc7c6fd9d2b209bddb55550d4a69fdc904cb0681c4ed67caded26e8179abc · tar.gz dd53cd720ae0ef8855c310f4b6f2b7824850c96fa967544f1370ec93cb595d5e

4.3. Плагины и база данных (операторы)

Для расширений, которым нужна отдельная logical database: Настройки плагина → База данных — выбор datasource, установка схемы по кнопке. Обычные плагины (почта, контент) работают как раньше на основной БД платформы.

4.4. Проверка

1. Health: "version":"1.0.15".
2. Админка — меню и раздел лицензирования без регрессий.
3. Smoke Public Auth / Database API для ваших интеграций.

4.5. Откат

При проблемах: пакет 1.0.14 и backup config.yml.

5. Обновление модуля медиатеки 1.0.0 → 1.0.1

Patch 1.0.1 исправляет повторный import ORM модуля после перезагрузки namespace (типично при ядре 1.0.15 и bundled-маркете). Контракт Public Files API и миграции БД не меняются; достаточно заменить файлы модуля.

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

1. Backup config.yml и каталога local storage (storage.path для файлов).
2. Зафиксируйте текущую версию модуля в module.json — должна быть 1.0.0 (или пропустите раздел, если уже 1.0.1).

5.2. Установка 1.0.1

Debian:

wget https://cascad360.ru/downloads/modules/cascad360-module-files/1.0.1/cascad360-module-module-files_1.0.1_all.deb
sudo dpkg -i cascad360-module-module-files_1.0.1_all.deb
sudo apt-get install -f

Tar.gz (замена каталога модуля):

sudo systemctl stop cascad360
sudo tar xzf cascad360-module-module-files-1.0.1.tar.gz -C /opt/cascad360/modules/
sudo systemctl start cascad360

SHA-256: .deb 61066da0cd0ae7fd81a24db43c45cfdd1568a51f93c303d217a8ccdc9952bf13 · tar.gz ec9128cf437fdbcb5014fbf0f7bf2a991311f5e18ba6a48160a505255d049acb

5.3. Проверка

1. В админке → Модули — версия cascad360-module-files отображается как 1.0.1.
2. Раздел Файлы — список и загрузка без ошибок.
3. При необходимости — smoke Files API (документация).

5.4. Откат

При проблемах: восстановите backup каталога модуля 1.0.0 или установите пакет 1.0.0 из журнала 1.0.13.