docs: cilium kube-proxy replacement

liqotech · Mar 6, 2025 · 374934c · 374934c
1 parent 5bd3d14
commit 374934c
Show file tree

Hide file tree

Showing 2 changed files with 13 additions and 0 deletions.
diff --git a/docs/conf.py b/docs/conf.py
@@ -61,6 +61,8 @@
     'https://github.com/virtual-kubelet/virtual-kubelet#liqo-provider',  # This anchor is not found by the linter, but it works
     'https://www.wireguard.com/', # knwon recurrent error 500
     'https://medium.com/', # often rate-limited
+    'https://github.com/kubernetes/enhancements/tree/master/keps/sig-multicluster/1645-multi-cluster-services-api#service-types',
+    'https://ieeexplore.ieee.org',
 ]
 
 

diff --git a/docs/installation/install.md b/docs/installation/install.md
@@ -547,6 +547,17 @@ affinity:
             operator: DoesNotExist
 ```
 
+#### Kube-proxy replacement
+
+Liqo networks present a limitation when used with cilium with *kube-proxy replacement*.
+In particular you won't be able to expose an **offloaded pod** with a *NodePort* or *LoadBalancer* service.
+This not limits the ability to expose **not offloaded pods** like you would normally do.
+
+```{admonition} Note
+Please consider that in kubernetes multicluster environments, the use of *NodePort* and *LoadBalancer*
+services to expose directly a remote pod is not a [best practice](https://github.com/kubernetes/enhancements/tree/master/keps/sig-multicluster/1645-multi-cluster-services-api#service-types).
+```
+
 ### Calico
 
 Liqo adds several interfaces to the cluster nodes to handle cross-cluster traffic routing.