Amoenus / Amoenus/waycloak

epic: ship the v0.4.0 optional eBPF node-data-plane preview

Open
#6 0 comments 0 reactions 0 assignees View on GitHub
enhancement
Dominant language
Go
Stars
1
Forks
0
Avg merge
18m
Merged PRs (30d)
19

Description

## Outcome

Research #65 and #34 selected the prototype-release outcome and E2 architecture. v0.4.0 is an optional developer preview: a chained CNI creation-time handoff installs Pod-parent cgroup eBPF default-deny and a prepared-node agent adopts the exact UID/generation state. The supported nftables/netlink sidecar remains the default; there is no fallback.

PRD: `docs/product/release-scope-v0.4.md`
Research: `docs/research/ebpf-data-plane.md`
Decision: ADR 0024
Draft PR: #106

## Ordered implementation graph

1. #107 — freeze API, status, conformance, and threat boundary.
2. #108 — prove exact containerd CNI UID/netns/cgroup deny-before-start handoff.
3. #109 — implement node capability and eBPF link/pin lifecycle ownership.
4. #110 — prove node ownership of VXLAN, routes, DNS, health, and drift repair.
5. #111 — implement explicit preview admission, scheduling, status, and no fallback.
6. #112 — package atomic prepared-node install, upgrade, rollback, and uninstall.
7. #113 — run equivalent default/tuned-default/preview performance and footprint study.
8. #114 — certify the exact signed mixed-mode release in the homelab.

#108 and #107 can begin after the research PR is accepted. #109 depends on the handoff proof. #110 is the sidecar-reduction and threat-model gate. #111 consumes the frozen contract and capability status. #112 packages only proved behavior. #113 requires a complete equivalent path. #114 is the final cutoff.

## Release cutoff

The preview ships only if it owns a complete declared feature subset, removes the privileged networking sidecar or demonstrates another accepted material benefit, passes backend-neutral fail-closed lifecycle tests on amd64 and arm64, coexists with ordinary sidecar workloads, and has safe CNI rollback. Unsupported features are rejected. If a gate remains unproved, omit the preview rather than weaken it.

Contributor guide

Open the contributing guide

Research direction

Start by reading docs/product/release-scope-v0.4.md, docs/research/ebpf-data-plane.md, ADR 0024, and draft PR #106. This issue is an epic with work split across #107-#114; done means the ordered preview gates are proven or the preview is omitted, not a single newcomer-sized patch.

Written by the indexing model from the issue text.

Assessment

Tech stack
go, kubernetes, linux
Domain
infrastructure, networking, security
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
15/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.