Skip to content

Commit fd1d6f8

Browse files
aleoliadamjensenbot
authored andcommitted
docs(install): add Cilium device config note
1 parent 94d394c commit fd1d6f8

File tree

1 file changed

+19
-0
lines changed

1 file changed

+19
-0
lines changed

docs/installation/install.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -632,6 +632,25 @@ affinity:
632632
operator: DoesNotExist
633633
```
634634

635+
#### Device Configuration
636+
637+
When using **advanced Cilium eBPF features** such as eBPF-based host routing, host firewall, or BPF masquerading, Cilium automatically attaches eBPF programs to all network interfaces it detects.
638+
However, Liqo creates its own network interfaces (e.g., `liqo.*`) that should not be managed by Cilium's eBPF datapath.
639+
640+
```{admonition} Note
641+
This configuration is **not required** if you are using Cilium with default settings.
642+
It is only necessary when enabling advanced eBPF features that attach programs directly to network interfaces.
643+
```
644+
645+
To prevent conflicts and ensure Liqo traffic is handled correctly when using these advanced features, you should explicitly configure which network interfaces Cilium should manage using the `devices` parameter in the cilium values.yaml file.
646+
647+
If the `devices` parameter is not set while using advanced eBPF features, Cilium will auto-detect and attach to all interfaces, including Liqo interfaces.
648+
This can cause packet drops or unexpected behavior as Cilium's eBPF programs will intercept traffic before it reaches the kernel's network stack where Liqo expects to handle it.
649+
650+
This configuration ensures that Cilium eBPF programs (for NodePort, masquerading, and host firewall) are only attached to the specified devices, leaving Liqo interfaces unmanaged and free to handle cross-cluster traffic.
651+
652+
For more details about the `devices` parameter, refer to the [Cilium Helm Reference](https://github.com/cilium/cilium/blob/v1.18.4/install/kubernetes/cilium/values.yaml#L854) and [Host Policies documentation](https://docs.cilium.io/en/stable/security/policy/language/#host-policies).
653+
635654
#### Kube-proxy replacement
636655

637656
Liqo networks present a limitation when used with cilium with *kube-proxy replacement*.

0 commit comments

Comments
 (0)