Skip to content

Commit

Permalink
docs: Multi-Pool IPAM now partially supports iptables-based NAT
Browse files Browse the repository at this point in the history
With cilium#26397 merged, iptables-based masquerading can now be used together
with Multi-Pool IPAM, as long as `egressMasqueradeInterfaces` is set
too.

This commit adjusts the documentation to reflect that and improves the
wording of that section a bit.

Signed-off-by: Sebastian Wicki <sebastian@isovalent.com>
  • Loading branch information
gandro authored and borkmann committed Jul 3, 2023
1 parent 0447095 commit 970f881
Show file tree
Hide file tree
Showing 2 changed files with 8 additions and 6 deletions.
13 changes: 7 additions & 6 deletions Documentation/network/concepts/ipam/multi-pool.rst
Original file line number Diff line number Diff line change
Expand Up @@ -150,11 +150,12 @@ Multi-Pool IPAM mode:
of endpoints by way of the IPCache.
- Multi-Pool IPAM does not support local node routes (``enable-local-node-route``) and
requires the use of per-endpoint routes (see :ref:`native_routing`) instead.
- iptables-based masquerading (see masquerading :ref:`masq_modes` for details) is not supported,
due to an implementation bug which assumes a single PodCIDR per node (:gh-issue:`22273`).
Use eBPF-based masquerading instead. Also note that if the used IPAM pools do not share a single
native-routing CIDR, you may want to use ``ip-masq-agent`` instead.
See :ref:`concepts_masquerading` for details on how to exclude more than one CIDR from
masquerading.
- iptables-based masquerading requires ``egressMasqueradeInterfaces`` to be set
(see masquerading :ref:`masq_modes` and :gh-issue:`22273` for details).
Alternatively, eBPF-based masquerading is fully supported and may be used instead.
Note that if the used IPAM pools do not belong to a common native-routing CIDR,
you may want to use ``ip-masq-agent``, which allows multiple disjunct non-masquerading
CIDRs to be defined. See :ref:`concepts_masquerading` for details on how to use the
``ip-masq-agent`` feature.
- Announcing PodCIDRs by way of the built-in :ref:`bgp` mode is not yet
supported. Use ``auto-direct-node-routes`` instead.
1 change: 1 addition & 0 deletions Documentation/spelling_wordlist.txt
Original file line number Diff line number Diff line change
Expand Up @@ -391,6 +391,7 @@ disableEnvoyVersionCheck
disableIptablesFeederRules
disassembly
discoverable
disjunct
distro
distros
dmesg
Expand Down

0 comments on commit 970f881

Please sign in to comment.