Skip to content

[T-129] Remote worker (topology T2): worker-only compose file, TLS DB connection, setup guide verification #216

Open

Description

@CodewithJha

Task T-129 · Milestone M10 — Evaluation · Size S · Priority P2 · Epic #10

Implements NFR-SCAL-001 · NFR-DEP-001

Branch ci/t-129-remote-worker-topology-t2-worker — one task = one branch = one PR (doc 32 §6)

Summary

Provide docker/compose.worker.yaml for a second machine (k2d or gazebo worker) connecting to the main Postgres over TLS (sslmode=verify-full), artefact transfer via the configured store, and verify doc 29 §6 end-to-end.

Context / motivation

Scale-out beyond one laptop for EXP-01/04.

Scope

In scope

  • Doc 29 §6 updated with verified commands.

Implementation guidance

  • docker/compose.worker.yaml: services worker-k2d and worker-gazebo (profiles) using GHCR images; ROBOPROBE_DATABASE__URL points to the main host over WireGuard or an SSH tunnel (doc 29 §6, TM-09) with sslmode=verify-full and a mounted CA file; artefact root on a shared mount or via the configured store.
  • Confirm workers need only DB + artefact root (no API); document firewall rules and the pg_hba.conf restriction.
  • Standards: respect the layering contracts (doc 16 §2) and conventions in doc 34; no hard-coded tunables — thresholds/defaults come from typed settings (doc 27); no magic numbers (ruff PLR2004); public APIs typed (mypy strict) and documented.

Configuration keys

From the configuration reference (doc 27). Keys marked (new) must be added to the typed settings models and appear in the generated reference (T-003c).

  • database.url
  • database.sslmode (new)

Acceptance criteria

  • Two-machine run recorded in docs/evidence/T-129.md.
  • doc 29 §6 commands verified end-to-end and corrected.
  • No DB port exposed publicly in the documented setup.
  • Tests listed below added and green in CI; coverage of new code meets the gate in doc 18 §3.
  • Docs, config reference and CHANGELOG Unreleased updated where behaviour, keys or interfaces changed.
  • Definition of Done (doc 32 §3) satisfied.

Tests required

  • Manual verification + compose config lint in CI.

Dependencies

Blocked by: #200 (T-095), #97 (T-047)

Blocks: no other task (leaf)

Parallelization notes

Files / paths owned by this task — avoid editing other paths; shared files (pyproject.toml entry points, cli/main.py, api/routers/__init__.py, router.tsx, docker/compose.yaml, ci.yml) are append-only:

  • docker/compose.worker.yaml
  • docs/evidence/T-129.md

Independent.

Definition of Done

Per doc 32 §3 and AGENTS.md §5: lint, format, mypy strict and import-linter green; tests added and passing; docs updated; PR template completed with Closes #<this issue>; Conventional Commit messages referencing T-129 (doc 16 §6); commits authored only by the repository owner identity (AGENTS.md §4); CI green; reviewer checklist (doc 32 §5.1) satisfied.

References

Design docs: doc 29 §6 · doc 29 §5 · doc 31 §3

Requirements: NFR-SCAL-001 · NFR-DEP-001 (traceability: doc 28)

Metadata

Metadata

Assignees

No one assigned

    Labels

    area:deployDocker images, compose, release packagingarea:runnerQueue, workers, campaign orchestrationmilestone:M10M10 — Evaluationpriority:P2Important, not blockingsize:S<= 1 daytaskChild task of a milestone epictype:infraCI, build, deployment infrastructure

    Projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions