Skip to content

Commit bdac65a

Browse files
authored
Merge pull request #51974 from danwinship/ipvs-deprecation-sorta
Try to clarify the status of ipvs kube-proxy
2 parents 84637c4 + 6141526 commit bdac65a

File tree

1 file changed

+20
-4
lines changed

1 file changed

+20
-4
lines changed

content/en/docs/reference/networking/virtual-ips.md

Lines changed: 20 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -204,10 +204,26 @@ create rules to redirect traffic from Service IPs to endpoint IPs.
204204
The IPVS proxy mode is based on netfilter hook function that is similar to
205205
iptables mode, but uses a hash table as the underlying data structure and works
206206
in the kernel space.
207-
That means kube-proxy in IPVS mode redirects traffic with lower latency than
208-
kube-proxy in iptables mode, with much better performance when synchronizing
209-
proxy rules. Compared to the iptables proxy mode, IPVS mode also supports a
210-
higher throughput of network traffic.
207+
208+
{{< note >}}
209+
The `ipvs` proxy mode was an experiment in providing a Linux
210+
kube-proxy backend with better rule-synchronizing performance and
211+
higher network-traffic throughput than the `iptables` mode. While it
212+
succeeded in those goals, the kernel IPVS API turned out to be a bad
213+
match for the Kubernetes Services API, and the `ipvs` backend was
214+
never able to implement all of the edge cases of Kubernetes Service
215+
functionality correctly. At some point in the future, it is expected
216+
to be formally deprecated as a feature.
217+
218+
The `nftables` proxy mode (described below) is essentially a
219+
replacement for both the `iptables` and `ipvs` modes, with better
220+
performance than either of them, and is recommended as a replacement
221+
for `ipvs`. If you are deploying onto Linux systems that are too old
222+
to run the `nftables` proxy mode, you should also consider trying the
223+
`iptables` mode rather than `ipvs`, since the performance of
224+
`iptables` mode has improved greatly since the `ipvs` mode was first
225+
introduced.
226+
{{< /note >}}
211227

212228
IPVS provides more options for balancing traffic to backend Pods;
213229
these are:

0 commit comments

Comments
 (0)