Traefik operator¶
A Juju charm deploying and managing Traefik, an ingress
integrator and reverse proxy for Kubernetes. It is an essential part of the COS Lite bundle
and is intended to be used together with certificates provider over the tls-certificates interface.
The charm provides a managed ingress entry point for applications running in your Juju model, handling deployment, routing, configuration, TLS integration, and operational tasks specific to Traefik. It can be composed with other operators to deliver complex applications and services.
The charm offers different kinds of ingress:
Ingress for each app: This is the typical use case. The related app has only one ingress URL like
/mymodel-myapp, and Traefik will load-balance in a round-robin fashion across all units.Ingress for each unit: Each unit of the related app obtains its own ingress URL, like
/mymodel-myapp-0.Traefik route: This is a means to provide a fully custom ingress configuration to Traefik.
Note
Ingress is a purely in-model concern. Traefik will happily cross-model relate with your remote ingress requirers, but will be unable to actually route to them. This is a known issue.
In this documentation¶
Get started |
|
Deployment |
|
Operations |
Troubleshoot reachability | Troubleshoot Gateway Address Unavailable | Upgrade |
Ingress and interfaces |
Integrate your charm with Traefik | Ingress-related relations |
Design |
|
Security |
How this documentation is organized¶
This documentation uses the Diátaxis documentation structure.
The Tutorial takes you step-by-step through a basic Traefik deployment and shows how to expose a workload through ingress.
How-to guides cover practical tasks for integrating applications, securing ingress, troubleshooting issues, upgrading, and contributing to the project.
Reference provides technical details on charm architecture, ingress-related relations, and cryptographic considerations.
Explanation gives background and context for security-related topics.
Release notes track stable charm revisions, including new features, bug fixes, and compatibility notes.
Contributing to this documentation¶
Documentation is an important part of this project, and we take the same open-source approach to the documentation as the code. As such, we welcome community contributions, suggestions, and constructive feedback on our documentation. See How to contribute for more information.
If there’s a particular area of documentation that you’d like to see that’s missing, please file a bug.
Project and community¶
The Traefik operator is an open source project that warmly welcomes community projects, contributions, suggestions, fixes and constructive feedback.
Thinking about using the Traefik charm for your next project? Get in touch!