Make gateway Helm chart pod/service metadata and scheduling fully configurable
Open
@renuka-fernando is already working on this.
Since Jun 13, 2026.
Area/Gateway
Aspect/Configuration
Type/Improvement
- Dominant language
- Go
- Stars
- 71
- Forks
- 111
- Avg merge
- 1d 14h
- Merged PRs (30d)
- 110
Description
Description
The gateway-helm-chart does not expose several pod-, service-, and resource-level customization knobs that customer setups commonly require, and it has two correctness bugs in how labels and annotations are rendered.
Bugs
- Duplicate label keys: setting the same key in
commonLabelsand a component'sdeployment.labels/podLabelsrenders duplicate YAML map keys, which strict parsers and GitOps tools (ArgoCD, kubeconform) reject. Labels should be merged with a clear precedence instead of appended. - Inconsistent annotation precedence: at resource level
commonAnnotationssilently wins over per-resource annotations, while at pod level the per-resource value wins. Per-resource annotations should win consistently everywhere.
Missing configuration support (controller + gateway-runtime)
topologySpreadConstraints, deploymentstrategy,terminationGracePeriodSeconds,hostAliases,dnsPolicy/dnsConfig, and pod-levelautomountServiceAccountToken.- Optional
startupProbe(controller template has no support; runtime value is undocumented). - Service tunables:
clusterIP,externalTrafficPolicy,loadBalancerClass,loadBalancerSourceRanges,ipFamilyPolicy/ipFamilies, and staticnodePorts.*(type-gated so they only render on capable Service types). app.kubernetes.io/namein the standard label set.- PVC
labels/annotations(e.g.helm.sh/resource-policy: keep). commonLabels/commonAnnotationsapplied to every resource the chart renders (ServiceAccount, HPAs, PDBs, PVC, Certificate, Issuer, and the ConfigMaps are currently missed), with per-resource values winning on key conflicts.
Out of scope: extraContainers/sidecar injection on the gateway-runtime pod (tracked separately).
Version
No response
Related Issue
Equivalent APK chart change: wso2/apk#3324.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.