Repository navigation
test(podman): run existing Podman behavioral e2e coverage in CI #3712
Description
User Story
As an OpenShell maintainer, I want the existing Podman behavioral end-to-end tests to run in required CI and release qualification, so that Podman-specific networking, lifecycle, policy, identity, resource, and provider regressions cannot merge while applicable tests remain unscheduled.
Problem Statement
OpenShell currently has a required bundled-Podman branch job, but it runs a hard-coded PODMAN_CI_TESTS allowlist rather than the full set of targets eligible under the e2e-podman feature.
There are currently 39 eligible Rust test targets. The curated CI set selects 20 and omits 19. Two omissions are intentionally ignored performance benchmarks, leaving 17 executable targets outside Podman behavioral CI.
Twelve of those 17 are shared, driver-independent test targets that run from the same source files in Docker and Kubernetes CI but are explicitly omitted from Podman CI:
port_forwardprovider_auto_createproxy_egress_pipelinesandbox_labelssandbox_lifecyclesandbox_templatessettings_managementsynctransparent_tcpupload_createwebsocket_conformanceworkspace_lifecycle
Five are Podman-specific targets whose behavior cannot be covered by another driver:
podman_oci_identitypodman_preflightpodman_resource_limitspodman_usernsprovider_refresh_handles
podman_preflight may need a separate lightweight invocation because it expects the standalone openshell-driver-podman binary. The older podman_userns Rust target should either run or be removed as superseded by the newer rootful/rootless tmachine user-namespace suite.
The bundled Podman behavioral job is also present only in the branch workflow. Release Dev and Release Tag do not run the bundled Podman behavioral suite.
This is a follow-up to #3663. PR #3690 added the resource-limit and daemon-failure targets and broadened rootful user-namespace testing, but the new Rust targets were not added to PODMAN_CI_TESTS. PR #3606 restored a bundled Podman branch lane after the host.openshell.internal regression, but intentionally limited it to targets known to pass at that time.
Impact / Why This Matters
This scheduling gap has already allowed a Podman host-networking regression to merge even though relevant e2e coverage existed. It creates the same exposure for transparent networking, proxy enforcement, port forwarding, lifecycle cleanup, resource enforcement, OCI identity, workspace operations, and credential refresh.
The current workaround is for contributors to know that mise run e2e:podman is broader than required CI and run it manually on a compatible Linux Podman host. That is insufficient because:
- contributors reasonably treat required CI as the supported regression suite;
- the omission is not visible from individual test files or Cargo feature gates;
- many developers do not have a compatible rootless Podman/AppArmor/pasta environment;
- Release Dev and Release Tag can qualify artifacts without bundled Podman behavioral coverage; and
- newly added Podman-eligible targets can silently remain outside CI.
Acceptance Criteria
- All 12 shared executable targets listed above run against the bundled Podman driver in required branch CI and pass reliably.
-
podman_oci_identity,podman_resource_limits, andprovider_refresh_handlesrun against a real Podman-backed OpenShell gateway in CI. -
podman_preflightruns in CI with the standalone Podman driver artifact and verifies the bounded, actionable daemon-unavailable failure path. -
podman_usernsis either enabled or removed with its assertions demonstrably covered by the rootful/rootlessdriver-podmantmachine suite. - The two intentionally ignored performance targets remain documented as manual benchmarks rather than appearing as unexplained CI omissions.
- Release Dev and Release Tag include bundled Podman behavioral qualification, or a documented release-gating replacement provides equivalent coverage.
- CI contains an inventory/reachability check that fails when a new non-ignored
e2e-podmantarget is not selected by a workflow, unless it appears in a checked-in exclusion list with a rationale and tracking issue. - Job names and summaries report the selected test set or target count so a narrow Podman job cannot be mistaken for the complete suite.
- Rootless and rootful scope is explicit. Any behavioral targets not run in both modes have a documented technical reason and tracking issue.
Reproduction Steps
- Compare the
[[test]]declarations and auto-discovered files undere2e/rust/tests/that are eligible with thee2e-podmanfeature againstPODMAN_CI_TESTSine2e/rust/e2e-podman.sh. - Observe that 39 targets are eligible while only 20 are selected by
OPENSHELL_E2E_PODMAN_TEST_SET=ci. - Observe that 17 non-benchmark targets are omitted.
- Inspect
.github/workflows/branch-e2e.ymland observe that required branch CI invokesmise run e2e:podman:ci, not the fullmise run e2e:podmansuite. - Inspect
.github/workflows/release-dev.ymland.github/workflows/release-tag.ymland observe that neither has a bundled Podman behavioral job.
Environment
- OpenShell:
mainat924486805 - Required Podman lane: Ubuntu 26.04, Podman 5.7.0, rootless/pasta
- Relevant files:
e2e/rust/e2e-podman.sh,e2e/rust/Cargo.toml,.github/workflows/branch-e2e.yml,.github/workflows/e2e-podman-test.yml
Related Work
- Podman sandboxes cannot reach host.openshell.internal #3605 — Podman
host.openshell.internalregression - fix(podman): restore host gateway alias mediation #3606 — restored host-gateway mediation and a curated bundled Podman CI lane
- test(podman): close CI coverage gaps in Podman compute driver testing #3663 — audited and added Podman driver coverage
- test(podman): close rootful userns, resource-limit, and daemon-failure CI gaps #3690 — added rootful userns, resource-limit, and daemon-failure tests
Activity
politerealism commentedon Sep 27, 2026
Looking at this one
politerealism commentedon Sep 27, 2026
Plan and order of operations
This issue overlaps significantly with open PR #3637 ("test(e2e): run podman suite with tmachine", author elezar), which independently adds a tmachine-based
e2e-podmannextest archive (43 tests passing) covering most of the 39 eligiblee2e-podmantargets, removespodman_userns.rsas superseded by thedriver-podmantmachine suite (resolving that acceptance criterion directly), and depends on PR #3597 (migratessync.rscoverage into conformance scenarios). Both #3637 and #3597 are currently green in CI but showmergeable: CONFLICTINGand need a rebase before they can land.Order of operations for this work:
tests/ansible/playbooks/drivers/podman/e2e.yaml,tests/artifacts.nix) until they're onmain.podman_preflightinto CI via the existingpodman-external-driver-e2ejob's already-exported driver binary artifact (it never runs anywhere today because that job's mise task disables the cargo-test step for other reasons).tasks/scripts/check-podman-e2e-coverage.sh, modeled oncheck-cargo-lockfiles.sh) that fails CI if a newe2e-podman-eligible test target isn't accounted for in eitherPODMAN_CI_TESTSor a documented exclusion — this directly satisfies the acceptance criterion preventing silent future omissions like this one.CI.md.podmanE2eFollowUpBinariesexclusion list; file tracked follow-up issues for the exclusions that need distinct scope work (sandbox_lifecycleconformance migration,podman_oci_identitySPIFFE fixture plumbing,provider_refresh_handles's own purpose-built suite), and linktransparent_tcp's exclusion to the existing test(e2e): restore musl DNS probe coverage for guest prebuilt artifacts #3009 rather than duplicating it.provider_auto_create,proxy_egress_pipeline,websocket_conformance,workspace_lifecycle) against a live tmachine environment.e2e-podmantestsuite (its current playbook hardcodes rootless-only values instead of using thetmachine_container_runtimerole the waydriver-podman's playbooks already do).driver-podman/e2e-podmaninto Release Dev and Release Tag qualification, mirroring the existingprovider-refreshjob pattern.PRs for Track A will follow this comment. Track B PRs will follow once #3637/#3597 land.
politerealism commentedon Sep 29, 2026
Status update given everything that's landed since the plan above:
podman_preflightis resolved via test(podman): move podman_preflight into driver-podman integration tests #3783 (reopened and approved by @elezar,/ok-to-testapplied, pending merge) rather than the original test(podman): wire podman_preflight into CI and add a Podman e2e coverage check #3749 approach.podman_usernsis resolved via test(e2e): run podman suite with tmachine #3637 (superseded by thedriver-podmantmachine suite).podman_resource_limitsnow runs for real against a live gateway via test(e2e): run podman suite with tmachine #3637's tmachinee2e-podmanarchive.@elezar — given #3460 (Nix/tmachine target-state doc) and the string of
test(conformance)/test(tmachine)PRs you've got in flight (#3766, #3768, #3792, #3795, #3839, etc.), it looks like most of the remaining shared-target and driver-specific coverage gaps here (the 6 of 12 shared targets still excluded,podman_oci_identity,provider_refresh_handles) will fall out of that migration rather than needing separate Podman-specific CI wiring. To avoid duplicating effort, I'm deliberately not touching that migration.What I'll pick up next instead, since it's orthogonal to the conformance/driver-specific split:
e2e-podmantmachine archive (onlyfedora-podman-rootlessruns it;podman_resource_limitsspecifically would benefit from a rootful leg since it reads real cgroup v2 state and rootless cgroup delegation is the harder/riskier case).Flag anything above that's already in flight or planned elsewhere so we don't collide again.
elezar commentedon Sep 30, 2026
Thanks @politerealism. I am busy constructing a plan to migrate the
e2e/rusttests that are covered by thee2e-podmanfeature so that we can tackle that in parallel.docs(podman): document and track the e2e-podman rootful coverage gap
politerealism commentedon Oct 6, 2026
Update 2026-10-06: Following up on the 2026-09-29 note above where I deferred the
e2e/rust→conformance migration to @elezar to avoid duplicating his in-flight work.Coordinated directly with Evan today on the 11 general-conformance candidates I'd flagged in a research pass on #3460. He confirmed his own plan (verify under Podman, relax gates on
provider_refresh_handles.rs/websocket_conformance.rs,sandbox_labels.rsneeds nothing) and suggested migrating applicable ones straight intotests/suites/conformance/rather than gate-relaxing in place — and invited a partial migration on my end rather than a hard handoff.Migrated so far (branch not yet opened as a PR, pending final review on my end):
workspace_lifecycle.rs→workspace-lifecycle/workspace-terminatingscenariosupload_create.rs→file-transfer/create-uploadscenario (grouped with the existing file-transfer family)provider_auto_create.rs→provider-auto-createscenariosandbox_templates.rs→ 4 scenarios (lifecycle, get-after-delete, duplicate-name, missing-template)settings_management.rs→settings-managementscenarioAll verified against an ephemeral Podman gateway. Will reference #3954 (not this issue) when the PR opens, since that's the umbrella tracking issue for the RFC-0016 testing-strategy work this falls under.
Two things surfaced along the way worth noting here:
port_forward.rsdoesn't fit the conformance harness's CLI request/response model (needs a long-lived background SSH-tunnel process + raw socket I/O) — holding that one for Evan's input on whether that pattern belongs onOpenShellRunneror as a scenario-local bypass.file_transfer.rsconformance scenarios (round-trip,git-filtering) currently failing against main — pre-existing, unrelated to this migration, flagged to him separately.test(podman): install script and capture network diagnostics in the e…
politerealism commentedon Oct 12, 2026
Probe results: which excluded e2e-podman binaries run in the tmachine guest (2026-10-12)
To see how the binaries on
podmanE2eFollowUpBinariesactually behave, I used a throwaway draft PR (#4386, not for merge) that lifted 14 of them and ran the rootless Fedorae2e-podmanjob twice (runs 37982991494 and 38246241655). The second run also installedutil-linux-scriptin the guest and captured network diagnostics on failure. Thanks to Taylor and Simon for running it.#[ignore]benchmarks)Passed in both runs (10 binaries, 14 tests):
credential_gating(slowest, about 74 s),forward_proxy_graphql_l7,forward_proxy_jsonrpc_l7,forward_proxy_l7_bypass,host_gateway_alias,landlock,no_proxy,podman_oci_identity,provider_refresh_handles,websocket_conformance. I opened #4422 to stop excluding them.sandbox_lifecycle: four of its 19 tests failed in run 1 withspawn openshell sandbox create: No such file or directory, because the PTY helper runsscriptand the guest doesn't have it. With the package installed, all 19 passed in run 2. #4423 does that.Still failing (same five in both runs), and what I could see:
driver_config_volume(2 tests): the gateway rejects the create with "caller driver config is disabled". The tmachine gateway config doesn't enableallow_driver_configorenable_bind_mounts; the wrapper scripts do. It looks like a Podman driver-suite fixture, not something to turn on in the shared gateway config.proxy_egress_pipeline(1 of 11 tests):explicit_allowed_ips_and_implicit_ip_literals_succeed_transparentlytimes out on both requests. The other ten pass.transparent_tcp(2 tests): one can't find the musl probe source in the guest (that's test(e2e): restore musl DNS probe coverage for guest prebuilt artifacts #3009), and the other gets an NXDOMAIN from the policy DNS for its fixture hostname.For the middle one and the NXDOMAIN, I have a guess, not a conclusion. The diagnostics show the guest has no route to the
tmachinebridge subnet (10.89.0.0/24) in its main network namespace. In rootless Podman that bridge lives in Podman's own namespace, so container IPs may not be reachable from where the supervisor runs. If so, both might pass on rootful, which the archive doesn't run today (#4163). A rootful run would tell us.Not lifted, on purpose:
podman_gateway_start,podman_corporate_proxy,local_driver_token_restartandprovider_token_exchange. In tmachine the wrapper-setOPENSHELL_E2E_GATEWAY_*and SPIFFE variables aren't set, so they would skip silently and report a pass. They seem to belong with the disruption and fixture work in RFC 0016.Silent skips in tests that already run (found by reading the code):
edge_tunnel_e2e's second test and the gateway-restart leg ofssh_host_identityboth return early and report a pass, andpodman_resource_limitshas a redundant driver check. Worth deciding whether to fix or waive them.If both PRs land the exclusion list goes from 20 entries to 9. Suggested next steps, happy to adjust: move
driver_config_volumeinto the Podman driver suite with a fixture, and look at the networking guess via #4163. Would it be better to open a separate issue for the rootless networking question, or keep it here?test(podman): explain why each remaining e2e binary is excluded
matthewgrossman commentedon Oct 12, 2026
Heads-up on overlap with the
podman_oci_identityentry: #3931 (tracked in #4346, under #2422) moves the OCIUSER/WORKDIRchecks from the Docker-onlycustom_imagetest into a newoci-imagefeature suite undertests/suites/features. It runs on the Docker rootful, Podman rootful, and Podman rootless tmachine lanes, plus ARM64 Docker.Every scenario in that suite also checks that the workload has no capabilities, has no-new-privileges set, and cannot read the sandbox credentials, and that a custom
WORKDIRis not a mount. So #3931 trimspodman_oci_identityto the checks that need Podman container inspection: the pinned image ID and workload/supervisor isolation.A trial merge of #4422 into #3931's current head has no conflicts, and the two fit together: #4422 runs the trimmed
podman_oci_identityon rootless tmachine.matthewgrossman commentedon Oct 12, 2026
Correction to my comment above: #3931 now also moves the pinned image ID, no-network, credential-mount, and separate-supervisor checks into the shared
oci-imagesuite, so they run on Docker and Podman.podman_oci_identitykeeps only the Podman supervisor identity and capability checks. #3931 is ready for review.