In order to expose your service externally we know that we can use NodePort and LoadBalancer service types. There is also another means, using a proxy that enable you to specify routing rules to your services. The Ingress Controller serves as this proxy, and the Ingress are K8S resources that represent the routing rules. The Ingress Controller queries the API Server for ingress resources and applies the routing rules define in the ingress. You can view Ingress as the K8S native way of load-balancing and it is the recommended approach to provide load-balanced access to your services.
Why should you use Ingress when there already is the NodePort and Loadbalancer service types?
- The loadbalancer type is only supported if the cloud provider supports it.
- If you create multiple loadbalancer service types, a loadbalancer is provisioned for EACH service. This can be wasteful. In contrast, with a single ingress controller, you can route to many services.
- You can implement your own ingress controller to implement advanced routing rules. For example, let's say you wish to implement A/B testing and you want 75% of the traffic to be routed to version A and the remainder to version B, you can do this via Ingress.
We will deploy two versions of our pod-details api and deploy two different ingress objects - one that routes based on host, and the other by path. See ./create-ingress-example.sh for how to deploy the example. Note, depending on whether RBAC is enabled, you will need to update the ./create-ingress-example.sh. See the file for instructions.
You will need to setup the following files and update the host field to reflect the IP or hostname of your cluster.
- ingress-rule-multiple-host.yml
- ingress-rule-single-host.yml
#update the IP or replace the entire value to the hostname of your cluster
- host: v1.192.168.99.100.nip.io*Note: The nginx ingress controller accesses the API Server to read resources. Hence, it must be authorized to access the API Server.
It is important to note that ingress rules are scoped to namespaces and those rules are not aware of services in other namespaces. For example, let's say you have a service named books in namespace online and another service also named books in namespace bricksandmortar, you can't have an ingress resource with a rule to route to books.online or books.bricksandmortar. Instead, you would have to have separate ingress resources in each namespace that has a rule to route to the books service in that namespace. You would then deploy a single ingress controller that would consume all the ingress resources across all namespaces. This also means that you need to ensure route rule do not overlap across ingress rules. See this long github issue for the background context of this design decision. kubernetes/kubernetes#17088.
Note, another way to specify routing rules that recognizes service.namespace pattern, you can use Ambassador which uses Envoy Proxy behind the scenes.