2016-11-25 01:51:05 +00:00
|
|
|
# Ingress examples
|
|
|
|
|
|
2017-01-28 01:51:00 +00:00
|
|
|
This directory contains a catalog of examples on how to run, configure and
|
2017-08-16 22:01:23 +00:00
|
|
|
scale Ingress. Please review the [prerequisites](PREREQUISITES.md) before
|
2017-01-28 01:51:00 +00:00
|
|
|
trying them.
|
2016-11-25 01:51:05 +00:00
|
|
|
|
|
|
|
|
## Basic cross platform
|
|
|
|
|
|
2017-10-07 21:29:41 +00:00
|
|
|
Name | Description | Complexity Level
|
|
|
|
|
-----| ----------- | ----------------
|
|
|
|
|
Deployment | basic deployment of controllers | Beginner
|
|
|
|
|
TLS termination | terminate TLS at the ingress controller | Beginner
|
|
|
|
|
Name based virtual hosting | `Host` header routing | Beginner
|
|
|
|
|
Path routing | URL regex routing | Beginner
|
|
|
|
|
Health checking | configure/optimize health checks | Intermediate
|
|
|
|
|
Pipeline | pipeline cloud and nginx | Advanced
|
2016-11-25 01:51:05 +00:00
|
|
|
|
2017-03-26 20:47:26 +00:00
|
|
|
## AWS
|
|
|
|
|
|
2017-10-07 21:29:41 +00:00
|
|
|
Name | Description | Complexity Level
|
|
|
|
|
-----| ----------- | ----------------
|
|
|
|
|
AWS | basic deployment | Intermediate
|
2017-03-26 20:47:26 +00:00
|
|
|
|
|
|
|
|
|
2016-11-25 01:51:05 +00:00
|
|
|
## TLS
|
|
|
|
|
|
2017-10-07 21:29:41 +00:00
|
|
|
Name | Description | Complexity Level
|
|
|
|
|
-----| ----------- | ----------------
|
|
|
|
|
LetsEncrypt | acquire certs via ACME protocol | Intermediate
|
|
|
|
|
Intermediate certs | terminate TLS with intermediate certs | Advanced
|
|
|
|
|
Client certs | client cert authentication | Advanced
|
|
|
|
|
Re-encrypty | terminate, apply routing rules, re-encrypt | Advanced
|
2016-11-25 01:51:05 +00:00
|
|
|
|
|
|
|
|
## Scaling
|
|
|
|
|
|
2017-10-07 21:29:41 +00:00
|
|
|
Name | Description | Complexity Level
|
|
|
|
|
-----| ----------- | ----------------
|
|
|
|
|
Daemonset | run multiple controllers in a daemonset | Intermediate
|
|
|
|
|
Deployment | run multiple controllers as a deployment | Intermediate
|
|
|
|
|
Static-ip | a single ingress gets a single static ip | Intermediate
|
|
|
|
|
Geo-routing | route to geographically closest endpoint | Advanced
|
2016-11-25 01:51:05 +00:00
|
|
|
|
|
|
|
|
## Algorithms
|
|
|
|
|
|
2017-10-07 21:29:41 +00:00
|
|
|
Name | Description | Complexity Level
|
|
|
|
|
-----| ----------- | ----------------
|
|
|
|
|
Session stickyness | route requests consistently to the same endpoint | Advanced
|
|
|
|
|
Least connections | route requests based on least connections | Advanced
|
|
|
|
|
Weights | route requests to backends based on weights | Advanced
|
2016-11-25 01:51:05 +00:00
|
|
|
|
|
|
|
|
## Routing
|
|
|
|
|
|
2017-10-07 21:29:41 +00:00
|
|
|
Name | Description | Complexity Level
|
|
|
|
|
-----| ----------- | ----------------
|
|
|
|
|
Redirects | send a 301 re-direct | Intermediate
|
|
|
|
|
URL-rewriting | re-write path | Intermediate
|
|
|
|
|
SNI + HTTP | HTTP routing based on SNI hostname | Advanced
|
|
|
|
|
SNI + TCP | TLS routing based on SNI hostname | Advanced
|
2016-11-25 01:51:05 +00:00
|
|
|
|
|
|
|
|
## Auth
|
|
|
|
|
|
2017-10-07 21:29:41 +00:00
|
|
|
Name | Description | Complexity Level
|
|
|
|
|
-----| ----------- | ----------------
|
2016-11-25 01:51:05 +00:00
|
|
|
Basic auth | password protect your website | nginx | Intermediate
|
2017-10-07 21:29:41 +00:00
|
|
|
[External auth plugin](external-auth/README.md) | defer to an external auth service | Intermediate
|
2016-11-25 01:51:05 +00:00
|
|
|
|
|
|
|
|
## Protocols
|
|
|
|
|
|
2017-10-07 21:29:41 +00:00
|
|
|
Name | Description | Complexity Level
|
|
|
|
|
-----| ----------- | ----------------
|
|
|
|
|
TCP | TCP loadbalancing | Intermediate
|
|
|
|
|
UDP | UDP loadbalancing | Intermediate
|
|
|
|
|
Websockets | websockets loadbalancing | Intermediate
|
|
|
|
|
HTTP/2 | HTTP/2 loadbalancing | Intermediate
|
|
|
|
|
Proxy protocol | leverage the proxy protocol for source IP | Advanced
|
2016-11-25 01:51:05 +00:00
|
|
|
|
2017-01-31 02:42:36 +00:00
|
|
|
## Custom controllers
|
|
|
|
|
|
2017-10-07 21:29:41 +00:00
|
|
|
Name | Description | Complexity Level
|
|
|
|
|
-----| ----------- | ----------------
|
|
|
|
|
Dummy | A simple dummy controller that logs updates | Advanced
|
2017-01-31 02:42:36 +00:00
|
|
|
|
2017-02-23 15:52:10 +00:00
|
|
|
## Customization
|
2016-11-25 01:51:05 +00:00
|
|
|
|
2017-10-07 21:29:41 +00:00
|
|
|
Name | Description | Complexity Level
|
|
|
|
|
-----| ----------- | ----------------
|
|
|
|
|
custom-headers | set custom headers before send traffic to backends | Advanced
|
|
|
|
|
configuration-snippets | customize nginx location configuration using annotations | Advanced
|
2017-05-22 21:12:23 +00:00
|
|
|
|
|
|
|
|
## RBAC
|
|
|
|
|
|
2017-10-07 21:29:41 +00:00
|
|
|
Name | Description | Complexity Level
|
|
|
|
|
-----| ----------- | ----------------
|
|
|
|
|
rbac | Configuring Role Base Access Control | intermediate
|
