13 KiB
13 KiB
Пакет проверок владельца перед деплоем
Здесь перечислены проверки, которые выполняет владелец. Этот документ не разрешает 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в доверенные пути. Задача подготовки сохраняет защищённыйPREPAREDtuple и никогда не отправляет 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 с OpenSSHrestrict(или эквивалентным запретом PTY и forwarding), проверкой host key и точным сопоставлением status/deploy-команд. Не добавляйте unrestricted shell или команду в rootauthorized_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 secretsREGISTRY_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, mode0600. Запишите только наличие и scope токена, не его значение. - Проверьте origin скачивания Gitea artifacts. При redirect добавляйте только
точный HTTPS origin в
/etc/akyldash/gitea-download-origins, root-owned, mode0600. Исправленный helper не должен отправлять этому origin token. - Добавьте одобренные владельцем RU и KY search canary queries в
/etc/akyldash/release-canaries.json, root-owned, mode0600. Убедитесь, что они возвращают ожидаемые непустые результаты; не передавайте тексты корпуса. - Проверьте 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 до фиксации владельцем результатов всех проверок выше.