Contour: Instructions for presenting grpc services needs a guide

[davecheney]

We need a guide that concisely describes the HTTPProxy configuration and service annotations required to proxy grpc through contour.

[twfx7758]

me too

[reagul]

I can help with this. Can i get assigned ?

[stevesloka]

Awesome all yours @reagul!

Some work steps in my head if this helps:

• I think this would be a good "guide" where you'd add a new file here: https://github.com/projectcontour/contour/tree/master/site/_guides
• If you want to test what it looks like on your machine you can run: make site-devel and open up a browser to localhost:4000
• It would be good to link to this guide from the annotations page as well as the HTTPProxy

[JasonMorgan]

hey folks! Any progress on this? I was just looking for this exact info. Happy to help if anyone can point me at a starting point.

[jpeach]

hey folks! Any progress on this? I was just looking for this exact info. Happy to help if anyone can point me at a starting point.

To expose gRPC services, you would need to enable TLS on the virtual hosts and set the h2 protocol on any upstream service entries.

If you'd like to contribute a specific user guide, that would be great. Steve's comment above and the site contribution doc should help you get started with the docs.

[reagul]

@JasonMorgan i am still working on this one. I will post something soon.