Skip to content

docs: Add implementation plan for VPC ingress sidecar - #310

Open
privateip wants to merge 1 commit into
mainfrom
docs/855-ingress-sidecar-plan
Open

docs: Add implementation plan for VPC ingress sidecar#310
privateip wants to merge 1 commit into
mainfrom
docs/855-ingress-sidecar-plan

Conversation

@privateip

Copy link
Copy Markdown
Contributor

Summary

datum-cloud/enhancements#855 asks for a sidecar that runs alongside Envoy Gateway pods, per the design accepted in datum-cloud/enhancements#851. This adds a written implementation plan mapping that sidecar's job onto this repo's existing internal/plumbing/vrf/internal/plumbing/srv6 primitives before any code is written.

It also resolves seven open engineering decisions surfaced while planning:

  • Teardown race: time-based grace period for v1, flagged for a proper long-term fix once both sides of the race (this sidecar and the Envoy Gateway extension server) exist and their real latency is observable.
  • Startup reconcile safety: inventory-before-reconcile, gated on the watch cache's first full sync.
  • Deployment injection contract with #856: recommend container name galactic-vrf, with latitude for the implementer to rename.
  • Backend health-checking: punted to a future issue — absent from the accepted design entirely, no owner.
  • Two required pre-merge kernel verifications: the seg6 encap route run from an Envoy Gateway pod's netns specifically, and end-to-end decap compatibility with the existing eBPF uSID datapath.
  • Cross-namespace HTTPProxy reference: noted as a dependency on #856/#857 with no action needed from this sidecar.

Test plan

  • Plan doc renders cleanly on GitHub (headings, tables, links)

Related to datum-cloud/enhancements#855

@privateip

Copy link
Copy Markdown
Contributor Author

Same failing CI that is tied to #302 and will require a rebase once it is merged

Adds a written implementation plan for datum-cloud/enhancements#855,
mapping the sidecar's role in the accepted HTTP Ingress for VPC
Networks design (enhancements#851) onto this repo's existing
internal/plumbing/vrf and internal/plumbing/srv6 primitives, and
resolving seven open engineering decisions surfaced while planning:
a time-based teardown grace period (flagged for longer-term
follow-up), inventory-before-reconcile startup safety, a recommended
container name for #856's deployment patch, punting backend
health-checking to a future issue, two required pre-merge kernel
verification steps (seg6 encap route from Envoy's netns, and eBPF
decap compatibility), and a noted (no-action) dependency on #856/#857
for cross-namespace HTTPProxy reference resolution.

Related to datum-cloud/enhancements#855

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@privateip
privateip force-pushed the docs/855-ingress-sidecar-plan branch from 5253d38 to 07b2066 Compare August 8, 2026 18:03
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.

Ingress sidecar for VPC backend connectivity

1 participant