autonomic-bot
6841048aae
- functional/_mumble_proto.py: stdlib Mumble TLS protocol client (adapted from corpus mumble_connect.py) - 3 parity ports: test_tcp_health, test_protocol_handshake (channel presence+ServerSync), test_web_client - 2 NEW recipe-specific (P3): welcome-text + max-users config round-trips over the protocol - P4: ops.py + test_backup/test_restore seed ci_marker in /data/mumble-server.sqlite (recipe's own backupbot DB), busy_timeout for live-server locks - test_install overlay: voice server listening on 64738 (beyond web-sidecar readiness) - recipe_meta: COMPOSE_FILE=compose.yml:mumbleweb:host-ports; WELCOME_TEXT/USERS markers - PARITY.md mapping table Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
51 lines
3.7 KiB
Markdown
51 lines
3.7 KiB
Markdown
# mumble — recipe-maintainer → cc-ci parity (Phase 2 P2)
|
|
|
|
Source corpus: `references/recipe-maintainer/recipe-info/mumble/tests/` (`/srv/recipe-maintainer/
|
|
recipe-info/mumble/`). mumble is a TLS **voice** server (port 64738), not an HTTP app, plus an
|
|
optional `mumble-web` HTTP client overlay. cc-ci deploys it with
|
|
`COMPOSE_FILE=compose.yml:compose.mumbleweb.yml:compose.host-ports.yml` (recipe_meta.EXTRA_ENV):
|
|
the web overlay gives the generic harness an HTTP readiness/serving signal; the host-ports overlay
|
|
publishes 64738 on the cc-ci host so the on-host (cc-ci-run) protocol tests connect to
|
|
127.0.0.1:64738. Both overlays are shipped by the upstream recipe (documented deployment mode).
|
|
|
|
## Parity port mapping (P2 — every recipe-maintainer test has a comparable cc-ci test)
|
|
|
|
| recipe-maintainer test (`recipe-info/mumble/tests/`) | what it verifies | cc-ci test | same thing? |
|
|
|---|---|---|---|
|
|
| `health_check.py` | mumble server listening on TCP 64738 | `functional/test_tcp_health.py` | yes — TCP connect to 64738 (host-published) |
|
|
| `mumble_connect.py` | full TLS protocol handshake: TLS connect, server Version, auth accepted (no Reject), channel list present, ServerSync handshake completes, welcome text | `functional/test_protocol_handshake.py` (+ `functional/_mumble_proto.py`, adapted from the corpus's stdlib protobuf/protocol code) | yes — same handshake; asserts tls_connect + version + auth_accepted + channel presence + ServerSync |
|
|
| `web_client.py` | mumble-web client reachable over HTTPS, HTTP 200, page contains `Mumble` + `config.js`, valid HTML | `functional/test_web_client.py` | yes — same 200 + body markers (`Mumble`, `config.js`, `<!DOCTYPE html>`) |
|
|
|
|
No recipe-maintainer mumble test is omitted — all three are ported. No `DECISIONS.md` non-port
|
|
entry is needed for mumble.
|
|
|
|
## Recipe-specific functional tests (P3 — ≥2 beyond parity)
|
|
|
|
mumble has no REST "create-an-object" API; its characteristic behaviour is the voice-server control
|
|
protocol and its deploy-time server configuration. Both new tests are **config round-trips** that
|
|
prove our deploy-time configuration propagated into the running murmur server and is enforced/
|
|
delivered over the real protocol (version-independent — they assert OUR configured markers, not
|
|
hard-coded upstream values):
|
|
|
|
1. `functional/test_welcome_text_roundtrip.py` — deploys with a unique `WELCOME_TEXT` marker
|
|
(`recipe_meta.EXTRA_ENV` → `MUMBLE_CONFIG_WELCOMETEXT`); asserts that exact marker surfaces in the
|
|
server's ServerSync `welcome_text` delivered to a connecting client. (create config → read back.)
|
|
2. `functional/test_server_config_limits.py` — deploys with a distinctive non-default `USERS=42`
|
|
(max-users cap → `MUMBLE_CONFIG_USERS`); asserts the server's ServerConfig message reports
|
|
`max_users == 42` (and a well-formed `allow_html`), proving the recipe wires deploy-time
|
|
server-capacity policy into the running server.
|
|
|
|
## Backup data-integrity (P4 — real, recipe-aware)
|
|
|
|
`ops.py` + `test_backup.py` + `test_restore.py`: seed a `ci_marker` row into the recipe's own state
|
|
DB `/data/mumble-server.sqlite` (the exact file the recipe's backupbot hooks `.backup`/restore),
|
|
back up, drop the marker (mutate), restore, and assert the row returns as `original`. Writes use
|
|
`PRAGMA busy_timeout` to wait out the running murmur server's transient sqlite locks. The upgrade
|
|
tier seeds `upgrade-survives` and asserts it survives the prev→PR-head chaos crossover.
|
|
|
|
## Browser flow (P6)
|
|
|
|
Not applicable as a primary UX: mumble's core UX is the native desktop client over the voice
|
|
protocol (covered by the protocol handshake tests). The mumble-web HTTP UI is asserted via
|
|
`test_web_client.py` (HTTP, no interactive flow to drive). No Playwright test.
|