Gimbal is an ingress load balancing platform capable of routing traffic to multiple Kubernetes and OpenStack clusters. Built by Heptio in partnership with Actapio.
Deprecation Notice
This repository has been deprecated and archived as read-only. The code here is no longer maintained but is preserved for reference.
Overview
Gimbal is a layer-7 load balancing platform built on Contour, which is an Ingress controller for Kubernetes that works by deploying the Envoy proxy as a reverse proxy and load balancer. It provides a scalable, multi-team, and API-driven ingress tier capable of routing Internet traffic to multiple upstream Kubernetes clusters and to traditional infrastructure technologies such as OpenStack.
Gimbal was developed out of a joint effort between gimbal and Yahoo Japan Corporation's subsidiary, Actapio, to modernize Yahoo Japan’s infrastructure with Kubernetes, without affecting legacy investments in OpenStack.
Early releases of Gimbal can discover services that run on Kubernetes and OpenStack clusters, but support for additional platforms is expected in future releases.
Common Use Cases
Supported versions
Gimbal runs on Kubernetes version 1.9 or later, but is tested to provide service discovery for clusters running Kubernetes 1.7 or later, or OpenStack Mitaka.
Get started
Deployment of Gimbal is outlined in the deployment section, which includes quick start applications.
Documentation
Documentation for all the Gimbal components can be found in the docs directory.
Known Limitations
If you encounter any problems that the documentation does not address, please file an issue or talk to us on the Kubernetes Slack team channel #gimbal.
Contributing
Thanks for taking the time to join our community and start contributing!
Before you start
Pull Requests
Twice a month we will interview people behind open source businesses. We will talk about how they are building a business on top of open source projects.
We'll never share your email with anyone else.