Skip to content

flow-filter update for dst_vpcd lookup fallback with flow table#1264

Merged
qmonnet merged 10 commits intopr/fredi/nat_use_casesfrom
pr/qmonnet/overlap-again
Feb 9, 2026
Merged

flow-filter update for dst_vpcd lookup fallback with flow table#1264
qmonnet merged 10 commits intopr/fredi/nat_use_casesfrom
pr/qmonnet/overlap-again

Conversation

@qmonnet
Copy link
Member

@qmonnet qmonnet commented Feb 4, 2026

Completing #1257

  • The first commit is a fix for the last commit in Re-add flow-table-based dst_vpcd lookup in case of prefixes overlap #1257, and could probably be merged into it.

  • Then we wrap the lookup result in an enum that supports a MultipleMatch case, and we update the packet processing accordingly.

  • After that we update the flow-filter stage to build this MultipleMatch case. This includes re-introducing splitting for prefixes with partial overlap, which I think will help us for the follow-up work on port forwarding.

  • We adjust the peerings validation step to allow overlapping prefixes, provided they use stateful NAT.

  • We add the unit tests back. We like tests.

@qmonnet qmonnet added the area/nat Related to Network Address Translation (NAT) label Feb 4, 2026
@qmonnet qmonnet force-pushed the pr/qmonnet/overlap-again branch 3 times, most recently from afe3337 to 04fa642 Compare February 6, 2026 16:30
@qmonnet qmonnet force-pushed the pr/fredi/nat_use_cases branch from 50d68da to 5b0b995 Compare February 6, 2026 21:30
@qmonnet qmonnet force-pushed the pr/qmonnet/overlap-again branch from 04fa642 to 0217454 Compare February 6, 2026 21:32
@qmonnet qmonnet marked this pull request as ready for review February 6, 2026 21:42
@qmonnet qmonnet requested a review from a team as a code owner February 6, 2026 21:42
@qmonnet qmonnet requested review from Fredi-raspall, mvachhar and sergeymatov and removed request for a team and sergeymatov February 6, 2026 21:42
@qmonnet
Copy link
Member Author

qmonnet commented Feb 6, 2026

I think the changes are ready to review. Note that this is a big PR, although most commits should remain pretty simple. Parts of it are re-adding some code that we removed, parts of it are new.

The first commit may be squashed with the commit on the top of the merge branch (it's on purpose that lint-commitlint.yml doesn't pass at the moment).

Signed-off-by: Quentin Monnet <qmo@qmon.net>
This will allow us to handle the case when we have multiple matching
possible destination VPCs for a packet in the flow-filter lookup, to
support some overlap of publicly-exposed prefixes between peerings. The
current commit only adds the enum with a single variant, we'll add a new
variant in a follow-up commit.

This is somewhat of a revert of commit d588e14
("chore(flow-filter): Remove code for exposed IP overlap support").

Signed-off-by: Quentin Monnet <qmo@qmon.net>
For the destination VPC lookup, support returning a "MultipleMatches"
variant indicating that the destination is ambiguous, and that looking
up in the flow-filter table without additional state context from the
flow table is not enough to provide a definitive answer.

Based on this return value, we adjust the processing for the packet: if
we find no destination VPC at all, we drop it immediately. When we get
MultipleMatches instead, we fall back to the flow table lookup.

Note that we don't actually exercise this code yet, because we never
build the case where we have multiple matches in the flow-filter table.
This will come in a follow-up commit.

Signed-off-by: Quentin Monnet <qmo@qmon.net>
In preparation for allowing support again for some cases of overlapping
prefixes, adjust the update() method for DstConnectionData objects so it
accepts overwriting a value, when both the old and new value refer to
multiple matches for the destination VPC lookup.

Signed-off-by: Quentin Monnet <qmo@qmon.net>
Generate "MultipleMatches" enum variants to populate the table for the
destination VPC discriminant lookup for prefixes that overlap across
peerings, so we can handle this specific case and fall back to the flow
table lookup for trying to determine the actual destination VPC when the
result is otherwise ambiguous.

Note that prefix overlap is still forbidden at the validation step, so
the related code remains unused in practice for now.

Signed-off-by: Quentin Monnet <qmo@qmon.net>
In preparation for splitting overlapping prefixes to support overlapping
again, this time with "default"-destination expose blocks, rework the
processing of a peering to add it to the context table for the
flow-filter stage.

In particular, we want to dissociate the processing of the default
expose from the processing of the prefixes from regular exposes, because
for the latter case we want to work with list of prefixes
(local_prefixes, remote_prefixes) rather than looping over exposes. This
will help with handling lists of split prefixes in a follow-up commit.

This reapplies some elements from commit d588e14
("chore(flow-filter): Remove code for exposed IP overlap support").

Signed-off-by: Quentin Monnet <qmo@qmon.net>
Add support partial overlap between exposed prefixes, by splitting
prefixes into smaller segments that are either fully overlapping (and
can share common destination information), or not overlapping at all.

This is a partial and updated reapply of commit d588e14
("chore(flow-filter): Remove code for exposed IP overlap support").

Signed-off-by: Quentin Monnet <qmo@qmon.net>
The motivation is to better troubleshoot flow table lookups: printing
the table in Debug mode is particularly tedious because of the circular
dependencies inside the allocated NAT resources (ports linking to IPs
linking to allocator containing the ports etc.). The new dump format is
sooo much easier to work with.

Note that we can't implement Display for FlowTable's values directly,
because the type is not defined in the flow-info crate (we use
NatFlowState<I> objects that are defined only in the "nat" crate, which
depends on flow-info, and we can't introduce a circular dependency). So
we make FlowInfoItem require the Display trait as well, to make sure we
can leverage it when printing values in FlowTable's implementation for
Display.

We also improve the Display implementation for NatFlowState and
FlowKeyData, and add the one for FlowKey, as all of them are used for
FlowTable.

Signed-off-by: Quentin Monnet <qmo@qmon.net>
If we consider VPC 1 peered with both VPC 2 and VPC 3, with VPC 2 and
VPC 3 exposing the same prefix to VPC 1, we have an issue for
determining the destination VPC. We've been preventing this situation to
happen by rejecting overlap at the validation step.

However, if VPC 2 and VPC 3 both use stateful NAT, then we'll create a
flow table entry when either of these send a packet, and we may be able
to determine the destination VPC based on that entry. So we enable
overlap again, at the condition that both exposes containing the
overlapping prefixes use stateful NAT.

We had this support in the past, we're only re-introducing the feature.

Signed-off-by: Quentin Monnet <qmo@qmon.net>
Following the recent re-introduction of support for overlapping prefixes
when involved expose blocks use stateful NAT, re-introduce the relevant
unit tests in the flow-filter and nat crates.

This is a partial (rebased) reapply of commit 514646a
("chore(flow-filter): Remove code for exposed IP overlap support").

Signed-off-by: Quentin Monnet <qmo@qmon.net>
@qmonnet qmonnet force-pushed the pr/fredi/nat_use_cases branch from 5b0b995 to b8c8518 Compare February 9, 2026 16:44
@qmonnet qmonnet force-pushed the pr/qmonnet/overlap-again branch from 0217454 to 32f0b55 Compare February 9, 2026 16:45
@qmonnet qmonnet merged commit c7b016c into pr/fredi/nat_use_cases Feb 9, 2026
21 of 27 checks passed
@qmonnet qmonnet deleted the pr/qmonnet/overlap-again branch February 9, 2026 17:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/nat Related to Network Address Translation (NAT)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants