Skip to content

Development and Maintenance

This is a first-party (native) Big Bang chart — there is no upstream chart or application to track. The waypoint proxy image is deployed and versioned by the cluster’s istiod, not by this chart, so maintenance is limited to the chart’s own resources and its compatibility with Big Bang’s Istio packages.

Scope and Track

  • Repository scope: istio-egress-gateway package only
  • Maintenance track: bb_integrated
  • The package-namespace resources that route traffic through the waypoint (ServiceEntry labels, egress AuthorizationPolicies, NetworkPolicies) are maintained in bb-common — see the overview for the split.

Making changes

For every change to the chart (values, templates, schema):

  1. Bump version in chart/Chart.yaml (plain SemVer — no -bb.N suffix since there is no upstream version to anchor to).
  2. Add a matching entry to CHANGELOG.md (Keep a Changelog format).
  3. Regenerate README.md with helm-docs and the gluon templates — see the gluon instructions. Never hand-edit the README.
  4. Update chart/values.schema.json if values changed — the schema is strict (additionalProperties: false), so new keys must be added there.

Testing

Unit tests (helm-unittest) cover every rendered resource:

helm lint chart
helm unittest -f 'unittests/*_test.yaml' chart

This package has no dedicated key in the Big Bang umbrella chart; deploy it through the generic packages key. tests/test-values.yaml does exactly that — it enables ambient mode and installs this chart via packages. To test a working branch, override the entry’s git ref:

--set packages.istio-egress-gateway.git.branch=YOUR-WORKING-BRANCH

Verify a healthy deployment by checking the Gateway is programmed and the waypoint pods are running:

kubectl get gateway,deploy -n istio-egress

Compatibility

The chart depends on cluster-side features rather than chart dependencies:

  • Istio ambient mode (istiod, istio-cni, ztunnel) and the istio-waypoint GatewayClass.
  • Gateway API CRDs (gateway.networking.k8s.io/v1).
  • Gateway.spec.infrastructure.parametersRef ConfigMap support (Istio 1.25+) for the waypoint sizing overrides.

When Big Bang’s Istio packages are upgraded, re-run the test deployment to confirm the waypoint still programs and the ConfigMap patches still apply.