mirror of
https://github.com/k3s-io/kubernetes.git
synced 2025-09-08 12:41:58 +00:00
Merge pull request #16932 from bprashanth/ing_docs
Ingress doc clarifications
This commit is contained in:
@@ -38,6 +38,7 @@ Documentation for other releases can be found at
|
||||
|
||||
- [Ingress](#ingress)
|
||||
- [What is Ingress?](#what-is-ingress)
|
||||
- [Prerequisites](#prerequisites)
|
||||
- [The Ingress Resource](#the-ingress-resource)
|
||||
- [Ingress controllers](#ingress-controllers)
|
||||
- [Types of Ingress](#types-of-ingress)
|
||||
@@ -84,6 +85,14 @@ An Ingress is a collection of rules that allow inbound connections to reach the
|
||||
|
||||
It can be configured to give services externally-reachable urls, load balance traffic, terminate SSL, offer name based virtual hosting etc. Users request ingress by POSTing the Ingress resource to the API server. An [Ingress controller](#ingress-controllers) is responsible for fulfilling the Ingress, usually with a loadbalancer, though it may also configure your edge router or additional frontends to help handle the traffic in an HA manner.
|
||||
|
||||
## Prerequisites
|
||||
|
||||
Before you start using the Ingress resource, there are a few things you should understand:
|
||||
* The Ingress resource is not available in any Kubernetes release prior to 1.1
|
||||
* You need an Ingress controller to satisfy an Ingress. Simply creating the resource will have no effect.
|
||||
* On GCE/GKE there should be a [L7 cluster addon](../../cluster/addons/cluster-loadbalancing/glbc/README.md#prerequisites), on other platforms you either need to write your own or [deploy an existing controller](https://github.com/kubernetes/contrib/tree/master/Ingress) as a pod.
|
||||
* The resource currently does not support HTTPS, but will do so before it leaves beta.
|
||||
|
||||
## The Ingress Resource
|
||||
|
||||
A minimal Ingress might look like:
|
||||
|
Reference in New Issue
Block a user