Editing Contour Ingress Controller (section)

== Creating Ingresses to publish access to Services ==
The whole point of a [https://kubernetes.io/docs/concepts/services-networking/ingress/ kubernetes ingress] (and the newer [https://projectcontour.io/docs/master/httpproxy/ HTTPProxy] that is part of the Contour package) is to enable access to kubernetes services outside of the cluster.  The Service can be of any type.

All that needs to be done is to create an Ingress in the same namespace as the Service, referencing the service by name and matching the port as specified in the Service.  A simple example Service:

 apiVersion: v1
 kind: Service
 metadata:
   name: httpbin
 spec:
   ports:
   - port: 8080
     protocol: TCP
     targetPort: 8080
   selector:
     app: httpbin

... and the corresponding Ingress:

 apiVersion: networking.k8s.io/v1beta1
 kind: Ingress
 metadata:
   name: httpbin
 spec:
   rules:
   - host: httpbin.davecheney.com
     http:
       paths:
       - backend:
           serviceName: httpbin
           servicePort: 8080

Note that the serviceName and servicePort match those values in the Service specification.  The 'spec.rules.host' parameter is the hostname that will trigger this ingress when a HTTP/HTTPS request arrives.  This definition of an ingress will support unencrypted HTTP.