Skip to content

docs(deploy): add Podman deployment notes#63

Merged
CharmingGroot merged 1 commit into
release/v0.1from
docs/podman-deploy
Jul 22, 2026
Merged

docs(deploy): add Podman deployment notes#63
CharmingGroot merged 1 commit into
release/v0.1from
docs/podman-deploy

Conversation

@CharmingGroot

Copy link
Copy Markdown
Owner

What

Documents running pasu on Podman, split by layer.

  • pasu-proxy (cooperative, unprivileged): runtime-agnostic — podman run the OCI image and point the agent's base_url at it. Runs rootless fine.
  • pasu-egress (enforcing, eBPF cgroup_skb): Podman is cgroup-v2-native + daemonless, so the "attach to the target's cgroup" rule maps cleanly.
    • Rootful/privileged podman run --cgroupns host (direct analog of the self-guard/sidecar Docker paths).
    • Pod sidecar via podman play kube (shared pod cgroup = the k8s sidecar model).
    • Rootless Podman is the hard case — userns + cgroup delegation means cgroup-BPF attach still needs host privilege, so the enforcing layer expects rootful.

Honesty

Marked not run against a live Podman host — same disclaimer as the existing Kubernetes examples. The commands follow the shape of the verified Docker paths.

Scope

Docs only (docs/deployment.md + CHANGELOG). No code changes.

Podman is cgroup-v2-native and daemonless, so the cgroup_skb attach
requirement maps cleanly. Document the rootful/privileged podman run
path (with --cgroupns host), the pod-sidecar / podman play kube mapping,
and why rootless Podman only fits the cooperative proxy layer. Marked
untested-against-a-live-host, matching the Kubernetes examples.

Signed-off-by: Ho Geun Choi <ohyes9711@gmail.com>
@CharmingGroot
CharmingGroot merged commit 8b788d9 into release/v0.1 Jul 22, 2026
4 checks passed
@CharmingGroot
CharmingGroot deleted the docs/podman-deploy branch July 22, 2026 12:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant