47 KiB
Прогон C этапа 3: план стендовой приёмки внешнего интерфейса и БД на целевом Linux
Составлен 17 ноября 2026 года только чтением репозитория и tmp/. VPS, CHR и Gitea не затрагивались: SSH, Docker, REST и скрипты, включая режимы --check, не запускались. Пункты плана взяты из плана завершения, раздел «Этап 3», абзац «Прогон C». Форма документа повторяет план прогона A.
Обозначения: [ист.: файл] означает, что факт прочитан в указанном файле; [вывод] означает вывод автора плана, на стенде он не проверен. Пароли, ключи и токены в документе отсутствуют намеренно.
Главный вывод. Из четырёх пунктов прогона C готовый пакет есть только у одного: сквозного прогона на образах CI2736. Но он привязан к образам с 56 миграциями, которые на VPS, скорее всего, отсутствуют, а сам пакет ни разу не запускался. Приёмка подписанного защищённого восстановления и DB-4 сводятся к одному новому Linux-пакету на основе локального сценария --owned-restore58-ready, в котором подделка POSIX-проверки заменена реальной. DB-3 в текущем продукте выполнить нельзя. Единственный реальный legacy-артефакт — дамп с 12 миграциями. Контролируемый путь миграций отказывает непомеченной базе с префиксом 0. Цепочка legacy-* требует ровно 36 миграций и доступна только через тестовые раннеры. Нужно решение владельца (D-C4). Пункт «восстановить SSH к VPS» выполнен: вход по ключу через алиас mm-vps под root [ист.: постановка задачи].
1. Цель и критерий «принято» по пунктам
Цель: за одну или две сессии на mm-vps закрыть пункты прогона C. Каждый пункт пишет отдельную квитанцию; failed и unknown не перекрашиваются [ист.: mcp-completion-plan.md, этап 3]. Все сценарии работают в собственных изолированных проектах Docker и не меняют mmapp-test. CHR не затрагиваются: ни один сценарий не использует реальный маршрутизатор [ист.: ci2736-owned-portal-browser/README.md, шаг 4: «No real router or provider account is used»].
| # | Пункт | «Принято» означает | Квитанции |
|---|---|---|---|
| C0 | EXTERNAL-UI: восстановить SSH к тестовому VPS | Выполнено до плана: ssh mm-vps по ключу под root работает. В плане остаётся только сверка отпечатка ключа хоста в шаге 1.1 |
Отметка в mcp-completion-plan.md (владелец или координатор) |
| C1 | EXTERNAL-UI: сквозной прогон на образах CI2736 (или преемнике по D-C1) | Четыре сервиса (Manager backend и frontend, Portal, PostgreSQL) подняты из образов, привязанных к OCI-дайджестам, в новом пустом проекте; число миграций в базе равно заявленному. Браузер Edge через три SSH-проброса создаёт синтетического владельца Portal. Он подтверждает и исполняет одно глобальное изменение настроек логов, открывает шаг операции и перезагружает его URL. Затем отключение в Portal даёт подписанное HTTPS-событие. Проверяются точный HTTP 401 без деталей операции, одна навигация на вход Portal, отсутствие старого шага, аудит подписанного отзыва и отказ установленному SDK. Раннер подтвердил очистку проекта и томов, прежние контейнеры не изменились | browser-result.json (неконфиденциальный), терминальная квитанция раннера. Сценарий: [ист.: ci2736-owned-portal-browser/README.md, шаги 1–6] |
| C2 | EXTERNAL-UI: приёмка подписанного защищённого восстановления | На целевом Linux, в собственном PostgreSQL 18 с TLS и пятью ролями (runtime, operator, capture, publisher, control), выполнена процедура «Подтверждённое восстановление с подписанным профилем source58». Утверждённые хеши архива и данных проходят через db:stage-restore-checkpoint, одноразовый допуск выдаётся через db:serve-restore-claims, одно восстановление доходит до applied-consumed. source-catalogue-inspect и upgrade (rebind) дают новую подписанную эпоху; затем выполняются db:seal-restore-checkpoint и db:complete-restore. Новый процесс отклоняется при consumed и до rebind; seal отклоняется до новой эпохи; запуск отклоняется до complete. После снятия карантина два новых процесса backend проходят штатный старт, и защищённая запись (PUT /api/logs/settings) возвращает новое значение. Подменённый архив отклоняется. Отличие от локальной приёмки: platformFilesVerified=true, то есть реальные POSIX-файлы вместо синтетического подтверждения. Плюс браузерная часть (по D-C8): само восстановление запускается из Edge (загрузка PGDMP, план с точным хешем, одно подтверждённое apply), как в принятой UI2-приёмке, но с заданными DATABASE_RESTORE_ARCHIVE_SHA256 и DATABASE_RESTORE_DATA_SHA256. Тогда служебный журнал database-maintenance.jsonl содержит записи с HMAC, и readMaintenanceRecoveryFacts(...).authenticated = true. Прежняя UI2-приёмка дала signedProtectedJournal:false, и передача прямо пишет, что «отдельная приёмка подписанного служебного журнала защищённого восстановления остаётся открытой» [ист.: tmp/mcp-ui2-restore-mounted-20261115/result-owned-Dt6pur.json; run.mjs:171–177; backend/src/services/database-maintenance-startup.ts:127–155; mcp-evidence-statistics-20261101.md, стр. 100] |
Новая квитанция по форме restore58-ready-verification.json с platformFilesVerified=true и fixtureSourceAttestor=false (если решено D-C3), плюс браузерная квитанция по форме result-owned-*.json с signedProtectedJournal:true, applySubmissions:1, automaticRetry:false. Процедура: [ист.: docs/mcp-database-maintenance.md, раздел «Подтверждённое восстановление…»]. Локальный образец и его ограничения: [ист.: tmp/mcp-writer-restore58-owned/restore58-ready-verification.json: platformFilesVerified:false, readyAuthorized:false, fixtureSourceAttestor:true] |
| C3 | DB-3: перенос непустой legacy-базы | По критерию DB-3: внутренний верификатор и операторская инспекция связаны с исходным поколением, подтверждённые записи переносятся под блокировками без фиктивных маркеров и MAC, остальные явно unresolved. Нужны положительное восстановление и отказ при подмене. Всё это на реальной непустой базе старой схемы, а не на тестовой fixture [ист.: mcp-remaining-work-20261026.md, таблица DB-1…DB-4]. Сейчас невыполнимо без решения D-C4, см. блокер CB5 |
Зависит от D-C4 |
| C4 | DB-4: настоящие POSIX-права целевой среды | На той же Linux-среде образов, что в C2: операторские файлы (bootstrap.json, signing-private.pem, транспорт, CA, журнал, каталоги активации и реестра) созданы с правами 0600 и 0700 от фактического UID процесса. Отрицательные случаи отказывают до подключения к БД: группа или остальные имеют доступ, чужой владелец, символьная ссылка, существующий каталог при init. Ключи и журнал не восстанавливают прежний действующий доступ; архив с объектами mmapp_control отвергается; ошибка или перезапуск не запускают потребителей [ист.: mcp-remaining-work-20261026.md, DB-4; mcp-db-offline-bootstrap.md, «Файлы и повторный запуск»; backend/src/services/database-dump-connection.ts, стр. 169–184] |
Квитанция пакета C2/C4 (общий прогон) с отдельным разделом posix, плюс вывод database-writer-bootstrap-operator.mjs init (только публичный отпечаток) |
2. Предусловия и решения владельца
2.1. Факты о стенде на 17 ноября
mm-vps: Debian 13, ядро 6.12, ОЗУ 2 ГиБ (доступно около 1,1 ГиБ), диск 25 ГБ (свободно около 11 ГБ), Docker 29.8.2. Установка/opt/mmapp-testна образахmcp-5ec95a7c(Gitea, запуск 2738). База обновлена с 12 до 57 миграций по legacy-пути, схемаmmapp_controlпуста. Дамп до обновления:/root/backups/mmapp-test-pre-mcp-20261116T032408Z.dump(46 МБ), копия.envв/root/backups[ист.: постановка задачи; mcp-completion-plan.md, журнал 2026-11-16].- 16 ноября на VPS удалены кэш сборки и неиспользуемые образы старше 7 дней [ист.: mcp-completion-plan.md, этап 3, D7 плана A]. Остались ли образы CI2736 и Portal CI2586, не проверялось [вывод: вероятно, удалены или никогда не загружались. Передача от 15.11 говорит «локально нет контейнерного runtime, последний строгий SSH BatchMode к тестовому VPS отклонил вход», ист.: mcp-handoff-20261115.md, строка Portal / EXTERNAL-UI].
- В базе
mmapp-testдва сервера: оба CHR прогона A [ист.: постановка задачи]. Значит, дамп до обновления тоже содержит эти серверы и их зашифрованные учётные данные [вывод]. - Образ backend не задаёт
USER, а composemmapp-testне задаётuser:. Значит, штатно backend работает отrootвнутри контейнера [вывод по backend/Dockerfile и deploy/docker-compose.test.yml; фактическое/opt/mmapp-test/docker-compose*.ymlне читалось]. - В образе backend есть только
backend/dist,backend/dist-operatorи производственные зависимости.tsx,srcиembedded-postgresотсутствуют [ист.: backend/Dockerfile]. Скриптыdb:*изpackage.jsonвызываютtsx src/scripts/…и в образе не запускаются. Скомпилированные аналоги ожидаются вdist/scripts/[вывод].
2.2. Блокеры, найденные в файлах
| # | Блокер | Где видно |
|---|---|---|
| CB1 | Пакет CI2736 привязан к старому снимку. binding.json: Manager a3bf3574… и Portal ef7bb79d… (CI2586), 56 миграций, runtimeRun:false; закреплены дайджесты четырёх образов в git.shx.one/…. Раннер «never pull images»: если кэша нет, подготовка останавливается. Текущий HEAD 5ec95a7c собран в CI2738 с 57 миграциями |
ci2736-owned-portal-browser/binding.json, README.md, runner.py:119–124 |
| CB2 | Локальные требования браузера. browser.mjs требует ровно Node v22.23.4 и Edge (channel: 'msedge') с закреплёнными зависимостями Playwright и SDK; проверяется assert.equal(process.version,'v22.23.4'). Наличие этой версии Node на Windows не проверялось |
browser.mjs:13, 78 |
| CB3 | Память. Лимиты compose CI2736: postgres 384 МиБ, backend 512 МиБ, frontend 160 МиБ, portal 256 МиБ, в сумме 1312 МиБ. Это больше доступных ~1,1 ГиБ при работающем mmapp-test (≈565 МБ). Прежний похожий прогон CI2678 v5 на том же VPS дал минимум 870 МиБ доступной памяти при меньшем наборе [ист.: mcp-current-progress.json, currentWholeInstallationPreviewLocalReview] |
compose.json |
| CB4 | Для C2 и C4 нет Linux-пакета. Локальный run-owned.mts --owned-restore58-ready использует EmbeddedPostgres, исходники через tsx и синтетическое подтверждение платформы (стр. 315–316: «Synthetic attestor for the Windows-only integration; no POSIX/source registry acceptance»). Режим --owned-linux-cli есть, но требует Linux, Node 22 и непривилегированного пользователя (getuid()>0, стр. 61). Он описан как «Local evidence builder against a disposable database and synthetic signing key» |
tmp/mcp-writer-restore58-owned/run-owned.mts, стр. 1–5, 56–61, 315; tmp/mcp-writer-current57-local-tls/run-owned.mts |
| CB5 | DB-3: продуктового пути для реальной legacy-базы нет [вывод из кода]. (1) executeControlledSqlMigrations вызывается только тестовым legacy-probe-handoff-execute-owned.mjs; штатный старт (bootstrap.ts) использует legacy applySqlMigrations. (2) На пустой контрольной истории baseline(prefix 0) отказывает при любых объектах public: «Legacy or unmarked application state cannot be enrolled». (3) Цепочка legacy-handoff-* требует истории ровно 36 миграций (exactHistory(...) !== 36). Довести базу до 36 умеет только тестовая applyLegacyProbeFixtureMigrations, которая «Never imported by application startup; no caller-selected migration ceiling». (4) Реальный артефакт — дамп с 12 миграциями, а таблицы журнала проб (0035, 0036), которые переносит цепочка 0037, в нём отсутствуют [вывод: миграции 0035–0036 позже 0012]. Значит, при любом пути журнал проб пуст, и «подтверждённых записей» для переноса нет. (5) Сама установка mmapp-test уже обновлена до 57 по legacy-пути и тоже не может войти в контролируемый путь (та же причина (2)). Владелец уже принял пункт (2) этапа 2: существующая БД с маркерами и без контрольной истории контролируемым путём не принимается, «это уже открытый пункт DB-3 про перенос непустой legacy-БД» [ист.: mcp-completion-plan.md, стр. 23, вывод (5)] |
backend/src/db/controlled-migrations.ts:47–53, 75–105; controlled-migration-history.ts:8–12; database-schema-control.ts:64; legacy-probe-fixture.ts:7–15; db/bootstrap.ts:62 |
| CB6 | Цепочка подписанного профиля требует многих операторских входов. Ключи init с утверждённым запросом и хешем, пять ролей с OID, TLS (CA, SPKI), реестр источника, каталог активации, утверждённые определения и одобрения application-writer-upgrade57-to58-approval-v1 и …rebind58-after-restore-approval-v1. В локальном сценарии их выпускает тестовая fixture с синтетическим ключом. На стенде нужен выпуск теми же командами dist-operator, но с реальными файлами |
docs/mcp-database-maintenance.md, стр. 76–85; docs/mcp-db-offline-bootstrap.md; docs/mcp-db-connected-publisher.md |
| CB7 | Дамп содержит действующие CHR. Если на восстановленной копии запустить backend с планировщиком, он начнёт опрашивать CHR1 и CHR2 и помешает прогону A [вывод] | Факт о двух серверах (2.1) |
2.3. Решения владельца (чек-лист)
-
D-C1. Какие образы для C1. (а) Буквально CI2736:
a3bf3574, 56 миграций, Portal CI2586. Нужно загрузить четыре образа по дайджесту изgit.shx.one, если реестр их ещё хранит. (б) Перепривязать тот же пакет к образам CI2738 (HEAD5ec95a7c, 57 миграций). Backend и frontend уже есть на VPS; Portal взять по дайджесту установленногоmmapp-test-portalили CI2586. Меняютсяbinding.json,migrationCountи пины, сценарий браузера остаётся прежним. Рекомендация: (б). Приёмка нужна на финальном кандидате, а CI2736 уже устарел на одну миграцию и ряд исправлений. Решение меняет формулировку критерия, поэтому оно за владельцем. Если владелец выберет (а), загрузка образов — отдельный MUTATING-шаг с обращением к Gitea (шаг 1.4). -
D-C2. Память на время C1 и C2. (а) Остановить
mmapp-test(docker compose stop) на время каждого окна C и поднять после. (б) Не останавливать и принять риск OOM. Рекомендация: (а), с окном вне фаз прогона A, которые используют приложение на VPS, и вне прогона B (B закрепляетpidконтейнеровmmapp-test, см. план B, BB7). Откат:docker compose up -dв/opt/mmapp-testи сверка четырёх сервисов как в 1.2. -
D-C3. Каким путём выполнять C2 и C4. (а) Перенести
run-owned.mts --owned-restore58-readyв Linux-пакет по образцу пакетов POLL: локальная компиляция в JS, загрузка, запуск в образе backend установки от UID65534. ВместоEmbeddedPostgresиспользовать собственный контейнер PostgreSQL 18 с TLS, а синтетическое подтверждение платформы заменить реальной проверкой POSIX-метаданных. (б) Оркестровать производственные команды образа (dist-operator,dist/scripts/*) против собственного проекта compose. Рекомендация: (а) как основной путь, (б) как необязательное дополнение. Путь (а) повторяет уже принятый локальный сценарий и меняет только платформу, путь (б) потребует новый драйвер всей цепочки. Что (а) использует тестовую обвязку, а операторские команды остаются производственными, фиксируется в квитанции [вывод]. -
D-C4. DB-3. Варианты [вывод]:
- (а) Признать, что текущий продукт не переносит legacy-базы старше 0036 по контролируемому пути. Записать DB-3 в этап 4 как ограничение: legacy-база обновляется прежним путём, контрольная история начинается пустой.
- (б) Продуктовая доработка новым слоем: операторская команда, которая под блокировкой записей и с аттестацией исходного поколения поднимает реальную legacy-базу с N < 36 до 36 с проверкой маркеров, затем выполняет существующую цепочку
legacy-*и контролируемый хвост 0038–0057. Затем приёмка на копии реального дампа (12 миграций) в собственном PostgreSQL на VPS. Нужны две продуктовые части: (1) шаг N → 36 и (2) производственная точка входа для хвоста 0038–0057. СейчасexecuteControlledSqlMigrationsвызывается только тестовым раннером, а в списке командdist-operatorкоманды миграции нет [ист.: backend/scripts/build-database-operator.test.mjs:84 — перечень команд; controlled-migrations.ts:75]. - (в) Принять DB-3 по существующей цепочке
legacy-*на тестовой 36-миграционной fixture, но на целевом Linux с реальными POSIX-файлами. Это не «реальная» legacy-база.
Рекомендация: (б), если владелец считает перенос старых установок обязательным для релиза, иначе (а). Вариант (в) не выполняет критерий «реальный исторический артефакт» [ист.: mcp-db-remaining-blocks-20261031.md, «Источник, архив и legacy»]. При (б) нужно учесть: журнал проб в этом дампе пуст [вывод, CB5(4)], поэтому «подтверждённых записей» будет 0, а перенос проверяется на остальных данных (серверы, настройки, история). Решение меняет критерий и поведение продукта, это вопрос владельцу.
-
D-C5. Обращение с дампом
mmapp-test. Рекомендация: использовать его только на VPS. Копию восстанавливать в собственный PostgreSQL во внутренней сети Docker без выхода наружу (internal: true). Backend на копии не запускать, либо запускать без планировщика и без маршрута к CHR (CB7). Дамп с VPS не выносить, содержимое строк не печатать; после шага копия удаляется. Нужна только при D-C4 = (б). -
D-C6. Кто подтверждает в Portal и Manager. Рекомендация: агент по D8 прогона A. Учётные записи синтетические (
@example.test), их генерируетrunner.py --make-fixture[ист.: README.md, шаг 2]. -
D-C8. Что считать «приёмкой подписанного защищённого восстановления». (а) Только операторская цепочка
source58до READY (CLI). (б) Цепочка плюс запуск самого восстановления из Edge через UI/MCP с подписанным служебным журналом (signedProtectedJournal:true). Рекомендация: (б). Пункт стоит в разделе EXTERNAL-UI, а открытым остался именно подписанный журнал браузерного восстановления (стр. 100 реестра доказательств). Браузер работает через SSH-проброс к собственному стеку C2, как в C1. Харнессtmp/mcp-ui2-restore-mounted-20261115/run.mjsлокальный (remoteExecuted:false), его нужно перенести на проброшенные порты. -
D-C7. Кто выпускает операторские одобрения C2 и C4 (
approved-request.jsonи его SHA-256, одобрения upgrade и rebind). Рекомендация: агент выпускает их тестовым ключом этого прогона, ключ создаётся и уничтожается внутри собственного каталога. В квитанции указывается, что независимость утверждающего не проверялась.
3. Порядок шагов
Фаза 0 стенд не затрагивает. Для каждого стендового шага указаны режим (READ-ONLY или MUTATING) и откат. Пути ниже относительно tmp/, если не сказано иное.
Что переиспользуется
| Артефакт | Как есть? | Что адаптировать |
|---|---|---|
mcp-current-preview-local-review-20261111/ci2736-owned-portal-browser/ (runner.py, browser.mjs, compose.json, tls-forwarder.mjs, bind.py) + архив .zip |
При D-C1 = (а) да, если образы в кэше. Транспорт уже на SSH-сессии оператора, пароля в раннере нет | При (б): новый binding.json (дайджесты CI2738 и Portal, migrationCount=57), пересчёт assets и offline-verification.json, повторная офлайн-проверка. Локально Node v22.23.4 |
verified-ci2736-manager-portal-pair/ (OCI-квитанции, preview-ci-status.json) |
Только как доказательство происхождения CI2736 | При (б) аналогичная сверка OCI для CI2738 (запуск 2738 уже успешен, ист.: план A, D6) |
mcp-writer-restore58-owned/run-owned.mts (--owned-restore58-ready) и mcp-writer-current57-local-tls/run-owned.mts (--owned-linux-cli) |
Нет | База для пакета C2/C4 (D-C3 (а)): убрать синтетический attestor, заменить EmbeddedPostgres на собственный PG-контейнер с TLS, скомпилировать, упаковать |
mcp-linux-maintenance-v2-20261103/ (Linux-прогон maintenance-inspect/resolve, 16 сценариев, nativePosixProtection:true) |
Нет (44 миграции) | Образец Linux-пакета с реальной POSIX-защитой, loopback и TLS [ист.: docs/mcp-linux-maintenance-resolution-acceptance-20261103.json] |
Пакеты POLL (cold_docker.py, durable.py) |
Нет | Образец запуска собственного Node в образе backend установки от 65534:65534 с собственным PG-контейнером и меткой nonce |
backend/scripts/legacy-probe-*-owned.mjs, source5{7,8}-*-owned.mjs |
Нет: тестовые раннеры на fixture | Только для D-C4 (в) или как образец драйвера для (б) |
Фаза 0. Локальная адаптация (без стенда, до сессии)
| Шаг | Действие | Закрывает |
|---|---|---|
| 0.1 | Получить решения D-C1…D-C8. При D-C8 (б) перенести tmp/mcp-ui2-restore-mounted-20261115/{run.mjs,browser.mjs} на проброшенные порты собственного стека C2 с заданными хешами архива и данных |
— |
| 0.2 | C1: при D-C1 = (б) перепривязать пакет (bind.py) к CI2738 и Portal, прогнать офлайн-проверку (runner.py --check локально не исполняет Docker). Проверить node --version = v22.23.4 и наличие Edge и зависимостей browser.mjs |
CB1, CB2 |
| 0.3 | C2/C4: Linux-пакет по D-C3 (а). Владелец процесса — UID 65534. Создаются каталоги 0700 и файлы 0600, затем проверяются отрицательные случаи (0640, 0604, чужой UID, символьная ссылка, существующий каталог init) и отказ до подключения к БД. Собственный контейнер PG 18 с TLS (самоподписанный серверный сертификат без права CA, по mcp-database-maintenance.md), пять ролей. Два процесса backend для старта после complete |
CB4, CB6 |
| 0.4 | C2/C4: дополнительные проверки DB-4 в пакете: архив с объектами mmapp_control отвергается; повторный старт после ошибки посреди восстановления не запускает потребителей (планировщик, NetFlow, MCP) до complete; ключи и журнал из архива не возвращают прежний доступ. Офлайн-тесты пакета и печать хешей |
DB-4 |
| 0.5 | Локальный прогон пакета C2/C4 в Linux-контейнере невозможен (на Windows нет контейнерного runtime [ист.: mcp-handoff-20261115.md]). Поэтому до стенда проверить только --owned-restore58-ready на Windows на HEAD (регрессия) и офлайн-тесты пакета |
— |
| 0.6 | DB-3: только по решению D-C4. При (б) — продуктовая работа отдельным слоем с тестами на fixture N=12, после неё отдельный пакет приёмки | CB5 |
Фаза 1. Предпусковая проверка и базовый снимок (≈20 мин)
| Шаг | Режим | Команда или действие | Откат |
|---|---|---|---|
| 1.1 | READ-ONLY | Отпечаток ключа хоста VPS, как в плане B 1.1 | — |
| 1.2 | READ-ONLY | `free -m; df -h /; cat /proc/vmstat | grep -E 'pswp |
| 1.3 | READ-ONLY | docker image inspect <ref@digest> для каждого из четырёх образов C1 (по D-C1); docker image inspect образа mmapp-test-postgres (PG_MAJOR); docker exec mmapp-test-backend id (фактический UID); ss -ltn на 55173–55175 свободны |
— |
| 1.4 | MUTATING (только если 1.3 нашёл отсутствие образов и D-C1 = (а)) | docker pull по дайджесту из git.shx.one (нужен вход в реестр на VPS, отдельное разрешение: скачивание около 0,5–1 ГБ). Срок хранения образов в реестре не проверялся |
docker image rm <digest> после прогона, если владелец не решит оставить |
| 1.5 | MUTATING (по D-C2) | cd /opt/mmapp-test && docker compose stop. Перед этим записать docker compose ps и .env SHA-256 (без вывода значений) |
docker compose up -d, проверка четырёх сервисов healthy |
Фаза 2. C1: сквозной прогон на образах (≈30–45 мин; жёсткий предел раннера 360 с на браузерную часть [ист.: runner.py:23])
| Шаг | Режим | Команда | Откат |
|---|---|---|---|
| 2.1 | MUTATING (VPS: новый приватный каталог загрузки) | Загрузить пакет (scp) и сверить хеш архива на обоих концах, извлечь только перечисленные файлы. python runner.py --check на VPS (Docker не вызывается) |
Удалить каталог загрузки |
| 2.2 | локально | python runner.py --make-fixture <новый приватный файл>. Передать его на VPS, chmod 0600. Локальную копию хранить до конца браузерной части |
Удалить оба файла после 2.5 |
| 2.3 | MUTATING (VPS: проект mm-mcp-owned-<id>, четыре контейнера, тома, сеть, порты 127.0.0.1:55173–55175) |
В SSH-сессии с тремя пробросами (-L 55173:127.0.0.1:55173 и т. д., StrictHostKeyChecking=yes, ExitOnForwardFailure=yes): python runner.py --run <fixture>. Раннер генерирует собственный CA на сутки, сверяет imageIds с запущенными контейнерами и проверяет migration_count. Затем печатает browser-ready |
Раннер сам очищает проект и тома при таймауте или сигнале TERM/HUP. При отказе очистки остаётся точный путь для ограниченного восстановления |
| 2.4 | локально (браузер) | node browser.mjs <локальная fixture> <новый browser-result.json> |
— |
| 2.5 | MUTATING (VPS: удаление собственного проекта) | Атомарно загрузить browser-result.json (и квитанцию отказа, если есть) в каталог выполнения. Раннер проверяет поля, удаляет проект и тома, сверяет ID и время старта ранее работавших контейнеров |
Повторная проверка 5.2 |
| 2.6 | локально | Закрыть пробросы, удалить загруженный пакет и fixture на VPS после проверки владельца, удалить локальную fixture. Сохранить неконфиденциальные квитанции | — |
Фаза 3. C2 + C4: подписанное защищённое восстановление и POSIX (≈60–90 мин [вывод])
| Шаг | Режим | Команда | Откат |
|---|---|---|---|
| 3.1 | MUTATING (VPS: каталог /var/lib/mm-restore58-<nonce> с владельцем 65534, права 0700) |
Загрузка пакета 0.3 и сверка хешей | Удаление каталога по nonce |
| 3.2 | MUTATING (VPS: собственный контейнер PG 18 с TLS во внутренней сети, том) | Старт PG. Пять ролей, bootstrap init от UID 65534 (создаёт signing-private.pem, operator-public.pem, bootstrap.json с правами 0600). В вывод попадает только публичный отпечаток |
Удаление контейнера и тома по метке nonce |
| 3.3 | MUTATING | Отрицательные POSIX-проверки C4: каждая запускается на отдельной копии входа и отказывает до подключения к БД (счётчик соединений 0, как в build-database-operator.test.mjs) |
— |
| 3.4 | MUTATING | Цепочка C2 по mcp-database-maintenance.md, шаги 1–4: archive + data SHA-256 → stage-restore-checkpoint → serve-restore-claims → одно восстановление (по D-C8 (б) — из Edge через проброс: загрузка PGDMP, план, одно apply; затем проверка signedProtectedJournal) → inspect-restore-checkpoint (applied-consumed) → source-catalogue-inspect → upgrade (rebind) → seal → complete → два процесса backend → PUT /api/logs/settings. Отрицательные: новый процесс при consumed, seal до rebind, старт до complete, подменённый архив, архив с mmapp_control |
Неопределённый ответ на любом шаге: только inspect-restore-checkpoint и maintenance-inspect, без повтора действия [ист.: mcp-database-maintenance.md, «Не повторяйте прежнее действие автоматически»] |
| 3.5 | MUTATING (VPS: удаление собственных ресурсов) | Остановить процессы, удалить контейнеры, тома, сеть, каталог nonce. Ключ теста уничтожается вместе с каталогом | Сверка 5.2 |
Фаза 4. C3: DB-3 (только по решению D-C4)
| Вариант | Шаги |
|---|---|
| (а) ограничение | Без стенда. Запись в mcp-completion-plan.md этапа 4 и в манифест этапа 5 |
| (б) доработка | 4.1 READ-ONLY: pg_restore --list дампа на VPS (без вывода данных), сверка числа маркеров schema_migrations = 12 в восстановленной копии. 4.2 MUTATING: собственный PG 18 во внутренней сети, pg_restore дампа в него (D-C5). 4.3 MUTATING: новая операторская команда из 0.6 → цепочка legacy-export … legacy-handoff-release → контролируемый хвост → legacy-control-reference → legacy-source58-preflight. 4.4 MUTATING: отказ при подмене архива и при конкурирующем писателе. 4.5 MUTATING: удаление копии, тома и каталога. Backend на копии не запускать (CB7) |
| (в) fixture на Linux | Как (б), но источником служит applyLegacyProbeFixtureMigrations в собственном PG. В квитанции явно realLegacyArtifact=false |
Фаза 5. Завершающая сверка (≈15 мин)
| Шаг | Режим | Действие |
|---|---|---|
| 5.1 | MUTATING (только если делали 1.5) | cd /opt/mmapp-test && docker compose up -d, ожидание healthy |
| 5.2 | READ-ONLY | Повтор 1.2: четыре контейнера mmapp-test работают на тех же образах. Если делали 1.5, pid новые, это ожидаемо и записывается. Собственных проектов, томов, сетей и каталогов нет. Свободное место и память вернулись к базовым |
| 5.3 | READ-ONLY | docker image ls — образы, загруженные в 1.4, удалены или оставлены по решению владельца |
4. Базовый снимок до прогона и сверка после
- Что снимается. Четыре контейнера
mmapp-test(id,image,pid,StartedAt),docker volume ls,docker network ls,docker image ls --digests,free -m,df -h,/proc/vmstat(swap, OOM), SHA-256 файла/opt/mmapp-test/.env(без вывода), список/var/lib/mm-*. - Когда. В шаге 1.2 до первой MUTATING-операции. Повторно в 5.2.
- Критерий. Нет собственных ресурсов,
mmapp-testработает на тех же образах и с тем же.env. Еслиmmapp-testостанавливали (D-C2), отличаются толькоpidиStartedAt. Раннер C1 сам проверяет ID и время старта ранее работавших контейнеров (runner.py, стр. 90–93), поэтому остановка по D-C2 делается до снятия его эталона, то есть до 2.3. - CHR. Не затрагиваются; базовый снимок CHR не снимается. Копия дампа (только D-C4 (б)) работает во внутренней сети без маршрута к CHR.
5. Риски, условия остановки и откат
Остановить прогон немедленно, если:
- Идёт прогон B или фаза 5 прогона A (общий VPS; B закрепляет
pidmmapp-test). MemAvailable< 500 МиБ или OOM у любого контейнера [вывод].- Ответ на любой шаг восстановления потерян. Дальше только инспекция, без повтора.
- Любой контейнер
mmapp-testизменился без шага 1.5. - Ключ хоста VPS не совпал.
Откат: собственные проекты и тома удаляются по меткам и nonce. Если mmapp-test останавливали, он поднимается через docker compose up -d. Прод-база mmapp-test-postgres в прогоне C не изменяется ни на одном шаге: восстановление в неё запрещено. Дамп /root/backups/…dump используется только на чтение.
Прочие риски [вывод]:
- Образы CI2736 могли не сохраниться в реестре Gitea, тогда D-C1 (а) невыполним.
- Браузер работает с Windows через три SSH-проброса. Обрыв сети оставляет раннер до таймаута 360 с; раннер очищает сам.
--owned-linux-cliи пакет C2/C4 ни разу не запускались на Linux. Первая сессия, вероятно, выявит дефекты пакета. По цели владельца это разбирается и повторяется с новым nonce.- Backend штатно работает от
root. Проверка POSIX от UID 65534 доказывает поведение кода, но не текущую конфигурацию установки. Нужно ли менятьuser:в compose, решает отдельный пункт (раздел 7).
6. Оценка длительности [вывод]
- Фаза 0: 1–2 рабочих дня (пакет C2/C4 — критический путь). DB-3 (б) — отдельная продуктовая работа, ещё 2–4 дня.
- Стендовая сессия: фаза 1 ~20 мин, C1 30–45 мин, C2 + C4 60–90 мин, фаза 5 ~15 мин. Итого 2–3 ч без DB-3. С DB-3 (б) — ещё 1–1,5 ч, можно отдельной сессией.
- Запас на одну остановку и повтор: +1–2 ч.
7. Что этим планом не проверяется
- RAM-1: вся установка ≤2 ГиБ (отложено владельцем). Если
mmapp-testостанавливается на время окна, совместная нагрузка не измеряется. - Настоящий внешний Portal владельца и реальные учётные записи: используются синтетические
@example.testи собственный Portal. - Изменение конфигурации действующей установки
mmapp-testна подписанный профиль (source57/58, пять ролей, TLS). Установка остаётся на legacy-пути с пустойmmapp_control(CB5(5)). Это вопрос включения (этап 5, инструкция), а не прогона C. - Работа backend установки от непривилегированного пользователя: в продукте сейчас
root. - Устойчивость файлов к сбою питания (
fsyncпроверяется, отключение питания нет [ист.: mcp-db-offline-bootstrap.md]). - UI-1 в полном объёме: выдача ограниченного доступа, отказы, фильтры, пагинация. Сценарий C1 покрывает один поток подтверждения и отзыв.
- Причины прежних отказов CI2678 v5 (
real-logs-flow-sse, 429 на flow): сценарий C1 потоки логов и flow не открывает.