Fighting Game · Guides & deep dives

V2 Hotfix Testing Pipeline

Required regression tests cover:

5sections1 minread
Markdown source
On this page

This runbook covers TODOS.phase-72.72.12.2.9: a hotfix testing pipeline where automated regression tests run on each hotfix before deployment.

The implementation lives in @v2/hotfix-testing-pipeline-service at apps/v2/hotfix-testing-pipeline-service/. Its contract is V2/ue/Content/V2/LiveOps/HotfixTestingPipeline_V2_Contract.json and the validation gate is V2/ue/Tools/check-v2-hotfix-testing-pipeline.py.

Regression Suites#

Required regression tests cover:

  • balance-regression
  • exploit-regression
  • data-integrity
  • smoke

Each test definition includes testId, regressionKind, required, command, timeoutSeconds, and coverageTags. Required tests must stay required because the deployment gate blocks when a required regression is missing, blocked, or failed.

Deployment Gate#

buildV2HotfixTestingPipelineSurface publishes the hotfix candidates, required regression tests, raw regression results, and per-hotfix deployment gates. evaluateV2HotfixTestingGate evaluates a single hotfix and returns deploymentApproved only when every required regression test has passed before deployment.

Primary APIs:

  • buildV2HotfixTestingPipelineSurface
  • evaluateV2HotfixTestingGate

Service endpoints:

  • POST /v2/live-ops/hotfixes/{hotfixId}/testing/run
  • GET /v2/live-ops/hotfixes/{hotfixId}/testing/results
  • POST /v2/live-ops/hotfixes/{hotfixId}/testing/approve-deployment

Operator Flow#

  1. Register a hotfix candidate after the signed data-only manifest is ready.
  2. Run the required automated regression tests for balance, exploit, data integrity, and smoke coverage.
  3. Submit result evidence URIs for every required regression test.
  4. Approve deployment only through evaluateV2HotfixTestingGate.
  5. Block deployment on any missing, blocked, or failed required regression result.

Gates#

  • hotfix-testing-pipeline-package
  • hotfix-testing-pipeline-automated-regression
  • hotfix-testing-pipeline-before-deployment
  • hotfix-testing-pipeline-deployment-gate
  • hotfix-testing-pipeline-blocks-failure
  • hotfix-testing-pipeline-validation
  • hotfix-testing-pipeline-ci-wired

Verification#

sh
pnpm --filter @v2/hotfix-testing-pipeline-service test
pnpm --filter @v2/hotfix-testing-pipeline-service typecheck
pnpm --filter @v2/hotfix-testing-pipeline-service lint
pnpm --filter @v2/hotfix-testing-pipeline-service build
python3 V2/ue/Tools/check-v2-hotfix-testing-pipeline.py