History

Manuel de Brito Fontes 6563330d2b Release nginx ingress controller 0.9-beta.7		2017-05-26 15:10:07 -04:00
..
affinity/cookie/nginx	Adds a new situation in affinity config example	2017-02-16 08:40:35 -02:00
auth	fix header name	2017-05-11 08:04:17 +02:00
aws/nginx	Release nginx ingress controller 0.9-beta.7	2017-05-26 15:10:07 -04:00
custom-controller	Merge pull request #764 from chentao1596/example-copyright	2017-05-25 07:45:51 -04:00
customization	Release nginx ingress controller 0.9-beta.7	2017-05-26 15:10:07 -04:00
daemonset	Release nginx ingress controller 0.9-beta.7	2017-05-26 15:10:07 -04:00
deployment	Release nginx ingress controller 0.9-beta.7	2017-05-26 15:10:07 -04:00
external-auth/nginx	Corrected annotation ex `signin-url` to `auth-url`	2017-05-14 21:00:09 +02:00
health-checks/gce	[GLBC] Support backside re-encryption (#519 )	2017-04-18 12:44:17 -07:00
multi-tls	add example for haproxy multi tsl	2017-03-28 16:13:53 +08:00
rbac/nginx	added rbac example discussed in kubernetes/ingress issue #266	2017-05-23 09:58:53 -07:00
rewrite	Fix HAProxy rewrite doc	2017-04-19 19:26:17 -03:00
scaling-deployment	Release nginx ingress controller 0.9-beta.7	2017-05-26 15:10:07 -04:00
static-ip	Release nginx ingress controller 0.9-beta.7	2017-05-26 15:10:07 -04:00
tcp/nginx	Release nginx ingress controller 0.9-beta.7	2017-05-26 15:10:07 -04:00
tls-termination	Minor fix on console cmd of HAProxy docs	2017-02-08 07:26:31 -02:00
udp/nginx	Release nginx ingress controller 0.9-beta.7	2017-05-26 15:10:07 -04:00
http-svc.yaml	Add a tls-termination example	2017-01-27 17:58:44 -08:00
PREREQUISITES.md	docs: use generic instead of OSS controller	2017-04-01 17:03:44 +02:00
README.md	added rbac example discussed in kubernetes/ingress issue #266	2017-05-23 09:58:53 -07:00

README.md

Ingress examples

This directory contains a catalog of examples on how to run, configure and scale Ingress. Please review the prerequisities before trying them.

Basic cross platform

Name	Description	Platform	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

AWS

Name	Description	Platform	Complexity Level
AWS	basic deployment	nginx	Intermediate

TLS

Name	Description	Platform	Complexity Level
LetsEncrypt	acquire certs via ACME protocol	*	Intermediate
Intermediate certs	terminate TLS with intermediate certs	*	Advanced
Client certs	client cert authentication	nginx	Advanced
Re-encrypty	terminate, apply routing rules, re-encrypt	nginx	Advanced

Scaling

Name	Description	Platform	Complexity Level
Daemonset	run multiple controllers in a daemonset	nginx/haproxy	Intermediate
Deployment	run multiple controllers as a deployment	nginx/haproxy	Intermediate
Multi-zone	bridge different zones in a single cluster	gce	Intermediate
Static-ip	a single ingress gets a single static ip	*	Intermediate
Geo-routing	route to geographically closest endpoint	nginx	Advanced
Multi-cluster	bridge Kubernetes clusters with Ingress	gce	Advanced

Algorithms

Name	Description	Platform	Complexity Level
Session stickyness	route requests consistently to the same endpoint	nginx	Advanced
Least connections	route requests based on least connections	on-perm	Advanced
Weights	route requrests to backends based on weights	nginx	Advanced

Routing

Name	Description	Platform	Complexity Level
Redirects	send a 301 re-direct	nginx	Intermediate
URL-rewriting	re-write path	nginx	Intermediate
SNI + HTTP	HTTP routing based on SNI hostname	nginx	Advanced
SNI + TCP	TLS routing based on SNI hostname	nginx	Advanced

Auth

Name	Description	Platform	Complexity Level
Basic auth	password protect your website	nginx	Intermediate
External auth plugin	defer to an external auth service	nginx	Intermediate

Protocols

Name	Description	Platform	Complexity Level
TCP	TCP loadbalancing	nginx	Intermediate
UDP	UDP loadbalancing	nginx	Intermediate
Websockets	websockets loadbalancing	nginx	Intermediate
HTTP/2	HTTP/2 loadbalancing	*	Intermediate
Proxy protocol	leverage the proxy protocol for source IP	nginx	Advanced

Custom controllers

Name	Description	Platform	Complexity Level
Dummy	A simple dummy controller that logs updates	*	Advanced

Customization

Name	Description	Platform	Complexity Level
custom-headers	set custom headers before send traffic to backends	nginx	Advanced
configuration-snippets	customize nginx location configuration using annotations	nginx	Advanced

RBAC

Name	Description	Platform	Complexity Level
rbac	Configuring Role Base Access Control	nginx	intermediate