====== MetalLB Setup on ZEDEDA EVE-K ======

===== Overview =====

MetalLB provides load balancer functionality for bare-metal Kubernetes clusters.
On ZEDEDA EVE-K, the MetalLB operator is installed manually via kubectl.
The IP pool and L2 advertisement are managed via ZedCloud GitOps (Fleet).

----

===== Installation =====

==== Step 1 — Install MetalLB Operator (manual) ====

MetalLB must be installed manually on the cluster. Fleet cannot manage the
operator directly because its manifest includes the namespace definition,
which creates a bootstrap conflict with Helm.

<code bash>
kubectl apply -f https://raw.githubusercontent.com/metallb/metallb/v0.14.5/config/manifests/metallb-native.yaml
</code>

Verify the operator is running:

<code bash>
kubectl get pods -n metallb-system
</code>

==== Step 2 — Configure via GitOps ====

Once the operator is running, Fleet deploys the IP pool and L2 advertisement
automatically via the ''metallb-config'' bundle.

----

===== Repository Structure =====

<code>
demo/charts/
└── infrastructure/
    └── metallb-config/       ← managed by Fleet
        ├── Chart.yaml
        ├── fleet.yaml
        ├── values.yaml
        └── templates/
            ├── ip-pool.yaml
            └── l2adv.yaml
</code>

----

===== metallb-config Bundle =====

==== fleet.yaml ====

<code yaml>
helm:
  chart: .
  releaseName: metallb-config
</code>

==== values.yaml ====

<code yaml>
ipPool:
  name: main-pool
  addresses: 172.16.8.251-172.16.8.254

l2Advertisement:
  name: main-l2
</code>

==== templates/ip-pool.yaml ====

<code yaml>
apiVersion: metallb.io/v1beta1
kind: IPAddressPool
metadata:
  name: {{ .Values.ipPool.name }}
  namespace: metallb-system
spec:
  addresses:
    - {{ .Values.ipPool.addresses }}
</code>

==== templates/l2adv.yaml ====

<code yaml>
apiVersion: metallb.io/v1beta1
kind: L2Advertisement
metadata:
  name: {{ .Values.l2Advertisement.name }}
  namespace: metallb-system
spec:
  ipAddressPools:
    - {{ .Values.ipPool.name }}
</code>

----

===== Verify =====

<code bash>
kubectl get pods -n metallb-system
kubectl get ipaddresspool -n metallb-system
kubectl get l2advertisement -n metallb-system
</code>