@@ -286,14 +286,49 @@ Rust tests that still apply. Run the Podman-backed Rust CLI e2e suite:
286286mise run e2e:podman
287287```
288288
289- Run the portable subset in a disposable rootless Podman guest:
289+ Run the portable subset in a disposable rootless Podman guest. Stage matching
290+ candidate CLI and gateway RPMs at ` artifacts/packages/rpm/openshell.rpm ` and
291+ ` artifacts/packages/rpm/openshell-gateway.rpm ` ; ` build-artifacts ` builds the
292+ binary, runtime-image, and test inputs but does not build these packages:
290293
291294``` shell
292295nix run .# build-artifacts
293- nix run .# tmachine -- test fedora-podman-rootless binaries e2e-podman
294- nix run .# tmachine -- test fedora-podman-rootless binaries driver-podman
296+ nix run .# tmachine -- test fedora-podman-rootless rpm e2e-podman
297+ nix run .# tmachine -- test fedora-podman-rootless rpm driver-podman
295298```
296299
300+ The driver suites also support the ` binaries ` installer. The shared installer
301+ roles save the active gateway configuration, registration name, service scope,
302+ service owner, and network name in ` /var/lib/openshell-test/gateway.yaml ` .
303+ Suites resolve ` openshell ` from PATH and use that registration, including the
304+ packaged gateway's HTTPS client credentials. Namespace fixtures modify the
305+ installed TOML and restart its system or user service. Package metadata points
306+ to the service owner's XDG ` gateway.toml ` , which can be absent when the service
307+ uses defaults and ` gateway.env ` . The default namespace comparison preserves
308+ that state; configured profiles create a minimal versioned TOML override only
309+ if the package has not seeded one.
310+
311+ Failure diagnostics select the matching journal unit and user ID. Missing
312+ metadata or credentials fail the run; suites do not replace package setup with
313+ an HTTP gateway.
314+
315+ Before merging harness changes, run all three driver-specific combinations
316+ locally: rootful RPM ` driver-podman ` , rootless RPM ` driver-podman ` , and rootless
317+ RPM ` e2e-podman ` . Use matching candidate packages, runtime images, and test
318+ archives. Add ` test:e2e ` to the PR and check that its branch integration jobs ran
319+ and passed; a successful workflow with skipped jobs does not validate these
320+ changes.
321+
322+ Ansible sources participate in tmachine's installation cache
323+ hash, so older cached installations are rebuilt with this metadata.
324+
325+ The ` driver-podman ` and ` e2e-podman ` suites support rootful and rootless Podman.
326+ Rootful tmachine setup grants the ` tmachine ` group access to the Podman socket
327+ so workload image loading and E2E tests run as the local user.
328+ DEB and RPM installers share the gateway role; available environments pair
329+ DEB with Ubuntu/Docker and RPM with Fedora/Podman. A DEB/Podman run requires an
330+ Ubuntu Podman environment.
331+
297332Print the exact tmachine archive selection as a shell ` PODMAN_CI_TESTS ` array:
298333
299334``` shell
0 commit comments