README
¶
HAProxy Unified Gateway for Kubernetes
Description
HUG provides a free open-source solution for cloud-native application routing, featuring unified integration with the latest Kubernetes Gateway API and (coming next year) the existing Ingress API, all built on HAProxy’s legendary performance, reliability, and flexibility – so you can trust it to operate dependably at the largest scale.
Usage
Docker image is available on Docker Hub
If you prefer to build it from source use
task kind-build-controller-image-build-in-docker
Example environment can be created with
task kind-create
or
task k0s-create
Examples
Examples about deployment can be seen in example folder.
HAProxy Helm Charts
Helm Chart 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
task lintfor 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
Directories
¶
| Path | Synopsis |
|---|---|
|
api
|
|
|
gate/v3
+groupName=gate.v3.haproxy.org +k8s:deepcopy-gen=package
|
+groupName=gate.v3.haproxy.org +k8s:deepcopy-gen=package |
|
cmd
|
|
|
controller
command
|
|
|
crd-version-check
command
|
|
|
doc-options
command
|
|
|
generate-gwapi
command
generate-gwapi reads the GWAPI_VERSIONS environment variable and regenerates all files that depend on the list of supported Gateway API versions:
|
generate-gwapi reads the GWAPI_VERSIONS environment variable and regenerates all files that depend on the list of supported Gateway API versions: |
|
gitlab-mr-checker
command
|
|
|
gitlab-mr-pipelines
command
|
|
|
junit-report
command
|
|
|
metrics-report
command
metrics-report reads HUG integration test metrics samples (JSONL files), produces a self-contained HTML artifact with inline SVG charts, and posts an MR comment containing only the baseline comparison summary and a link to the HTML artifact.
|
metrics-report reads HUG integration test metrics samples (JSONL files), produces a self-contained HTML artifact with inline SVG charts, and posts an MR comment containing only the baseline comparison summary and a link to the HTML artifact. |
|
fs
|
|
|
hug
|
|
|
k8s
|
|
|
gate
Package controller is the core of the HAProxy Kubernetes Gateway Controller.
|
Package controller is the core of the HAProxy Kubernetes Gateway Controller. |
|
gate/caps
Package caps detects whether the running process can bind TCP/UDP ports without root, accounting for CAP_NET_BIND_SERVICE and the per-netns ip_unprivileged_port_start sysctl.
|
Package caps detects whether the running process can bind TCP/UDP ports without root, accounting for CAP_NET_BIND_SERVICE and the per-netns ip_unprivileged_port_start sysctl. |
|
gate/utils
Package utils provides utility functions for key mapping and conversions.
|
Package utils provides utility functions for key mapping and conversions. |
|
test
|
|
|
conformance/deployer
Package deployer implements a lightweight Kubernetes deployer for conformance testing: it watches Gateway objects and provisions a dedicated HUG controller Deployment and Service for each one.
|
Package deployer implements a lightweight Kubernetes deployer for conformance testing: it watches Gateway objects and provisions a dedicated HUG controller Deployment and Service for each one. |