Add server launch QA gate
This commit is contained in:
@@ -855,7 +855,7 @@ Target deliverable: A small group can join a server, spawn into one biome, gathe
|
|||||||
## 0.1.Q MVP QA Gates
|
## 0.1.Q MVP QA Gates
|
||||||
|
|
||||||
- [x] Can launch packaged client. Added an MVP QA gate that requires the Windows package script, packaged executable, installed investor launchers, and the real-GPU visual QA readiness check before the client launch gate qualifies.
|
- [x] Can launch packaged client. Added an MVP QA gate that requires the Windows package script, packaged executable, installed investor launchers, and the real-GPU visual QA readiness check before the client launch gate qualifies.
|
||||||
- [ ] Can launch server.
|
- [x] Can launch server. Added an MVP QA gate for the Linux gameplay host requiring the true dedicated build path or current binary-engine fallback, deployment to `/opt/agrarian/server`, `agrarian-game-server.service` active state, UDP `7777` listener evidence, and Ground Zero map browse evidence.
|
||||||
- [ ] Can connect two clients.
|
- [ ] Can connect two clients.
|
||||||
- [ ] Can gather resources.
|
- [ ] Can gather resources.
|
||||||
- [ ] Can craft a fire.
|
- [ ] Can craft a fire.
|
||||||
|
|||||||
@@ -23,3 +23,29 @@ Required evidence:
|
|||||||
- Any full visual pass stores notes under `Saved\VisualQA\InvestorDemo`.
|
- Any full visual pass stores notes under `Saved\VisualQA\InvestorDemo`.
|
||||||
|
|
||||||
This gate is client-only. It does not require multiplayer server deployment.
|
This gate is client-only. It does not require multiplayer server deployment.
|
||||||
|
|
||||||
|
## Server Launch
|
||||||
|
|
||||||
|
The server launch gate proves the MVP gameplay host can start the current
|
||||||
|
server-compatible package and expose the Unreal gameplay port.
|
||||||
|
|
||||||
|
Current MVP launch path:
|
||||||
|
|
||||||
|
- Prefer the true Linux dedicated-server target when a server-capable Unreal
|
||||||
|
engine is available:
|
||||||
|
`Scripts/BuildLinuxDedicatedServer-Windows.bat`
|
||||||
|
- Until then, use the binary-engine fallback:
|
||||||
|
`Scripts/PackageLinuxGameServerFallback-Windows.bat`
|
||||||
|
- Deploy the produced package to `/opt/agrarian/server`.
|
||||||
|
- Launch through `/opt/agrarian/server/AgrarianGameServer.sh`.
|
||||||
|
- Manage the host with `agrarian-game-server.service`.
|
||||||
|
|
||||||
|
Required evidence:
|
||||||
|
|
||||||
|
- `systemctl is-active agrarian-game-server.service` reports `active`.
|
||||||
|
- `ss -lunp` shows `AgrarianGame` listening on `0.0.0.0:7777/udp`.
|
||||||
|
- The journal shows the Ground Zero map browse started.
|
||||||
|
- The runbook explains the true dedicated target and fallback path.
|
||||||
|
|
||||||
|
This gate is server-relevant and requires multiplayer server verification when
|
||||||
|
server launch tooling or deployed package contents change.
|
||||||
|
|||||||
@@ -0,0 +1,59 @@
|
|||||||
|
#!/usr/bin/env python3
|
||||||
|
"""Verify the MVP server launch QA gate is documented and scripted."""
|
||||||
|
|
||||||
|
from pathlib import Path
|
||||||
|
|
||||||
|
|
||||||
|
ROOT = Path(__file__).resolve().parents[1]
|
||||||
|
ROADMAP = ROOT / "AGRARIAN_DEVELOPMENT_ROADMAP.md"
|
||||||
|
QA_DOC = ROOT / "Docs" / "QA" / "MvpQaGates.md"
|
||||||
|
RUNBOOK = ROOT / "Docs" / "Ops" / "DedicatedServerBuildRunbook.md"
|
||||||
|
DEDICATED_BAT = ROOT / "Scripts" / "BuildLinuxDedicatedServer-Windows.bat"
|
||||||
|
FALLBACK_BAT = ROOT / "Scripts" / "PackageLinuxGameServerFallback-Windows.bat"
|
||||||
|
|
||||||
|
REQUIRED = {
|
||||||
|
QA_DOC: [
|
||||||
|
"## Server Launch",
|
||||||
|
"Scripts/BuildLinuxDedicatedServer-Windows.bat",
|
||||||
|
"Scripts/PackageLinuxGameServerFallback-Windows.bat",
|
||||||
|
"/opt/agrarian/server/AgrarianGameServer.sh",
|
||||||
|
"agrarian-game-server.service",
|
||||||
|
"0.0.0.0:7777/udp",
|
||||||
|
"Ground Zero map browse started",
|
||||||
|
],
|
||||||
|
RUNBOOK: [
|
||||||
|
"Scripts\\BuildLinuxDedicatedServer-Windows.bat",
|
||||||
|
"Scripts\\PackageLinuxGameServerFallback-Windows.bat",
|
||||||
|
"Deploy the fallback package to `/opt/agrarian/server`",
|
||||||
|
"-server -port=7777 -NullRHI -nosound",
|
||||||
|
],
|
||||||
|
DEDICATED_BAT: [
|
||||||
|
"AgrarianGameServer Linux Development",
|
||||||
|
"LINUX_MULTIARCH_ROOT",
|
||||||
|
"Builds\\LinuxServerDevelopment",
|
||||||
|
],
|
||||||
|
FALLBACK_BAT: [
|
||||||
|
"Builds\\LinuxGameDevelopment",
|
||||||
|
"-platform=Linux",
|
||||||
|
"BuildCookRun",
|
||||||
|
],
|
||||||
|
ROADMAP: [
|
||||||
|
"[x] Can launch server.",
|
||||||
|
],
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
|
def main() -> None:
|
||||||
|
missing: list[str] = []
|
||||||
|
for path, snippets in REQUIRED.items():
|
||||||
|
text = path.read_text(encoding="utf-8")
|
||||||
|
for snippet in snippets:
|
||||||
|
if snippet not in text:
|
||||||
|
missing.append(f"{path.relative_to(ROOT)} missing {snippet!r}")
|
||||||
|
if missing:
|
||||||
|
raise SystemExit("FAILED: " + "; ".join(missing))
|
||||||
|
print("OK: server launch QA gate is documented and tied to build scripts.")
|
||||||
|
|
||||||
|
|
||||||
|
if __name__ == "__main__":
|
||||||
|
main()
|
||||||
Reference in New Issue
Block a user