haproxytech/kubernetes-ingress repository overview

⁠HAProxy Kubernetes Ingress Controller

⁠Description

An ingress controller is a Kubernetes resource that routes traffic from outside your cluster to services within the cluster.

Detailed documentation can be found within the Official Documentation⁠.

You can also find in this repository a list of all available Ingress annotations⁠.

⁠Usage

Docker image is available on Docker Hub: haproxytech/kubernetes-ingress⁠

If you prefer to build it from source use

docker build -t haproxytech/kubernetes-ingress -f build/Dockerfile .

Example environment can be created with

make example

Please see controller.md⁠ for all available arguments of controler image.

Available customisations are described in doc⁠

Basic setup to to run controller is described in yaml⁠ file.

kubectl apply -f deploy/haproxy-ingress.yaml

⁠HAProxy Helm Charts

Official HAProxy Technologies Helm Charts for deploying on Kubernetes⁠ are available in haproxytech/helm-charts⁠ repository

⁠Contributing

Thanks for your interest in the project and your willing to contribute:

• Pull requests are welcome!
• For commit messages and general style please follow the haproxy project's CONTRIBUTING guide⁠ and use that where applicable.
• Please use golangci-lint run from github.com/golangci/golangci-lint⁠ for linting code.

⁠Discussion

A Github issue is the right place to discuss feature requests, bug reports or any other subject that needs tracking.

To ask questions, get some help or even have a little chat, you can join our #ingress-controller channel in HAProxy Community Slack⁠.

⁠License

Apache License 2.0⁠