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 до первого успешного запуска.

Процесс 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.