Welcome to the Cilium Service Mesh beta program!
In this repo you'll find
- information about the status of Cilium Service Mesh features and the beta-specific image builds
- instructions for getting started with Cilium Service Mesh
- a discussions forum for your feedback on Cilium Service Mesh features and usability
- an issue tracker for bug reports related to Cilium Service Mesh.
The Cilium project is developing Service Mesh capabilities in a feature branch, to give us the flexibility to make potentially non-backwards-compatible changes, for example changes to CRDs. We plan to merge Service Mesh features into Cilium release v1.12 in early 2022. (Read more about the motivations for the beta program).
Please note: although we’ll only change things for good reasons, there are no backward-compatibility guarantees with the configuration of Cilium Service Mesh during beta, and the code has only been through limited testing. Please be mindful of this when you choose where to deploy Cilium Service Mesh - we do not recommend using it in production or staging environments yet.
Alpha Very early release of features that have not been through extensive testing yet. No guarantee that future releases will be back compatible with CRDs or other configuration settings. Please don't be surprised if you encounter bugs.
Beta Early release of features that we expect to be stable enough for testing by end users. No guarantee that future releases will be back compatible with CRDs or other configuration settings.
v1.11 Features already merged into the Cilium v1.11 release (as well as in the Service Mesh beta-specific builds)
| Feature | Status |
|---|---|
| Kubernetes Ingress support | Beta |
| Open Telemetry support | Alpha, v1.11 |
| L7-aware Traffic Management | Alpha |
Other features will be added as the beta progresses.
Container images built to include the service mesh beta features:
| Component | Image name |
|---|---|
| Cilium agent | quay.io/cilium/cilium-service-mesh:v1.11.0-beta.1 |
| Cilium operator | quay.io/cilium/operator-generic-service-mesh:v1.11.0-beta.1 |
| Hubble relay | quay.io/cilium/hubble-relay-service-mesh:v1.11.0-beta.1 |
You will also need Cilium CLI version 0.10.0 or greater. (Check the version with cilium version).
Instructions for installing the Cilium service mesh beta components are here.
We have some example configurations and walkthroughs for trying out Service Mesh capabilities:
- Try path-based routing and TLS termination with the Kubernetes Ingress examples
- Explore Cilium Envoy Configuration with examples showing path translation and Layer 7 load balancing
- Walk through an example of the Hubble integration with OpenTelemetry
We'll be adding more during the course of the beta program (contributions welcome!)
If you find an issue related to Service Mesh please raise it here.
This beta program is part of the Cilium project and follows the same Code of Conduct.