AWatch-rus/docs/registry/RELEASE_EVIDENCE_RUNBOOK_RU.md

Release evidence runbook

Статус: registry-readiness runbook. Документ описывает выпуск release candidate на российском build-runner awatch-build-01. Он не утверждает, что release evidence уже production-ready до первого успешного запуска.

GitHub Actions is public mirror validation only. Public CI, coverage and security workflows improve transparency, but registry release evidence must be produced on the Russian build-runner.

Процесс release candidate

1. Checkout конкретного commit SHA или tag.
2. Clean build environment.
3. Выполнить cargo fmt --all --check.
4. Выполнить cargo test --workspace.
5. Выполнить cargo clippy --workspace --all-targets -- -D warnings.
6. Выполнить cargo build --workspace --release.
7. Выполнить bash scripts/registry_readiness_check.sh.
8. Выполнить release evidence check: bash scripts/check_release_evidence.sh <evidence-dir>.
9. Запустить доступные smoke-тесты: node scripts/deployment-readiness-smoke.mjs, node scripts/pilot-validation-smoke.mjs, node scripts/browser-conformance-smoke.mjs, если не требует live stand, bash scripts/validate_install_kit.sh, если применимо.
10. Сформировать source archive.
11. Сформировать binary artifacts archive.
12. Сформировать SHA256SUMS.
13. Сформировать cargo-metadata.json.
14. Сформировать cargo-tree.txt.
15. Сформировать SBOM CycloneDX/SPDX, если tools доступны.
16. Сформировать release evidence manifest.
17. Сохранить logs.
18. Сохранить final report.

Если smoke требует live stand, не удалять и не скрывать его. В release report фиксировать: skipped: requires live stand.

Автоматизация

Основной скрипт:

RELEASE_VERSION=registry-candidate-YYYYMMDD-HHMMSS \
RELEASE_COMMIT=<commit-sha-or-tag> \
OUTPUT_DIR=release-evidence/<release-version> \
bash scripts/build_release_evidence.sh

Для documentation-only изменения допустимо:

DOCS_ONLY=1 bash scripts/build_release_evidence.sh

DOCS_ONLY=1 должен явно попасть в report. Это не должно использоваться для product/runtime release candidate.

Обязательные результаты

• release-evidence-manifest.json.
• RELEASE_EVIDENCE_REPORT_RU.md.
• SHA256SUMS.
• logs/.
• Source archive.
• Binary artifacts archive или documented skip только для DOCS_ONLY=1.
• cargo-metadata.json или documented skip.
• cargo-tree.txt или documented skip.

Conservative claims

Release evidence не является подтверждением юридически завершенной регистрации в реестре РФ. Перед официальной подачей требуются rightsholder confirmation, финальная юридическая проверка и проверка фактического build-runner.