Skip to content

Commit 738e06f

Browse files
committed
Remove references to bridge-nf-call-iptables
Plugins that need it are expected to set it themselves. (And kubeadm no longer checks for it.)
1 parent fe2efe0 commit 738e06f

File tree

3 files changed

+12
-44
lines changed

3 files changed

+12
-44
lines changed

content/en/docs/concepts/extend-kubernetes/compute-storage-net/network-plugins.md

Lines changed: 0 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -54,19 +54,6 @@ that plugin or [networking provider](/docs/concepts/cluster-administration/netwo
5454

5555
## Network Plugin Requirements
5656

57-
For plugin developers and users who regularly build or deploy Kubernetes, the plugin may also need
58-
specific configuration to support kube-proxy. The iptables proxy depends on iptables, and the
59-
plugin may need to ensure that container traffic is made available to iptables. For example, if
60-
the plugin connects containers to a Linux bridge, the plugin must set the
61-
`net/bridge/bridge-nf-call-iptables` sysctl to `1` to ensure that the iptables proxy functions
62-
correctly. If the plugin does not use a Linux bridge, but uses something like Open vSwitch or
63-
some other mechanism instead, it should ensure container traffic is appropriately routed for the
64-
proxy.
65-
66-
By default, if no kubelet network plugin is specified, the `noop` plugin is used, which sets
67-
`net/bridge/bridge-nf-call-iptables=1` to ensure simple configurations (like Docker with a bridge)
68-
work correctly with the iptables proxy.
69-
7057
### Loopback CNI
7158

7259
In addition to the CNI plugin installed on the nodes for implementing the Kubernetes network

content/en/docs/reference/setup-tools/kubeadm/implementation-details.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -109,8 +109,6 @@ The user can skip specific preflight checks or all of them with the `--ignore-pr
109109
- [warning] if firewalld is active
110110
- [error] if API server bindPort or ports 10250/10251/10252 are used
111111
- [Error] if `/etc/kubernetes/manifest` folder already exists and it is not empty
112-
- [Error] if `/proc/sys/net/bridge/bridge-nf-call-iptables` file does not exist/does not contain 1
113-
- [Error] if advertise address is ipv6 and `/proc/sys/net/bridge/bridge-nf-call-ip6tables` does not exist/does not contain 1.
114112
- [Error] if swap is on
115113
- [Error] if `conntrack`, `ip`, `iptables`, `mount`, `nsenter` commands are not present in the command path
116114
- [warning] if `ebtables`, `ethtool`, `socat`, `tc`, `touch`, `crictl` commands are not present in the command path

content/en/docs/setup/production-environment/container-runtimes.md

Lines changed: 12 additions & 29 deletions
Original file line numberDiff line numberDiff line change
@@ -47,50 +47,33 @@ check the documentation for that version.
4747
<!-- body -->
4848
## Install and configure prerequisites
4949

50-
The following steps apply common settings for Kubernetes nodes on Linux.
50+
### Network configuration
5151

52-
You can skip a particular setting if you're certain you don't need it.
52+
By default, the Linux kernel does not allow IPv4 packets to be routed
53+
between interfaces. Most Kubernetes cluster networking implementations
54+
will change this setting (if needed), but some might expect the
55+
administrator to do it for them. (Some might also expect other sysctl
56+
parameters to be set, kernel modules to be loaded, etc; consult the
57+
documentation for your specific network implementation.)
5358

54-
For more information, see
55-
[Network Plugin Requirements](/docs/concepts/extend-kubernetes/compute-storage-net/network-plugins/#network-plugin-requirements)
56-
or the documentation for your specific container runtime.
59+
### Enable IPv4 packet forwarding {#prerequisite-ipv4-forwarding-optional}
5760

58-
### Forwarding IPv4 and letting iptables see bridged traffic
59-
60-
Execute the below mentioned instructions:
61+
To manually enable IPv4 packet forwarding:
6162

6263
```bash
63-
cat <<EOF | sudo tee /etc/modules-load.d/k8s.conf
64-
overlay
65-
br_netfilter
66-
EOF
67-
68-
sudo modprobe overlay
69-
sudo modprobe br_netfilter
70-
7164
# sysctl params required by setup, params persist across reboots
7265
cat <<EOF | sudo tee /etc/sysctl.d/k8s.conf
73-
net.bridge.bridge-nf-call-iptables = 1
74-
net.bridge.bridge-nf-call-ip6tables = 1
75-
net.ipv4.ip_forward = 1
66+
net.ipv4.ip_forward = 1
7667
EOF
7768

7869
# Apply sysctl params without reboot
7970
sudo sysctl --system
8071
```
8172

82-
Verify that the `br_netfilter`, `overlay` modules are loaded by running the following commands:
83-
84-
```bash
85-
lsmod | grep br_netfilter
86-
lsmod | grep overlay
87-
```
88-
89-
Verify that the `net.bridge.bridge-nf-call-iptables`, `net.bridge.bridge-nf-call-ip6tables`, and
90-
`net.ipv4.ip_forward` system variables are set to `1` in your `sysctl` config by running the following command:
73+
Verify that `net.ipv4.ip_forward` is set to 1 with:
9174

9275
```bash
93-
sysctl net.bridge.bridge-nf-call-iptables net.bridge.bridge-nf-call-ip6tables net.ipv4.ip_forward
76+
sysctl net.ipv4.ip_forward
9477
```
9578

9679
## cgroup drivers

0 commit comments

Comments
 (0)