haproxy-ingress icon indicating copy to clipboard operation
haproxy-ingress copied to clipboard

Provide better documentation for custom tcp ports

Open james-powis opened this issue 6 years ago • 8 comments

Use Case: Under some circumstances alternative ports are required for tcp communication, IE SSH for gitlab.

I understand tcp-services-configmap can be used to do this, however there is no complete example of how to accomplish this. There are a couple of issues which touch on this topic however they are less than complete, and appear to no longer be possible?

Can someone please provide a complete working example leveraging the latest stable release?

james-powis avatar Sep 20 '18 12:09 james-powis

Hi, is there something missing or that could be improved in the tcp-service-configmap command-line doc?

jcmoraisjr avatar Sep 21 '18 01:09 jcmoraisjr

From a fairly new to k8s perspective, the documentation is not followable. I think a full working example in ./examples would help... There is just a bunch of jedi handwavy stuff in the tcp-service-configmap which assumes apparently a higher level of understanding than I clearly have in this case.

james-powis avatar Sep 21 '18 15:09 james-powis

I managed to get it working after I found this issue: https://github.com/jcmoraisjr/haproxy-ingress/issues/96

Maybe we could use an example close to this?

GMartinez-Sisti avatar Jan 31 '19 10:01 GMartinez-Sisti

From a fairly new to k8s perspective, the documentation is not followable.

Second this. I have a working HAProxy configuration for 20 domains running on Docker, and now trying to move the same to a Kubernetes environment. After reading all the documentation, I am still lost to the meaning of scopes and how configurations map to command line options and ConfigMaps. Please have working examples that newbies can copy and paste!

kaceo avatar Aug 17 '20 09:08 kaceo

I also second this. I'm using about 100% of a so called free time to write the best code base I can provide, and also a minimum doc so one will know that some feature exists. If you that is reading this issue, also like haproxy and this controller, know how stuff works and have any idea on how to improve the doc for beginners, please help us, so I can continue to focus on new features, stability and performance improvement, and other nice stuff as important as a good doc.

jcmoraisjr avatar Aug 17 '20 10:08 jcmoraisjr

I’ve been using this in Production for almost three years. I’ll send a PR with examples to deploy this ingress as a deployment or as a daemon set bot with some custom haproxy configs.

Also tempted to create a helm chart. Would that help?

GMartinez-Sisti avatar Aug 17 '20 16:08 GMartinez-Sisti

Thank you so much =)

You can find a helm chart here, it's a starting point. I don't maintain it myself.

You can also find examples in the old doc as well, perhaps a bit outdated.

jcmoraisjr avatar Aug 17 '20 16:08 jcmoraisjr

Sorry for not following this yet!

I'm using v0.8.5 so I need to update to latest first to ensure that the configurations still work.

GMartinez-Sisti avatar Sep 06 '20 20:09 GMartinez-Sisti