History

Fernando Diaz 86b52fa957 Add more descriptive steps in Dev Documentation Adds more descriptive steps in the Development Documentation, like more information on obtaining dependencies, building, and deploying an image of the ingress controller. Also adds more descriptive information on deploying as well as some fixes on grammar and spelling.		2017-08-02 23:02:02 -05:00
..
affinity/cookie/nginx	Adds a new situation in affinity config example	2017-02-16 08:40:35 -02:00
auth	Add nginx basic auth example	2017-07-16 16:22:08 -04:00
aws/nginx	Release nginx 0.9.0-beta.11	2017-07-15 13:56:38 -04:00
custom-controller	Update dummy controller interface	2017-06-11 15:59:44 -04:00
customization	Release nginx 0.9.0-beta.11	2017-07-15 13:56:38 -04:00
daemonset	Release nginx 0.9.0-beta.11	2017-07-15 13:56:38 -04:00
deployment	Add more descriptive steps in Dev Documentation	2017-08-02 23:02:02 -05:00
external-auth/nginx	Corrected annotation ex `signin-url` to `auth-url`	2017-05-14 21:00:09 +02:00
health-checks/gce	Update echoserver image version in examples	2017-05-28 17:19:34 -04:00
multi-tls	Update echoserver image version in examples	2017-05-28 17:19:34 -04:00
rbac/nginx	examples/nginx/rbac: Give access to own namespace	2017-07-20 16:10:39 -07:00
rewrite	Fix HAProxy rewrite doc	2017-04-19 19:26:17 -03:00
scaling-deployment	Release nginx 0.9.0-beta.11	2017-07-15 13:56:38 -04:00
static-ip	Release nginx 0.9.0-beta.11	2017-07-15 13:56:38 -04:00
tcp/nginx	Release nginx 0.9.0-beta.11	2017-07-15 13:56:38 -04:00
tls-termination	Release nginx 0.9.0-beta.11	2017-07-15 13:56:38 -04:00
udp/nginx	Release nginx 0.9.0-beta.11	2017-07-15 13:56:38 -04:00
http-svc.yaml	Update echoserver image version in examples	2017-05-28 17:19:34 -04:00
PREREQUISITES.md	docs: use generic instead of OSS controller	2017-04-01 17:03:44 +02:00
README.md	Update README.md	2017-06-16 16:42:02 +02: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-prem	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