Files
MikrotikManager/docs/mcp-db-connected-publisher.md
T

64 KiB
Raw Blame History

Операторская публикация политики записи БД

Добавлена отдельная команда backend/scripts/database-writer-profile-operator.mts. Она проверяет закреплённые сведения установки, подключается отдельным TLS Pool с одним соединением, проверяет источник и пять ролей, сверяет текущий каталог с независимо утверждённой политикой, подписывает policy/head и публикует их через history и CAS.

Это отдельный операторский процесс. Приложение его не импортирует и автоматически не запускает. Команда не создаёт роли или таблицы, не выдаёт grants, не включает режим записи приложения и не даёт READY. Предварительно нужны доверенное provisioning, защищённые файлы установки, существующий source registry и независимо утверждённые входы.

Состояние приёмки: Linux current44/default117 функционально принят: SQL genesis/renewal/CAS-отказ, TLS/SPKI и защищённые POSIX-файлы. Общая ресурсная/RAM-приёмка отказала; unknown-COMMIT SQL reconcile не проверен. Настоящий bootstrap и publisher main вызваны из фикстуры; production/startup/READY не активированы. В Windows команда отказывает до подключения из-за отсутствия native ACL backend. Изменение admission для просроченного reconcile проверено локально и не означает новую SQL-приёмку.

Вызов

В операторском checkout с установленными зависимостями backend и tsx:

node --import tsx backend/scripts/database-writer-profile-operator.mts publish --bootstrap ABS_FILE --bootstrap-sha256 APPROVED_SHA --approval ABS_FILE --approval-sha256 APPROVED_SHA --definition ABS_FILE --definition-sha256 APPROVED_SHA --transport ABS_FILE --transport-sha256 APPROVED_SHA --ca ABS_FILE --source-registry ABS_DIRECTORY --source-spki-sha256 APPROVED_SHA --journal ABS_EXISTING_PRIVATE_DIRECTORY --activation-directory ABS_ACTIVE_SOURCE_DIRECTORY --activation-sha256 APPROVED_ACTIVATION_SHA

publish и upgrade требуют утверждённый SHA-256 активной записи источника. Каталог активации и журнал публикации должны быть разными. Блокировка активации удерживается до закрытия TLS-пула. Отозванная, заменённая или занятая активация останавливает команду до открытия соединения.

Для reconcile уберите --activation-directory и --activation-sha256. SQL-инспекция использует READ ONLY и доступна после отзыва активации. Исходный защищённый approval может быть просрочен. Приватный signing-private.pem для reconcile не требуется. Команда создаёт блокировку журнала и удаляет pending cursor после подтверждённой классификации. При неизвестном результате COMMIT используйте reconcile с исходным журналом и одобрением. При подтверждённом COMMIT поздний сбой проверки активации сохраняет результат committed с cleanupUnconfirmed.

Локальные проверки Node 22 подтвердили обязательные параметры публикации, отказ до открытия пула, блокировку одновременного отзыва, сохранение committed при позднем сбое и сборку отдельного оператора. Сквозная проверка этой версии CLI с POSIX-файлами и PostgreSQL/TLS остаётся открытой.

Все имена файлов и каталогов абсолютные, канонические, без перенаправления symlink. Используются защищённые POSIX-каталоги текущего владельца без доступа группы и остальных пользователей и обычные приватные файлы. SHA256 поступают из отдельного утверждения оператором; команда не объявляет найденные на сервере значения доверенными.

Входы

Вход Назначение
bootstrap Результат offline init, отдельно проверенный и закреплённый оператором. Для publish приватный ключ — соседний signing-private.pem; его публичный отпечаток должен совпасть с утверждённым. Для reconcile ключ не нужен
approval Точное утверждение policy: format, manifest/definition/catalog SHA256, ожидаемый writer head, срок действия и срок самого допуска
definition Точные format, provenance, template встроенного build56 для текущей сборки. Build44 принимается для исторического reconcile. Снимок наблюдаемой БД вместо них не принимается
transport Только host, port, user, password, database. Host, пользователь publisher и database сверяются с утверждённым bootstrap
ca CA-файл, хеш которого закреплён в bootstrap; также проверяются имя сервера и SPKI его сертификата
source-registry Существующий независимо подписанный реестр источника БД; его signing SPKI закреплён отдельным параметром
journal Существующий приватный каталог предложений и pending-publication.json; автоматического создания или удаления чужих записей нет

--definition-sha256 закрепляет байты входного файла, а approval.definitionSha256 — канонический digest встроенного шаблона. sourceHeadSha256 в bootstrap относится к подписанному source registry. approval.expectedHeadSha256 выбирает текущую запись writer policy, с null для genesis пустого реестра. manifestSha256 закрепляет штатный migration manifest.

Поле approval.format равно application-writer-publication-approval-v1; остальные поля: manifestSha256, definitionSha256, catalogSha256, expectedHeadSha256, validityMs, expiresAt. Допуск должен оставаться действующим при подготовке и перед публикацией. catalogSha256 заранее утверждается как канонический digest {base: catalogueDigest, security: registryStructureDigest}; сама команда не заполняет его из наблюдаемого каталога.

Границы и результаты

Пять имён и OID ролей берутся из утверждённого bootstrap. Используется retained backend и лимит сессии 120 секунд, SQL statement 10 секунд, lock 5 секунд. Постраничный читатель проверяет полное EOF до и после подготовки. Для build56 проверены 110 базовых отношений и 117 листьев на одноразовой PostgreSQL 18. Отдельные сценарии подтвердили отказ при недостающем праве на колонку и при лишнем праве на таблицу. Приёмку полного цикла публикации 56 через TLS и защищённые файлы, переход существующей writer policy 44 → 56 и нагрузку до 3000 листьев ещё предстоит выполнить. Локальный результат.

Адрес подключения не берётся из .env или URL приложения. Настройки startup заданы непустой фиксированной строкой, чтобы PGOPTIONS не подменял их. Выбор native-драйвера запрещён: используется проверенный JS TLS-путь.

Одна команда удерживает эксклюзивный publisher-lease.lock на весь цикл publish/reconcile, включая очистку после подтверждённого COMMIT. Существующая lease запрещает запуск; PID и возраст файла не дают права автоматически удалять её. После аварии оператор должен сначала проверить исходный процесс и состояние публикации. Точные inode/device сравниваются как BigInt. Три POSIX-теста этой защиты прошли в настоящем Linux-прогоне; текущая функциональная публикация SQL принята отдельно по ссылке выше, общая ресурсная приёмка отказала. Это не проверка неизвестного SQL COMMIT.

До SQL-записи синхронно сохраняются proposal и pending cursor без перезаписи существующих файлов. При неизвестном COMMIT соединение уничтожается, pending сохраняется; автоматического replay нет. Подтверждённый COMMIT остаётся подтверждённым даже при поздней ошибке очистки. Квитанция сообщает cleanupUnconfirmed и journalUnconfirmed; код выхода 2 требует проверки этих состояний. Само наличие файла не является доказательством успешной публикации или устойчивости к сбою питания.

В stdout не выводятся пароль, приватный ключ или SQL. generationAuthenticated и readyAuthorized остаются false при любом успешном исходе этой команды.

Целевые проверки:

node --import tsx --test backend/scripts/database-writer-profile-operator.test.mts

Предварительная проверка текущего профиля

Действие preflight принимает базовые параметры публикации. Чтобы дополнительно сверить активное поколение источника, используйте source-preflight с обоими параметрами активации.

legacy-inspect читает четыре таблицы старого журнала диагностик в одном REPEATABLE READ READ ONLY после проверки TLS и активной привязки источника. Требуется точный набор отметок миграций по 0036 включительно. Для команды передайте --bootstrap, --bootstrap-sha256, --transport, --transport-sha256, --ca, --source-registry, --source-spki-sha256, --activation-directory и --activation-sha256. Учётной записи publisher требуется SELECT на schema_migrations и четыре таблицы legacy, а также штатный доступ для проверки источника. Результат содержит число строк и хеши снимка вместе с идентификаторами активной привязки. При общем количестве свыше 10 000 строк команда завершает проверку отказом. Проверка происхождения записей и разрешение конвертации остаются отдельными этапами.

Внутренняя проверка inspectLegacyServerProbeSource принимает ожидаемый хеш снимка из операторского запуска. Она сверяет состояние четырёх таблиц в той же транзакции, где проверяет старые квитанции и исходные записи MCP. При изменении хеша или неполной классификации проверка завершается отказом. Для установления исторического происхождения по-прежнему требуется независимая привязка к исходному поколению и архиву.

Внутренней проверке также можно передать архив, публичный ключ и подписанное заявление legacy-probe-archive-approval-v1. Закреплённый реестр исходного поколения передаётся оператором отдельно. Тело заявления связывает installationId, sourceIdentityId, generation, ordinal, headSha256, bindingSha256, archiveSha256 и storageSha256. Подпись Ed25519 вычисляется над строкой mmapp:legacy-probe-archive-approval:ed25519:v1, переводом строки и каноническим JSON тела. Конверт {body,signature} хранится в каноническом JSON с завершающим переводом строки, подпись кодируется base64url без дополнения. Проверка сверяет подпись с ключом реестра, обе подписанные записи реестра, фактические байты архива и хеш текущего снимка. Результат подтверждает заявление подписавшего оператора. Доказательство исторического происхождения самих записей, проверка восстановления и допуск к конвертации остаются отдельными этапами.

legacy-export принимает параметры legacy-inspect, а также --archive-directory и --source-signing-key. Передайте пустой каталог с правами 0700 и закрытый ключ Ed25519 исходного реестра с правами 0600. Оба пути должны быть абсолютными, с защищёнными POSIX-каталогами и без символических ссылок. Ключ хранится вне runtime. Команде нужен pg_dump в PATH, совместимый с PostgreSQL 18.

Экспорт использует тот же удерживаемый REPEATABLE READ READ ONLY снимок для хеша таблиц и pg_dump --snapshot. Дочерний процесс подключается от имени publisher. Во временном закрытом service file verify-full использует как единственный корень доверия самоподписанный сертификат удерживаемого TLS-сеанса с CA:FALSE. Команда проверяет имя сервера и SPKI удерживаемого сеанса, повторяет проверку активного источника после завершения pg_dump и требует успешного завершения транзакции. В архив попадают данные ровно четырёх диагностических таблиц. Параметры pg_dump · Параметры libpq.

Успешный запуск выдаёт legacy-probe.dump и legacy-probe-approval.json. Подписанное заявление публикуется последним. При прерванном запуске проверьте оба файла и подпись по независимо закреплённому исходному реестру. Для нового запуска подготовьте отдельный пустой каталог. При восстановлении нужна совместимая pre-0037 схема с относящимися к строкам исходными записями MCP и ключевым материалом для проверки старых квитанций. Хеш снимка связывает все четыре таблицы, включая записи с неустановленным происхождением. Допуск к конвертации и READY проверяются отдельными этапами.

Для фиксации операций MCP вместе с архивом используйте legacy-custody с теми же параметрами. До первой выборки команда берёт SHARE MODE NOWAIT на четыре таблицы диагностики, schema_migrations, mcp_operations, mcp_plans, mcp_connections и mcp_operation_steps. Для этих блокировок существующей роли publisher нужны права MAINTAIN на перечисленные отношения и SELECT на нужные данные. Конфликтующая запись завершает экспорт отказом. Пара файлов получает подписанный формат legacy-probe-custody-approval-v1, который дополнительно фиксирует хеш строк, связанных с исходными ID операций. inspectLegacyServerProbeSource сверяет оба хеша на снимке, где проверяет квитанции, и сохраняет результат проверки каждой группы в счётчиках. Дамп сохраняет все четыре таблицы целиком. Он по-прежнему требует исходных строк MCP и ключей для криптографической проверки после восстановления. Команда оставляет исходную БД на схеме 0036 и не выдаёт допуск к работе журнала v2. Блокировки PostgreSQL.

legacy-handoff-inspect сверяет исход перехода при сохранённом карантине. Передайте параметры legacy-inspect, а также --archive-directory и --handoff-intent-sha256. В защищённом каталоге должны находиться legacy-probe.dump, legacy-probe-approval.json формата custody, полный legacy-probe-cold.dump и legacy-probe-handoff-intent.json. Для чтения HMAC-квитанций 1–36 нужен исходный ключ оператора в MCP_STATE_DIR с доступом только на чтение. Роли publisher нужны права SELECT на таблицы контроля database_restore_quarantine, database_schema_state, database_schema_intents и на таблицы, которые сверяются для исходного либо целевого состояния.

Подписанный legacy-probe-0037-handoff-intent-v1 связывает полное xid8 из удерживаемой пишущей транзакции, UUID карантина, точный SHA-256 исходного заявления, холодного архива и ожидаемых схем 0036/0037, отпечатки общего manifest и файла 0037. Издатель исходного реестра подписывает каноническое тело Ed25519 в домене mmapp:legacy-probe-0037-handoff:ed25519:v1. Текущий execute включает в intent SHA-256 исходного подписанного разрешения на исполнение и холодной квитанции.

Внутренний publishLegacyHandoffIntent принимает эти подписанные байты до изменения прикладных строк. Он проверяет TLS владельца, исходный реестр, xid8, эксклюзивные блокировки и хеш исходных данных, публикует файл без перезаписи и сверяет его SHA-256. Отдельная контрольная транзакция подтверждает 36 HMAC-квитанций и ещё раз связывает тот же backend и блокировки. Она одной фиксацией записывает UUID карантина и ожидающую запись, закрепляющую файл intent. При потере ответа контрольного COMMIT сохраняются подписанный файл и запись о неопределённости для сверки.

Ответ committed требует видимого завершения точного xid8, соответствующего xmin штатного маркера 0037, ожидаемой схемы и пустого журнала v2 с нулевой квотой. rolled-back требует состояния aborted в том же снимке и совпадения pre-0037 схемы, строк диагностики и операционных связей. При открытой, подготовленной или слишком старой транзакции, расхождениях схемы или невидимом завершении возвращается unknown. Инспекция оставляет UUID карантина и ожидающую запись без изменений, без повтора транзакции и без READY. Статус транзакций PostgreSQL.

legacy-cold-verify выпускает legacy-probe-cold-proof.json для уже восстановленной отдельной базы PostgreSQL 18. Передайте --approval, --approval-sha256, --transport, --transport-sha256, --ca, --source-registry, --archive-directory, --legacy-key-directory, --cold-signing-key и --output-directory. Защищённое одобрение legacy-probe-cold-verification-approval-v1 фиксирует реестр и заявление исходного поколения, TLS и точную роль холодной базы, SHA-256 полного архива и сохранённого encryption-key, отпечаток отдельного ключа Ed25519 и срок действия до 15 минут. Роли холодной базы нужны чтение legacy-таблиц, связанных источников и credentials и доступ к pg_control_system().

Команда сверяет в одном TLS-снимке восстановленные строки диагностики и связанные исходные операции. Подписанная квитанция связывает эти хеши с байтами полного архива, идентичностью холодной базы, хешем сохранённого ключа и хешем связанных строк credentials. Новый файл создаётся без перезаписи. Команда выдаёт только операторское свидетельство о прочитанном состоянии и байтах архива.

legacy-handoff-execute выполняет 0037 при действующем защищённом карантине, заранее настроенном для runtime. Передайте --bootstrap, --bootstrap-sha256, --ca, --source-registry, --source-spki-sha256, --activation-directory, --activation-sha256, --archive-directory, --legacy-key-directory, --source-signing-key, --approval, --approval-sha256, --cold-public-key и --cold-spki-sha256. Отдельно передайте --publisher-transport, --operator-transport, --control-transport и SHA-256 каждого файла через соответствующий --…-transport-sha256. Используются отдельные закреплённые роли и точные OID. Контроллеру требуется видеть активную транзакцию роли operator и обновлять текущий реестр контроля и карантин. Оператору нужны права владельца на проверяемые таблицы и DDL 0037.

Разрешение legacy-probe-0037-execution-approval-v1 подписывает независимый издатель холодной квитанции в домене mmapp:legacy-probe-0037-execute:ed25519:v1. Каноническое тело закрепляет UUID, решение execute-and-commit, активный исходный реестр и TLS, SHA-256 custody, полного архива, холодной квитанции, её одобрения, каталогов до и после 0037, manifest и байтов 0037, явное protectedRuntimePaused: true и срок действия. Перед запуском остановите управляемые экземпляры и старых писателей, оставьте действующей защиту восстановления, архив и ключ в защищённом хранилище. Нужны существующие 36 подлинных контрольных квитанций. Команда сверяет credentials под эксклюзивными блокировками и фиксирует intent до изменения строк. При успешной проверке результата PostgreSQL фиксирует отметку 0037 в той же транзакции. Карантин и ожидающая запись сохраняются для дальнейшей операторской проверки. При потере ACK используйте legacy-handoff-inspect с сохранённым SHA-256 intent.

legacy-handoff-adopt принимает параметры legacy-handoff-execute с заменой --source-signing-key на --handoff-intent-sha256. Сохраните исходное подписанное разрешение и холодную квитанцию. Команда сверяет их байты с intent и срок действия с временем применения подтверждённого маркера 0037. Для intent без этих двух отпечатков доступна инспекция. Роль operator удерживает эксклюзивные advisory-блокировки и SHARE на проверяемых отношениях, пока publisher проверяет точный переход, а control фиксирует HMAC-квитанцию 0037 для того же UUID и хеша intent. Для HMAC требуется исходный операторский ключ в MCP_STATE_DIR.

Файл legacy-probe-handoff-adoption-attempt.json сохраняется до контрольного COMMIT. При неопределённом результате используйте legacy-handoff-inspect: adoptionRecorded: true означает, что контрольный терминал подтверждён. Защищённый файл попытки блокирует повтор команды. Терминал сохраняет активный карантин, и последовательность 0038+ остаётся закрыта до независимого снятия карантина. READY и квитанция о восстановлении не выдаются.

legacy-handoff-release принимает параметры legacy-handoff-adopt и отдельно закреплённые --release-approval и --release-approval-sha256. При остановленном runtime холодный издатель подписывает legacy-probe-0037-release-approval-v1 в домене mmapp:legacy-probe-0037-release:ed25519:v1. Решение release-migration-quarantine закрепляет UUID, точные SHA-256 intent и HMAC adoption, исходный реестр и TLS, холодную квитанцию и архив, текущий каталог 0037, manifest и байты 0037, protectedRuntimePaused: true и срок действия до 15 минут. Команда сверяет исходные архивы, 37 подлинных контрольных записей и пустое v2 под теми же блокировками. Одна контрольная фиксация добавляет HMAC снятия к существующей записи 0037 и очищает только совпадающий UUID карантина. Голова журнала восстановления сохраняется.

Файл legacy-probe-handoff-release-attempt.json сохраняется перед фиксацией. При потере ACK выполните legacy-handoff-inspect; releaseRecorded: true подтверждает записанное снятие, а releaseApprovalSha256 позволяет сверить исходное разрешение. Повтор команды закрыт. Штатный controlled runner проверяет подтверждённое снятие и открытое состояние карантина перед запуском 0038+. Снятие карантина оставляет runtime остановленным и не выдаёт READY.

Проверка конца последовательности сверяет полную историю с тем же HMAC-проверяющим модулем, включая отдельные квитанции adoption и release 0037. Эталон из template0 включает владельца и ACL пространства mmapp_control наряду с каталогом приложения.

Для профиля с раздельными ролями используйте legacy-control-reference. Передайте --bootstrap, --bootstrap-sha256, --ca, --source-registry, --source-spki-sha256, --activation-directory, --activation-sha256, --publisher-transport и --operator-transport с SHA-256 обоих файлов, --approval, --approval-sha256, --cold-public-key и --cold-spki-sha256. Одобрение legacy-control-reference-approval-v1 с подписью независимого холодного издателя в домене mmapp:legacy-control-reference:ed25519:v1 фиксирует manifest, активный исходный реестр и TLS, три точных имени и OID ролей, срок до 15 минут. Профиль задаёт владельца пространства publisher и отдельные разрешения USAGE для operator и control.

Владелец прикладной базы должен иметь право самостоятельно создать одноразовую базу из template0. Отдельный издатель должен иметь уже предусмотренное право создать пространство внутри этой одноразовой базы. Команда проверяет физический источник, имя, OID и владельца новой базы перед изменением пространства, выдаёт утверждённые разрешения только в ней и требует точного сравнения ACL. Исходные права и пространство имён остаются прежними. После удаления эталонной базы команда сохраняет HMAC-артефакт с отпечатком подписанного одобрения в защищённом MCP_STATE_DIR. Существующий эталон сохраняется без перезаписи. Любое лишнее разрешение в целевой базе ведёт к different; READY не выдаётся.

legacy-source58-preflight проверяет исходную точку перед установкой защищённого Source58. Используйте параметры legacy-control-reference без --operator-transport и --operator-transport-sha256. Отдельное одобрение legacy-source58-preflight-approval-v1 в домене mmapp:legacy-source58-preflight:ed25519:v1 связывает пять имён и OID, исходное поколение и TLS, manifest, точный хеш текущего split-эталона, UUID и SHA-256 intent и разрешения на снятие карантина, заранее утверждённые отпечатки определения и целевого каталога Source58 и срок до 15 минут. Под эксклюзивным drain команда сверяет исходный каталог и все контрольные квитанции вместе с маркерами в удерживаемом снимке только для чтения.

Результат observed показывает конкретные расхождения владения контрольной схемой и таблицей карантина, отсутствие реестра и защиты маркера, а также базовые препятствия по ролям. Целевой digest возвращается как отпечаток подписанного намерения. Публикации Source58 нужны отдельная установка и полная сверка. Штатный restore-profile-enroll создаёт таблицу карантина и не принимает уже существовавшую таблицу legacy. Реестр требует владельца пространства control, а runtime проверяет полный каталог вместе с контрольными объектами, подписанным профилем записи и собственной внешней контрольной точкой.

Для отдельной неподключённой базы с применёнными миграциями 0057, пустой схемой mmapp_control и исходным маркером используйте source58-foundation-enroll. Подготовьте те же bootstrap, активацию, исходный реестр, CA и закреплённый транспорт publisher, отдельный --control-transport и его SHA-256, а также --approval, --approval-sha256, --approval-public-key и --approval-spki-sha256. Независимый оператор подписывает source58-foundation-approval-v1 в домене mmapp:source58-foundation:ed25519:v1 с решением install-foundations. Тело закрепляет bootstrap с именами и OID всех ролей, текущие source head и TLS, manifest, определение Source58, независимо утверждённый исходный каталог, SHA-256 фиксированного DDL и срок действия до 15 минут. Хеш плана вычисляет source58FoundationSqlSha256 по исходникам сборки и утверждённым ролям.

Закреплённая роль control уже должна владеть пустой схемой и обладать полномочием создать event trigger. PostgreSQL 18 допускает такую команду только для суперпользователя. Действие не добавляет полномочий ролям. Под удерживаемым drain оно ставит проверенные функции, точный candidate_operator_ddl, права на схемы и две пустые таблицы реестра. Оно сверяет установленные определения, владельцев, ACL и реестр перед единым COMMIT. При неизвестном исходе проверьте установленное состояние, прежде чем готовить новую попытку. Установка полной защиты отношений, маркера и профиля восстановления выполняется отдельно. CREATE EVENT TRIGGER

Следующий этап для отдельной staging-базы с этими установленными основами и без созданных дочерних партиций — source57-admission-enroll с теми же флагами. Независимый оператор подписывает source57-admission-approval-v1 в домене mmapp:source57-admission:ed25519:v1. Укажите decision: install-admission, отпечаток определения Source57, исходный полный каталог с event trigger и admissionSha256 фиксированного плана из source57AdmissionSqlSha256, а также те же закрепления bootstrap, manifest, исходного реестра и TLS. Действие устанавливает защиты для фиксированных базовых отношений, точные ACL таблиц, колонок и последовательностей, а также существующий проверенный набор триггеров маркера. До подтверждения SQL оно сверяет полный каталог Source57. Возвращённый отпечаток — результат фактической проверки, который сам по себе не утверждает публикацию.

Установка quarantine по-прежнему идёт через restore-profile-enroll. Для неё нужны опубликованная подписанная голова Source57, независимые отпечатки каталогов 57 и 58, а также закреплённые --bootstrap и --bootstrap-sha256 с исходным публичным ключом издателя. В той же транзакции перед DDL команда подтверждает подпись головы и её предшественника, роль, источник и отпечаток каталога Source57. Роли и права на уровне базы готовятся заранее по проверенному профилю. Команда установки защиты отношений их не меняет.

Первую голову Source57 публикует штатная команда publish с определением application-writer-source57-definition-approval-v1, отдельно утверждённым отпечатком каталога и expectedHeadSha256: null. Для продления требуется точный хеш предыдущей головы. source-preflight сверяет текущую подпись, ссылку на подписанного предшественника, реальное TLS-подключение, подписанный исходный реестр и закреплённый хеш активации. До установки Source58 чтение из реестра разрешено издателю и оператору, а runtime получает отказ.

После подтверждённой установки карантина upgrade принимает определение application-writer-source58-definition-approval-v1 и разрешение application-writer-upgrade57-to58-approval-v1. Разрешение закрепляет прежнюю подписанную голову и каталог Source57, независимо утверждённый каталог Source58 и период действия. Штатный издатель сравнивает источник, роли и каталог, затем подписывает следующий номер эпохи. source-catalogue-inspect требует уже опубликованную голову Source58. Проверка подписанного профиля на ограниченной runtime-роли является частью допуска соединения, а запуск до READY требует отдельной проверки.

Для объединённого прогона подготовьте партиции штатной командой оператора до утверждения каталогов и публикации. Защищённый runtime только сверяет наличие, диапазоны и наследование партиций. Даже добавление штатных партиций меняет отпечаток каталога. Закреплённой роли runtime требуется предусмотренное чтение pg_control_system() на её физическом подключении. Проверку выполняйте с тем же подписанным исходным реестром, активацией через source-activate, TLS и опубликованной головой, которые были утверждены оператором.

Для новой базы исходный внешний файл sealed с head: null допустим после сверки пустого журнала и карантина. Оператор закрепляет реальный runtime target, хеш активации и опубликованную голову. Каталог контрольной точки должен быть независим от PGDATA и MCP_STATE_DIR и подключён к runtime только для чтения. Дальше используйте штатные архив, stage, одноразовый claim, восстановление, повторную публикацию после реального изменения каталога, seal и complete. Независимая проверка среды требует POSIX-проверок владельца и режима, а также синхронизации каталога контрольной точки.

Локальные квитанции остаются раздельными. Публикация Source58 подтверждена на свежем стенде с настоящим исходным реестром и моделью POSIX-файлов. Предыдущий прогон восстановления и запуска подтвердил штатный backend после complete, используя тестовый аттестатор исходного поколения и модель файловой защиты. Сквозной прогон обеих частей с реальной защитой файлов ещё открыт. Публикация Source58 · Восстановление и запуск Оно использует настоящий отдельный publisher Pool и удерживаемую READ ONLY транзакцию: проверяет source binding, фактическую роль publisher, структуру реестра и все пять ролей, подписанный текущий policy/head с живым сроком, полный каталог текущей сборки и его соответствие подписанной политике и независимому действующему approval. Перед завершением повторяются source/actor проверки, сроки signed policy и approval. Неопределённый rollback или cleanup запрещает успешный результат. Приватный ключ не читается; публикация и журнал не меняются.

Ответ application-writer-profile-preflight с outcome: matched содержит epoch, headSha256, notAfter, sourceMatched, rolesMatched и catalogueMatched. Это диагностика текущей publisher-сессии. Она всегда содержит writerAuthorized: false, generationAuthenticated: false, readyAuthorized: false; результат нельзя передавать как capability или допуск к последующей записи, bootstrap, backup/restore. Другой SQL-сеанс и более поздняя операция обязаны проходить собственный допуск. Неподтверждённая публикация требует reconcile; успешный preflight не классифицирует и не очищает pending journal.

Для этого действия требуется действующее approval, а его expectedHeadSha256 сохраняет исходный смысл предыдущего head для публикации. Оно не закрепляет текущий head preflight и не становится execution approval. Текущий head аутентифицируется через защищённый SQL-реестр, подписи и append-only связь. Используется эксклюзивный PostgreSQL advisory session lock того же publisher-компонента, а не файловый publisher-lease.lock: это может кратковременно задерживать согласованных writers. Функциональная SQL/TLS/POSIX-приёмка preflight и reconcile принята на Linux: отчёт. Потеря подтверждения после COMMIT моделировалась на уровне приложения. Ресурсная часть этого прогона не принята из-за роста swap; generation/READY не выдаются.

Переход с профиля 44 на 56

Команда upgrade принимает те же флаги, что publish. В файле одобрения нужен формат application-writer-upgrade44-to56-approval-v1, ненулевой expectedHeadSha256 и previousCatalogSha256 из подтверждённой подписанной политики 44. Остальные поля закрепляют новое определение и каталог 56, срок действия политики и срок одобрения. Перед записью оператор проверяет подпись текущей головы, закреплённое определение 44, тот же источник и OID всех ролей, а также фактический каталог и точные миграции 56. Новая подписанная запись ссылается на предыдущую, а CAS меняет текущую голову с проверкой прежнего хеша.

Для перехода 56 → 57 используется application-writer-upgrade56-to57-approval-v1 и одобрение определения application-writer-source57-definition-approval-v1. Предыдущая голова должна быть подписанной политикой 56 для той же БД и ролей. Изменение схемы 57 добавляет частичный индекс аудита квот. Обычный CREATE INDEX блокирует запись в mcp_audit на время построения и фиксируется одной транзакцией с маркером миграции. Управляемый диспетчер принимает полную подписанную историю 56, в том числе с полным унаследованным префиксом 44, сохраняет исходные квитанции и выполняет 0057. Формат 44 → 56 остаётся отдельным переходом. Совместимость исторических квитанций в диспетчере сама по себе не подтверждает READY.

Одноразовая PostgreSQL 18.4 подтвердила переход из точного снимка 56: исходные 56 квитанций и отметок сохранены с прежними версиями строк, исполнена только 0057, повторный запуск пропустил все файлы. Тесты формата одобрения, CAS и упаковка оператора прошли. На локальной PostgreSQL publisher сверил каталог 57 со 117 дочерними таблицами под раздельными ролями и отказал при недостающем праве на колонку и лишнем праве на таблицу. Квитанция 56 → 57 · Проверка каталога.

Отдельная локальная проверка через TLS сверила фактические каталоги 56 и 57 на одной БД, сохранила подписанную тестовую политику 56 и опубликовала политику 57 через CAS реестра. Повторный preflight подтвердил новую голову. Ключ и сертификат тестовые, журнал и подтверждение источника реализованы фикстурами Windows. Защита файлов в POSIX и эксплуатационный READY остаются открытыми. Квитанция TLS-публикации.

До миграций проверьте подписанную политику 44. Удерживайте эксплуатационную приостановку записи через миграции, установку проверенных ACL и защитных триггеров, upgrade и успешный source-preflight уже с обычным одобрением для политики 56. При неопределённом подтверждении COMMIT сохраните приостановку и выполните reconcile с исходным журналом и исходным одобрением перехода. Для сверки допустимо истёкшее одобрение.

Компонентный прогон проверил подпись, точный CAS и отклонение изменённых исходных данных. На одной локальной PostgreSQL 18 проверены исходный каталог 44, миграция под владельцем до 56 маркеров и установка прав и защиты только на шести новых отношениях. Блокировка запросов сохранялась от чтения исходного каталога до подтверждения новой головы через preflight. Реальный publisher по TLS добавил подписанный epoch 2, сохранив исходную запись и тестовую строку приложения. Подпись исходной записи, журнал и attestor источника подготовила Windows-фикстура. Защищённые POSIX-файлы остаются открытым этапом. Квитанция перехода.

Сквозной сценарий публикации использует applySqlMigrations с блокировкой на подключении владельца. Для независимого executeControlledSqlMigrations выполнен отдельный переход на одной PostgreSQL 18: диспетчер создал 44 исходные квитанции с замороженным манифестом, отклонил лишний UPDATE на таблицу маркеров до отправки SQL-миграций и сохранил все 44 записи. После восстановления точных ACL он применил только 12 файлов 0045–0056, а повторная сверка не отправила миграций. Проверка маркеров проверяет владельца, ACL, три триггера и связанные функции под удерживаемой блокировкой. Локальная приёмка держит READY закрытым. Квитанция перехода с журналом · Квитанция проверки триггеров.

Объединённый локальный прогон применил те же 12 файлов через executeControlledSqlMigrations, установил защиту и ACL шести новых таблиц, опубликовал подписанную политику 56 по TLS и подтвердил текущую голову через preflight на той же БД. Все 44 исходные квитанции сохранены. Изоляция runtime обеспечивалась правилом тестового pg_hba.conf, подтверждённым тремя отказами входа и отсутствием его сессий. Журнал публикации и attestor источника были Windows-фикстурами. Защищённые POSIX-файлы, готовность приложения и штатная эксплуатационная приостановка записи остаются открытыми. Квитанция объединённого прогона.

Проверка назначения восстановления

Восстановление БД приложения проверяет назначение на фактическом подключении psql в транзакции восстановления. Подключение приложения удерживает блокировки запросов и обслуживания и случайную advisory lock. Проверка выполняется до SQL архива и после него. На одном одноразовом кластере подтверждены восстановление в ожидаемую БД и отказ другой БД до DDL. Освобождённая блокировка также отклонена. Квитанция проверки назначения · Advisory locks в PostgreSQL.

Параметры текущего подключения передаются через временный pg_service.conf внутри каталога состояния MCP. psql получает имя сервиса и путь к файлу. Офлайн-команды pg_restore запускаются без настроек подключения. Пароль и URL отсутствуют в аргументах и окружении дочерних процессов. Файл удаляется после завершения команды. Для POSIX создаются каталог 0700 и файл 0600. На Windows установленный каталог состояния должен иметь ACL владельца. На одноразовой PostgreSQL проверено реальное восстановление этим путём. Квитанция service file · Документация libpq.

Для ограниченной роли приложения задайте DATABASE_RESTORE_URL_FILE абсолютным путём к защищённому файлу с полным PostgreSQL URI владельца схемы public. Логин владельца состоит из строчных ASCII-букв, цифр и _, первый символ — буква или _. На POSIX файл принадлежит пользователю backend и доступен только ему, например с правами 0600. На Windows ограничьте ACL файла учётной записью backend. psql и последующие миграции проверяют SESSION_USER, CURRENT_USER, владельца схемы и блокировку исходной БД на собственных подключениях. Runtime продолжает держать блокировки обслуживания. На одноразовой PostgreSQL проверены отказ DDL для runtime, восстановление архива владельцем, применение оставшейся миграции 0056 и чтение результата под runtime. Квитанция раздельных ролей.

На том же локальном сценарии временная schema_migrations в повторно используемом SQL-сеансе содержала отметку 0056. Проверка подтвердила, что исполнитель применил миграцию в public и оставил временную таблицу без изменений. Квитанция проверки search_path.

Если архив применён, а последующая миграция не подтверждена, основной журнал записывает unconfirmed. Старые квитанции MCP с migrationError или maintenanceError также переводят запуск в режим, требующий проверки. Исходная квитанция применения архива сохраняется. Штатный запуск возможен после операторского подтверждения наблюдаемого состояния, автоматический повтор восстановления исключён.

Артефакт для production image

npm --prefix backend run build после обычной компиляции backend выполняет build:database-operator. Отдельный build-time script использует установленный TypeScript и создаёт backend/dist-operator: два entrypoint, 15 явно перечисленных helpers и build-manifest.json с SHA256 исходников и результатов. Manifest также перечисляет полную используемую цепочку backend/dist helpers с их SHA256/imports и все production dependencies этой цепочки. Сборка обходит не более 64 compiled helpers и отказывает при выходе из dist, source/TS/dev imports или пропавшем модуле. Изменяются только AST-узлы import/export и literal dynamic import: ссылки на src переходят на уже собранный backend/dist. SQL-строки не переписываются. Неизвестный helper, computed import, ссылка на TS/source или dev dependency запрещают сборку.

Docker runner получает только готовый dist-operator, штатный dist и production зависимости. TypeScript и TSX во время operator-команды не требуются. Ключи, bootstrap, approval, transport, CA, source registry и journal остаются внешними операторскими входами; build не копирует их и не создаёт.

Из корня готового контейнера команда запускается явно:

node backend/dist-operator/database-writer-profile-operator.mjs preflight --bootstrap /operator/bootstrap.json --bootstrap-sha256 APPROVED_SHA --approval /operator/approval.json --approval-sha256 APPROVED_SHA --definition /operator/definition.json --definition-sha256 APPROVED_SHA --transport /operator/transport.json --transport-sha256 APPROVED_SHA --ca /operator/ca.pem --source-registry /operator/source-registry --source-spki-sha256 APPROVED_SHA --journal /operator/journal

Для явно разрешённой публикации или reconcile меняется только первое действие. Offline initialization также имеет готовый entrypoint: node backend/dist-operator/database-writer-bootstrap-operator.mjs init .... Существующие требования защищённых POSIX-файлов, TLS, независимых SHA256 и сроков сохраняются. Entrypoint сервера остаётся node backend/dist/index.js; operator не запускается автоматически и не регистрирует HTTP endpoint. Наличие артефакта не выдаёт generation, writer authorization или READY.

Проверка build-артефакта на Node22: node --test backend/scripts/build-database-operator.test.mjs. Она собирает отдельную проекцию, проверяет повторяемость, imports всех модулей без TSX/TypeScript и отказы двух CLI до подключения. Это отдельная локальная проверка упаковки; она не заменяет Linux Docker/SQL/TLS/POSIX функциональную приёмку publish/preflight/reconcile.