Developing on Gloo can be a fun and rewarding experience.
Gloo is designed to be highly pluggable and easily extendable in each of the following domains:
The reason Gloo is extendable in so many directions is due in part to its Kubernetes Operator-style design. By interacting with two CRDs, it is possible to customize Gloo to virtually any environment and use case:
v1.Proxiesprovide the routing configuration which Gloo will translate and apply to Envoy.
v1.Upstreams describe routable destinations for Gloo.
Proxies represent a unified configuration to be applied to one or more instances of a proxy. You can think of the proxy of as tree like such:
proxy ├─ bind-address │ ├── domain-set │ │ ├── /route │ │ ├── /route │ │ ├── /route │ │ └── tls-config │ └── domain-set │ ├── /route │ ├── /route │ ├── /route │ └── tls-config └─ bind-address ├── domain-set │ ├── /route │ ├── /route │ ├── /route │ └── tls-config └── domain-set ├── /route ├── /route ├── /route └── tls-config
A single proxy CRD contains all the configuration necessary to be applied to an instance of Envoy. In the Gloo system, Proxies are treated as an intermediary representation of config, while user-facing config is imported from simpler, more opinionated resources such as the
gateway.VirtualService or Kubernetes Ingress objects.
For this reason, a standard Gloo deployment contains one or more controllers which programatically generate and write these CRDs to provide simpler, use-case specific APIs such as API Gateway and Ingress. Sqoop is an advanced controller which creates routing configuration for Gloo from GraphQL Schemas.
Click here for a tutorial providing a simple example utilizing this lower-level Proxy API. This tutorial will walk you through building a Kubernetes controller to automatically configure Gloo without any user interaction](example-proxy-controller.go).
typewhich is provided in their
upstreamSpecfield. Each type of upstream corresponds to an Upstream Plugin, which tells Gloo how to translate upstreams of that type to Envoy clusters. When a route is declared for an upstream, Gloo invokes the corresponding plugin for that type
More tutorials and design documentation are coming soon!