Files
akyldash/docs/operations/DEPLOYMENT_OWNER_PACKET.md
codex 9d553744a1
CI / tests-and-images (pull_request) Successful in 2m13s
Runner smoke test / runner-smoke (pull_request) Successful in 2s
Harden Windows release bundle trust boundary
2026-11-03 10:02:27 +03:00

13 KiB
Raw Permalink Blame History

Пакет проверок владельца перед деплоем

Здесь перечислены проверки, которые выполняет владелец. Этот документ не разрешает production-изменения. Не включайте значения токенов и паролей, содержимое env-файлов, приватные ключи, другие секреты или полный вывод переменных окружения.

Что требуется до использования CD

  • Отключённый одноразовый Windows trigger из PR #59 уже находится в main, но не установлен и не запускался. Bootstrap из этого PR также не установлен. После ревью и слияния обновите локальный main до проверенного полного SHA. Под обычным пользователем подготовьте bundle командой prepare_windows_release_bundle.py --repository D:\Dev\akyldash --commit <SHA> --output <new ZIP path>. Упаковщик требует, чтобы SHA совпадал с локальной вершиной main; он читает Git objects этого commit, а не рабочее дерево, проверяет SHA-1 объектов commit/tree/blob и печатает SHA-256 ZIP. Передайте именно эти SHA и путь elevated installer: install_windows_release_client.ps1 -ExpectedCommit <SHA> -BundlePath <path> -ExpectedBundleSha256 <digest>. Installer открывает ZIP один раз с запретом записи и удаления, сверяет SHA-256, manifest и цепочку commit → tree → файлы в памяти и только после полной проверки копирует эти байты. Elevated installer не запускает Git и не читает .git/config, hooks или файлы checkout. Не меняйте ZIP между подготовкой и установкой; сохраните SHA и полный commit для журнала владельца.
  • Installer проверяет подпись PSF у C:\Python313\python.exe и защищённые ACL, создаёт версионный каталог в Program Files без перезаписи существующей версии и назначает владельцем новых файлов кода Administrators. Кодовые пути должны принадлежать только SYSTEM, Administrators или TrustedInstaller; учётная запись задачи допускается владельцем только для отдельных private state/config. ACL-проверка файла/кодового каталога выявляет запись, добавление, удаление, удаление дочерних объектов, смену ACL и владельца. Проверка родительских каталогов выявляет права, позволяющие заменить защищённый путь; создание постороннего соседнего каталога само по себе не считается подменой.
  • Installer сохраняет существующий C:\ProgramData\Akyldash\release-trigger.json только если он остаётся отключённым, создаёт disabled auto-apply config лишь при отсутствии и формирует два disabled Task Scheduler XML для проверки. Он не регистрирует и не включает задачи. Путь trigger известен, но содержимое и его enabled-состояние не читались.
  • Launcher использует проверенный C:\Python313\python.exe с -B -E -s -S, проверяет происхождение импортированных модулей, заменяет унаследованный PATH, очищает GIT_* и фиксирует разрешение ssh.exe, git.exe и powershell.exe в доверенные пути. Задача подготовки сохраняет защищённый PREPARED tuple и никогда не отправляет deploy-запрос.
  • Задача auto-apply и её отдельный конфиг тоже остаются выключенными. Одного enabled в preparation config недостаточно для деплоя. Auto-apply разрешён, только если свежий root status точно совпал с tuple, сохранённым предыдущим опросом. После явного согласования владельцем unattended deployment отдельное подтверждение каждого SHA не требуется. Включайте preparation config и задачу только после отдельного разрешения на опрос; auto-apply config и задачу — только после отдельного разрешения на unattended production deployment и выполнения всех backup/restore gate. Отключение любого auto-apply control останавливает будущие автодеплои; уже начатый cold backup/deploy должен завершиться либо быть восстановлен по процедуре.
  • Ключ akyldash_release должен быть отдельным и привязанным к root forced-command dispatcher с OpenSSH restrict (или эквивалентным запретом PTY и forwarding), проверкой host key и точным сопоставлением status/deploy-команд. Не добавляйте unrestricted shell или команду в root authorized_keys. Существующий ключ и путь rollback остаются отдельным ручным действием владельца. PR не создаёт, не копирует и не устанавливает ключи.
  • Решите, допустим ли unattended production CD. Сейчас он не включён: deploy-handoff.yaml остаётся только status-проверкой и сообщает NOT DEPLOYED; обе локальные задачи и оба config gate выключены. Windows-хост не открыт workflow и PR runner. Убедитесь, что root status command установлен из проверенного bootstrap и ключ forced command ограничен.
  • Checkout на хосте не обязан совпадать с текущим main: status сравнивает защищённые root Compose/Caddy файлы и установленную release policy с файлами точного candidate SHA через pinned Gitea Contents API и проверяет Git blob IDs и размеры. Receiver повторяет сравнение до остановки сервисов; cutover повторяет его после backup. Несовпадение требует отдельного проверенного owner bootstrap update; код release или root helper автоматически не выполняется и не обновляется. Текущий main и CI/release provenance всё равно перепроверяются перед apply. Endpoint закрывается при неполной странице workflow-run API (более десяти кандидатов или несовпадение count). Перед включением проверьте поведение этого API на установленной версии Gitea.
  • Подтвердите имена registry packages и минимальные права записи/чтения для admin/akyldash/backend и admin/akyldash/opensearch; сохраните digest не короче rollback window. Последняя read-only проверка Gitea: main CI run #706 завершился успешно, image release run #708 завершился ошибкой из-за отсутствия repository secrets REGISTRY_USERNAME и REGISTRY_PASSWORD, status-only handoff run #709 был пропущен. Добавьте эти secrets через настройки Gitea; не помещайте значения в Git или логи.
  • Проверьте, что срок хранения Gitea artifacts покрывает rollback window. Workflow запрашивает хранение небольшого release descriptor и checksum на 90 дней.
  • Подготовьте датированный очищенный root audit: SHA установленного checkout, Compose services и image IDs, состояние health, пути и режимы volumes, владельца/режим защищённых файлов, сводку listeners и состояние recovery journal.
  • Подтвердите root-controlled SSH путь для фиксированных deploy/rollback-команд, используя существующую owner SSH-конфигурацию и проверенный host key. Репозиторный codex не должен получать общий sudo, членство в Docker group или Docker socket. PR не устанавливает SSH key или root alias.
  • Если потребуется, установите узко ограниченный read-only Gitea API token в /etc/akyldash/gitea-api-token, владелец root, mode 0600. Запишите только наличие и scope токена, не его значение.
  • Проверьте origin скачивания Gitea artifacts. При redirect добавляйте только точный HTTPS origin в /etc/akyldash/gitea-download-origins, root-owned, mode 0600. Исправленный helper не должен отправлять этому origin token.
  • Добавьте одобренные владельцем RU и KY search canary queries в /etc/akyldash/release-canaries.json, root-owned, mode 0600. Убедитесь, что они возвращают ожидаемые непустые результаты; не передавайте тексты корпуса.
  • Проверьте TLS mode Cloudflare, продление origin certificate и текущую доступность публичных /review и search.

Backup и восстановление

  • Полный архив хранится только на Windows-носителе владельца D:\Dev\akyldash\.backups; не размещайте полный архив на VPS.
  • Synthetic Windows protocol проверки и временная private-NTFS owner-ACL fixture прошли. До использования проверьте реальный путь D: и локальное правило .git/info/exclude; затем подтвердите, что одобренный backup публикуется только после проверки hash и manifest.
  • Подтвердите шифрование D: при хранении. Архив содержит production secrets и private keys; протокол шифрует передачу, но не хранение файлов.
  • Восстановите проверенный архив на отдельной изолированной цели и проверьте данные, SQLite integrity, OpenSearch и необходимые secrets. Не проверяйте restore на production.
  • Подтвердите текущие counts данных и индекса, corpus generation и совместимость миграций. Откат образа не восстанавливает данные и не отменяет изменения схемы.
  • Задайте срок хранения архивов и сохраняйте предыдущий проверенный архив весь rollback window.

Installer не создаёт credentials, SSH configuration, canary values, доступ к registry или новые sudo rules. PR не установлен и не запускался на production. Windows validation прошла 12 synthetic client checks, 8 protocol checks и временную private owner-ACL fixture на NTFS. Installer и launcher на Windows не запускались; реальный путь D:, SSH, полный backup и restore на отдельную цель не проверены. Не включайте deployment до фиксации владельцем результатов всех проверок выше.