|
| 1 | +# Compatibility Matrix |
| 2 | + |
| 3 | +This page provides information about Liqo's compatibility with different Kubernetes providers. |
| 4 | + |
| 5 | +```{admonition} Note |
| 6 | +While the following list includes providers that we have specifically tested, Liqo should work with any Kubernetes-compliant distribution, although some provider-specific configurations might be required. |
| 7 | +``` |
| 8 | + |
| 9 | +## Legend |
| 10 | + |
| 11 | +- ✅ Fully supported - All features work as expected |
| 12 | +- 🟢 Mostly supported - Core features work well, with only minor limitations in specific scenarios |
| 13 | +- 🔵 Partial support - Some Liqo features are functional, but others may require specific configurations or have major limitations in certain use cases |
| 14 | + |
| 15 | +## Tested Provider Compatibility Table |
| 16 | + |
| 17 | +| Provider | Status | Known Issues | |
| 18 | +|----------|--------|--------------| |
| 19 | +| Kubeadm (Calico) | ✅ | No known issues | |
| 20 | +| Kubeadm (Cilium) | ✅ | No known issues | |
| 21 | +| Kubeadm (Cilium with kube-proxy replacement) | 🟢 | `NodePortExposition` and `LoadBalancerExposition` | |
| 22 | +| K3s | 🟢 | `RemoteExec` | |
| 23 | +| K0s | ✅ | No known issues | |
| 24 | +| AKS (Azure CNI Overlay) | 🟢 | `CrossClusterAPIServerInteraction` and `ExternalIPRemapping` | |
| 25 | +| AKS (Azure CNI (Legacy)) | 🟢 | `CrossClusterAPIServerInteraction` and `NodePortExposition` | |
| 26 | +| AKS (Kubenet) | 🟢 | `CrossClusterAPIServerInteraction` and `ExternalIPRemapping` | |
| 27 | +| EKS | 🟢 | `CrossClusterAPIServerInteraction` and `ExternalIPRemapping` | |
| 28 | +| GKE (Dataplane v1) | ✅ | No known issues | |
| 29 | +| GKE (Dataplane v2) | 🟢 | `NodePortExposition` and `LoadBalancerExposition` | |
| 30 | +| Aruba Cloud KaaS | ✅ | No known issues | |
| 31 | +| OpenShift | 🔵 | **Work in progress**: all Liqo functionalities except for the networking module work as expected. The team is actively working on adding full networking support. You can still use it by [disabling the Network Module](AdvancedUseOnlyOffloadingDisableModule). | |
| 32 | +| *Your K8s Distribution* | 🟢 | Liqo is designed to work with most Kubernetes-compliant distributions. Your provider is likely supported, but may require specific configurations. | |
| 33 | + |
| 34 | +### Help Us Improve |
| 35 | + |
| 36 | +Have you tested Liqo with a provider not listed here? |
| 37 | +We'd love to hear about your experience! |
| 38 | +Join our [Slack community](https://liqo-io.slack.com/join/shared_invite/zt-h20212gg-g24YvN6MKiD9bacFeqZttQ) and share your test results. |
| 39 | +Your feedback helps us improve Liqo's compatibility across different environments. |
| 40 | + |
| 41 | +## Issues Reference |
| 42 | + |
| 43 | +The following issues are known to affect the compatibility of Liqo with different Kubernetes providers: |
| 44 | + |
| 45 | +- `CrossClusterAPIServerInteraction`: The ability of offloaded pods to properly interact with the Kubernetes API server of the consumer cluster. This ensures that applications running in provider clusters can still access and manipulate Kubernetes resources (such as ConfigMaps, Secrets, or other custom resources) in their original cluster. Limitations in this area may impact applications that rely on the Kubernetes API for normal operation. See [here](../advanced/kubernetes-api.md) for more details. |
| 46 | + |
| 47 | +- `RemoteExec`: The capability to execute commands in pods that have been offloaded to remote clusters, using `kubectl exec`. When limited, administrators may face challenges in directly interacting with offloaded workloads. |
| 48 | + |
| 49 | +- `NodePortExposition`: The capability to access remote offloaded pods through NodePort services. This ensures that network traffic addressed to NodePort services can reach every pods, even when those pods are running in remote clusters. Limitations here may affect external access to applications. |
| 50 | + |
| 51 | +- `LoadBalancerExposition`: The capability to expose remote offloaded pods via LoadBalancer services. This ensures that cloud provider load balancers can properly distribute traffic to offloaded pods. When this feature has limitations, it may impact the ability to use cloud load balancers with offloaded workloads. |
| 52 | + |
| 53 | +- `ExternalIPRemapping`: The ability to make external IPs (outside of the Kubernetes cluster network) accessible to pods running in remote and local clusters. This involves translating IP addresses between clusters with potentially overlapping network ranges, ensuring that pods in one cluster can access external resources that are only directly reachable from another cluster. Limitations here may affect connectivity to external services or resources. See [here](../advanced/external-ip-remapping.md) for more details. |
0 commit comments