Обновления MOffice: лента, подпись, API для Hub
Код: kernel/crates/meridian-net (дорожка S1). Решение по
транспорту — docs/development/adr-network-layer.md.
Для Hub (дорожка S2)
use meridian_net::{Channel, Updater, UpdaterConfig, UpdateError};
let updater = Updater::new(UpdaterConfig::for_current_install(env!("CARGO_PKG_VERSION"))?)?; // восстанавливает прерванную установку
let info = updater.check_updates(Channel::Beta)?; // сеть; вызывать в фоне
if info.available {
// карточка: info.latest, info.bytes, info.notes («Что нового»)
let staged = updater.download(&info, &mut |p| { /* p.downloaded / p.total */ true })?; // false — отмена
match updater.install_on_exit(&staged) {
Ok(()) => { /* «Установится при выходе» */ }
Err(UpdateError::SystemInstallerRequired(deb)) => { /* Linux DEB: открыть файл системным установщиком */ }
Err(e) => { /* показать ошибку, ничего не менялось */ }
}
}
// при выходе Hub, когда Write и Sheets закрыты (брокер знает):
if updater.pending().is_some() { updater.apply_pending()?; }
// «Откатиться на 0.9.0»:
if let Some(v) = updater.rollback_version() { updater.rollback()?; }- Все вызовы синхронные — Hub держит их в своём рабочем потоке.
UpdateError::Manifest(..)— подмена или испорченная лента: показывать «Не удалось проверить подлинность обновления», ничего не скачивать.UpdateError::Net(..)— нет сети/прокси.- Профиль и документы обновление не трогает; прежняя версия лежит в папке состояния до следующего обновления.
- Папка состояния: macOS
~/Library/Application Support/MOffice/updates, Linux$XDG_STATE_HOME/moffice/updates, Windows%LOCALAPPDATA%\MOffice\updates.
Лента на сайте
https://moffice.24oros.ru/updates/<канал>/latest.json канал: stable | beta | development
https://moffice.24oros.ru/updates/<канал>/latest.json.sig {"alg":"Ed25519","key_id":"moffice-beta-2026","sig":"<base64>"}
latest.json:
{"schema":1,"product":"moffice","channel":"beta","version":"0.9.1","sequence":12,
"published_at":"2026-12-07T10:00:00+03:00","expires_unix":1798761600,"notes_ru":"Что нового …",
"packages":[{"target":"aarch64-apple-darwin","kind":"apps-zip","url":"https://moffice.24oros.ru/downloads/…zip",
"bytes":123,"sha256":"…"},
{"target":"x86_64-unknown-linux-gnu","kind":"deb","url":"https://…deb","bytes":456,"sha256":"…"}]}sequenceрастёт с каждой публикацией в канале; клиент не примет меньший, чем уже видел.expires_unix— не дальше 90 дней: лента, которую «заморозили», перестаёт приниматься.- Пакет
apps-zipсодержит элементы папки установки (на macOS —MOffice Hub.app…) и описьmoffice-update.json:{"format":1,"version":…,"items":[…],"files":{путь:{bytes,sha256,mode}},"symlinks":{…}}. Версия описи обязана совпасть с версией в подписанном манифесте.
Подпись
- Ключ
moffice-beta-2026, открытая часть —meridian_net::RELEASE_KEY_BETA_2026. Запасной ключmoffice-beta-2026-b(RELEASE_KEY_BETA_2026_B,77742edb…b2ff) встроен в каждую сборку с 0.9.0: если основное зерно потеряно или скомпрометировано, лента подписывается запасным без переустановки у пилота. Зерно запасного —~/.config/moffice-release/update-signing-beta-2026-b.seed; оба зерна — на два офлайн-носителя, запасное после копирования с Mac публикации лучше убрать. - Закрытое зерно (32 байта) — на Mac публикации в
~/.config/moffice-release/update-signing-beta-2026.seed(права 0600, вне git). Владельцу: сделать резервную копию в надёжное место — без зерна новые версии не подписать, и клиенты беты перестанут обновляться до переустановки. - Подписать и проверить:
cargo run -q -p meridian-net --bin moffice-update-tool -- sign --seed ~/.config/moffice-release/update-signing-beta-2026.seed --key-id moffice-beta-2026 latest.jsoncargo run -q -p meridian-net --bin moffice-update-tool -- verify --channel beta --host moffice.24oros.ru latest.json- Смена ключа: выпуск, в котором
release_keys()содержит старый и новый ключ; после того как пилот обновился — лента подписывается новым, старый убирается из следующего выпуска.
Публикация ленты (дорожка S1)
Только из коммита, который уже в origin/main (сборщик и
публикатор проверяют это сами).
python3 -B scripts/package_update_feed.py --version 0.9.0 --notes packaging/release-notes/0.9.0.md \
--macos-archive <MOffice-macos.tar.gz> --windows-archive <moffice-…windows….zip> --deb <MOffice-Install-linux-amd64.deb> \
--out target/feed-0.9.0deploy/publish-updates.sh target/feed-0.9.0- Сборщик берёт прежнюю ленту с сайта:
sequence= прежний + 1, версия не меньше опубликованной (иначе нужен--rollback --reason "…"),expires_unix— не дальше 90 дней (лента без новой публикации умирает через 90 дней — переподписывать хотя бы раз в 2 месяца). Пакетыapps-zipдо публикации распаковываются кодом клиента (moffice-update-tool inspect), каждый пакет ≤ 80 МБ. - На сервере:
/opt/projects/meridian-docs/updates/подключена в контейнерmeridian-docs;packages/<sha12>/…— неизменяемые пакеты,channels/<канал>/<sequence>/—latest.json,.sig,history.json(каждая запись хранит SHA-256 прежнегоlatest.json),SHA256SUMS, страница выпуска;<канал>— ссылка на текущую папку, переключается одной операцией. Публикатор проверяет всё с публичного адреса и пишет строку в/opt/CHANGELOG.md. - Откат — новой публикацией с большим
sequence; вернуть ссылку на старую папку бесполезно: клиент её не примет. - Установщики для первой установки (
/downloads/) лежат в/opt/projects/meridian-docs/store/downloads/, страницы — в образе;deploy/deploy-sagr.shдописывает новые файлы в хранилище и проверяет каждый файл каталога по SHA-256 с публичного адреса (scripts/check_catalog.py --online).
Отказы, которые проверяют тесты
cargo test -p meridian-net: подмена байта манифеста,
чужой ключ под тем же key_id, неизвестный
key_id, подпись без домена, мусор вместо подписи, старый
подписанный манифест (sequence), истёкший
expires_unix, чужой канал, http:// и чужой
хост пакета, подменённый пакет того же размера, отмена загрузки, файл
вне описи, путь ../, ссылка за пределы своего элемента,
версия описи ≠ версии манифеста, сбой посреди перестановки.