Editing Contour Ingress Controller (section)

== Installation ==
Installation was literally as simple as applying a single manifest directly from the Contour site:

 kubectl apply -f https://projectcontour.io/quickstart/contour.yaml

The supplied [https://projectcontour.io/getting-started/ installation guide] was very helpful, and provided some 'toy' examples to help understand the basic concepts.  One of the more useful documents on their website, however, was the guide to [https://projectcontour.io/guides/cert-manager/ connecting Contour with cert-manager] to provide automatic [https://letsencrypt.org/getting-started/ Let's Encrypt] certificate management for ingresses.  [https://github.com/jetstack/cert-manager Cert-manager] is a package of its own with multiple ways to install it -- I'm inclined to avoid helm packages at this time because of my bad experiences with them on the MediaWiki installation (a story for another day), so a simple kubernetes deployment was available and worked well.

The installation of cert-manager was also very straightforward, but the Contour guide was a few minor versions off and caused some consternation until I went directly to the cert-manager GitHub site and read their directions.  in the end, all I really had to do was use a new manifest:

 kubectl create namespace cert-manager
 kubectl apply --validate=false -f https://github.com/jetstack/cert-manager/releases/download/v0.15.1/cert-manager.yaml

The fact that they require you to turn off YAML validation bothers me ... but it did seem to work properly.

At this point you have the core functionality present and ready for use ... but each package requires some CRDs to be created in order to use the functionality.