# Обновления AVE.cms

Раздел **Система → Обновления** устанавливает подписанные исправления ядра без
копирования полной сборки поверх рабочего сайта.

## Подключение источника

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

Если источник был отключён или изменён, откройте вкладку **Источник** и нажмите
**Восстановить официальный**. Текущий URL и ключ будут заменены доверенными
значениями из установленной сборки.

Для стороннего источника его издатель должен предоставить единый JSON-профиль
либо отдельно HTTPS URL `index.json` и публичный RSA-ключ. Публичный ключ не
является паролем: он позволяет проверить подпись каталога. Закрытый ключ всегда
остаётся у издателя.

1. Откройте вкладку **Источник**.
2. Включите проверку удалённого каталога.
3. Укажите HTTPS URL файла `index.json`.
4. Вставьте публичный RSA-ключ выбранного издателя.
5. Сохраните настройки и нажмите **Проверить**.

Публичный ключ не является секретом. Закрытый ключ никогда не загружается на
сайт. Ключ обновлений ядра отделён от ключа каталога модулей.

## Установка

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

Если выбран не тот патч, нажмите **Отменить** до запуска. Загруженный ZIP и
временные файлы удалятся; это действие не затрагивает сайт и базу данных.

После запуска выполняются резервная копия, временное закрытие публичного сайта,
замена файлов, миграции и контрольная проверка. Этапы идут короткими AJAX-
запросами; вкладку можно открыть снова и продолжить незавершённое задание.

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

## Какие файлы заменяются

Файлы ядра, входящие в патч, заменяются последней опубликованной версией без
сверки со старой checksum на сервере. Их текущее состояние сначала сохраняется
в журнал отката. Подпись и checksum проверяют целостность нового архива, а номер
build определяет применимость обновления.

Настройки БД, публичные шаблоны, медиа, runtime-данные и модули core-патчем не
перезаписываются. Новые миграции схемы выполняются внутри того же задания; после
обновления отдельно запускать миграции ядра не требуется.

## Откат

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

Не удаляйте `storage/updates/` и не копируйте поверх сайта другую сборку, пока
задание не завершено или не откатилось.