Полная проверка релиза

Full Release Validation — это общий зонтик релиза. Это единая ручная точка входа для дорелизного подтверждения, но большая часть работы выполняется в дочерних workflows, чтобы упавшую среду можно было перезапустить без повторного запуска всего релиза.

Запускайте его из доверенной ссылки workflow, обычно main, и передавайте релизную ветку, тег или полный SHA коммита как ref:

gh workflow run full-release-validation.yml \  --ref main \  -f ref=release/YYYY.M.PATCH \  -f provider=openai \  -f mode=both \  -f release_profile=stable

Дочерние workflows используют доверенную ссылку workflow для harness и входной ref для проверяемого кандидата. Это позволяет использовать новую логику валидации при проверке более старой релизной ветки или тега.

release_profile=stable и release_profile=full всегда запускают исчерпывающий live/Docker soak. Передайте run_release_soak=true, чтобы включить те же soak lanes для beta-профиля. Публикация стабильного релиза отклоняет манифест валидации без этого soak и блокирующего evidence по product-performance.

Package Acceptance обычно собирает tarball кандидата из разрешенного ref, включая запуски по полному SHA, отправленные через pnpm ci:full-release. После публикации beta передайте release_package_spec=openclaw@YYYY.M.PATCH-beta.N, чтобы повторно использовать опубликованный npm-пакет во всех release checks, Package Acceptance, cross-OS, release-path Docker и package Telegram. Используйте package_acceptance_package_spec только когда Package Acceptance должен намеренно подтвердить другой пакет. Live package lane Plugin Codex следует тому же состоянию: опубликованные значения release_package_spec выводят codex_plugin_spec=npm:@openclaw/codex@<version>; запуски по SHA/артефакту упаковывают extensions/codex из выбранного ref; а операторы могут задать codex_plugin_spec напрямую для источников Plugin npm:, npm-pack: или git:. Lane выдает явное разрешение на установку Codex CLI, требуемое этим Plugin, затем запускает preflight Codex CLI и ходы агента OpenAI в той же сессии.

Верхнеуровневые этапы

Для ref=main и rerun_group=all более новый umbrella заменяет более старый. Когда родительский workflow отменяется, его монитор отменяет любой дочерний workflow, который он уже отправил. Запуски валидации релизных веток и тегов по умолчанию не отменяют друг друга.

Этапы release checks

OpenClaw Release Checks — самый большой дочерний workflow. Он один раз разрешает target и подготавливает общий артефакт release-package-under-test, когда он нужен этапам, работающим с пакетами или Docker.

Docker-чанки release-path

Этап Docker release-path запускает эти чанки, когда live_suite_filter пуст:

Используйте целевой docker_lanes=<lane[,lane]> в переиспользуемом live/E2E workflow, когда сбой произошел только в одной Docker-дорожке. Артефакты релиза включают команды перезапуска по дорожкам с входными данными для артефакта пакета и повторного использования образа, когда они доступны.

Профили релиза

release_profile в основном управляет широтой live/provider внутри проверок релиза. Он не удаляет обычный полный CI, Plugin Prerelease, install smoke, package acceptance или QA Lab. Профили stable и full всегда запускают исчерпывающее покрытие repo/live E2E и Docker release-path soak. Профиль beta может включить его через run_release_soak=true. Package Acceptance предоставляет канонический package Telegram E2E для каждого полного кандидата, поэтому umbrella не дублирует этот live poller.

Добавления только для full

Эти наборы пропускаются в stable и включаются в full:

stable включает native-live-src-gateway-profiles-anthropic-smoke и native-live-src-gateway-profiles-opencode-go-smoke; full вместо этого использует более широкие шарды моделей Anthropic и OpenCode Go. Сфокусированные перезапуски все еще могут использовать агрегированные handles native-live-src-gateway-profiles-anthropic или native-live-src-gateway-profiles-opencode-go.

Сфокусированные перезапуски

Используйте rerun_group, чтобы не повторять несвязанные релизные задания:

Используйте live_suite_filter с rerun_group=live-e2e, когда отказал один live-набор. Допустимые идентификаторы фильтров определены в переиспользуемом live/E2E workflow, включая docker-live-models, live-gateway-docker, live-gateway-anthropic-docker, live-gateway-google-docker, live-gateway-minimax-docker, live-gateway-advisory-docker, live-cli-backend-docker, live-acp-bind-docker и live-codex-harness-docker.

Дескриптор live-gateway-advisory-docker — это агрегированный дескриптор повторного запуска для его трех шардов провайдеров, поэтому он по-прежнему разворачивается во все advisory-задания Docker Gateway.

Используйте cross_os_suite_filter с rerun_group=cross-os, когда отказала одна кросс-ОС линия. Фильтр принимает идентификатор ОС, идентификатор набора или пару ОС/набор, например windows/packaged-upgrade, windows или packaged-fresh. Кросс-ОС сводки включают тайминги по фазам для линий packaged upgrade, а длительные команды печатают строки Heartbeat, чтобы зависшее обновление Windows было видно до тайм-аута задания.

Сбои релизных проверок QA блокируют обычную релизную валидацию. Требуемое смещение динамических инструментов OpenClaw в стандартном уровне также блокирует верификатор релизных проверок. Запуски Tideclaw alpha могут по-прежнему считать линии релизных проверок, не связанные с безопасностью пакета, рекомендательными. Когда live_suite_filter явно запрашивает закрытую live-линию QA, например Discord, WhatsApp или Slack, соответствующая переменная репозитория OPENCLAW_RELEASE_QA_*_LIVE_CI_ENABLED должна быть включена; иначе захват ввода завершится ошибкой вместо молчаливого пропуска линии. Перезапустите rerun_group=qa, qa-parity или qa-live, когда нужны свежие доказательства QA.

Доказательства, которые нужно сохранить

Сохраняйте сводку Full Release Validation как индекс релизного уровня. Она ссылается на идентификаторы дочерних запусков и включает таблицы самых медленных заданий. При сбоях сначала проверьте дочерний workflow, затем повторно запустите наименьший подходящий дескриптор выше.

Полезные артефакты:

• release-package-under-test из OpenClaw Release Checks
• Артефакты релизного пути Docker в .artifacts/docker-tests/
• package-under-test приемки пакета и артефакты приемки Docker
• Артефакты кросс-ОС релизных проверок для каждой ОС и набора
• Артефакты паритета QA, Matrix и Telegram

Файлы workflow

• .github/workflows/full-release-validation.yml
• .github/workflows/openclaw-release-checks.yml
• .github/workflows/openclaw-live-and-e2e-checks-reusable.yml
• .github/workflows/plugin-prerelease.yml
• .github/workflows/install-smoke.yml
• .github/workflows/openclaw-cross-os-release-checks-reusable.yml
• .github/workflows/package-acceptance.yml