History

Joao Gilberto Magalhaes 542fab1607 Add ingress status update functionality to support various deployment modes - Introduced `ingressStatus` configuration in Helm values to enable status updates and customize deployment modes (auto, daemonset, nodeport, clusterip). - Implemented logic in the processor to detect deployment mode, retrieve ingress addresses, and update ingress status dynamically. - Updated Kubernetes manifests to grant required permissions for `ingresses/status` operations and pass necessary environment variables for configuration. - Adjusted Helm templates and associated Kubernetes examples to reflect the new ingress status update capability.		2025-12-15 21:11:02 -05:00
..
easyhaproxy-clusterip.yml	Add ingress status update functionality to support various deployment modes	2025-12-15 21:11:02 -05:00
easyhaproxy-daemonset.yml	Add ingress status update functionality to support various deployment modes	2025-12-15 21:11:02 -05:00
easyhaproxy-nodeport.yml	Add ingress status update functionality to support various deployment modes	2025-12-15 21:11:02 -05:00
README.md	Add IngressClass resource and update references to `spec.ingressClassName` across templates, examples, and documentation for consistency and backward compatibility	2025-12-15 20:33:51 -05:00

README.md

Kubernetes Static Manifests

⚠️ IMPORTANT: These files are auto-generated from Helm templates. Do not edit them directly!

About These Files

This directory contains pre-rendered Kubernetes manifests for deploying EasyHAProxy without Helm. These are generated from the Helm chart at ../../helm/easyhaproxy/ and provide three deployment options:

File	Type	Use Case
`easyhaproxy-daemonset.yml`	DaemonSet + hostPort	Direct host networking, best for bare-metal or simple setups
`easyhaproxy-nodeport.yml`	Deployment + NodePort	Exposes via NodePort (31080/31443/31936)
`easyhaproxy-clusterip.yml`	Deployment + ClusterIP	Internal cluster access only, use with external LoadBalancer

How to Use

Choose the manifest that fits your deployment scenario:

# Option 1: DaemonSet mode (hostPort)
kubectl apply -f easyhaproxy-daemonset.yml

# Option 2: NodePort mode
kubectl apply -f easyhaproxy-nodeport.yml

# Option 3: ClusterIP mode
kubectl apply -f easyhaproxy-clusterip.yml

For more details, see the Kubernetes documentation.

Regenerating These Files

When to regenerate:

After modifying Helm chart templates (helm/easyhaproxy/templates/)
After updating default values (helm/easyhaproxy/values.yaml)
After a new release to sync with latest Helm chart

How to regenerate:

# Navigate to helm directory
cd helm

# Generate DaemonSet manifest (hostPort mode)
helm template ingress ./easyhaproxy --namespace easyhaproxy \
  --set service.create=false \
  > ../deploy/kubernetes/easyhaproxy-daemonset.yml

# Generate NodePort manifest
helm template ingress ./easyhaproxy --namespace easyhaproxy \
  --set service.create=true \
  --set service.type=NodePort \
  > ../deploy/kubernetes/easyhaproxy-nodeport.yml

# Generate ClusterIP manifest
helm template ingress ./easyhaproxy --namespace easyhaproxy \
  --set service.create=true \
  --set service.type=ClusterIP \
  > ../deploy/kubernetes/easyhaproxy-clusterip.yml

Verify regeneration:

# Check IngressClass is present
grep "kind: IngressClass" ../deploy/kubernetes/easyhaproxy-*.yml

# Validate manifest syntax
kubectl apply --dry-run=client -f ../deploy/kubernetes/easyhaproxy-daemonset.yml

What's Included

Each manifest contains:

ServiceAccount: RBAC identity for EasyHAProxy
ClusterRole: Permissions to read Ingress resources and Secrets
ClusterRoleBinding: Binds the role to the service account
IngressClass: Defines easyhaproxy as the ingress class
DaemonSet/Deployment: The EasyHAProxy workload
Service (NodePort/ClusterIP only): Network exposure

Source of Truth

The Helm chart at ../../helm/easyhaproxy/ is the source of truth. All changes should be made there, then these static manifests regenerated.

To modify these deployments:

Edit Helm templates in helm/easyhaproxy/templates/
Update default values in helm/easyhaproxy/values.yaml
Regenerate static manifests using commands above
Commit both Helm changes and regenerated manifests