# k8gb v0.17.0

2025-12-24 · [Original release notes](https://github.com/k8gb-io/k8gb/releases/tag/v0.17.0) · [Full summary](https://ratatosk.io/en/releases/k8gb/v0.17.0)

Breaking changes 3 · Important fixes 4 · Enhancements 9 · Dependency updates 12 · Other changes 34

## Breaking changes (3)

### Helm chart packaging and OCI publication removed from the release workflow

- Affects: k8gb Helm charts obtained from `oci://ghcr.io/k8gb-io/charts` (Inferred)

The workflow previously packaged and pushed the Helm chart to the OCI registry. Releases made through this workflow no longer publish a chart there.

> * Temporary disable OCI publish to unblock release by @ytsarev in https://github.com/k8gb-io/k8gb/pull/2087

### Local Prometheus access ports changed

- Affects: local setup using the Prometheus endpoints

The local setup previously documented and mapped Prometheus access on ports 9080 and 9081; it now documents and maps them on 9090 and 9091, respectively.

> * Fix Prometheus and Grafana exposure by @abaguas in https://github.com/k8gb-io/k8gb/pull/2109

### Grafana Prometheus data sources switch to proxy access

- Affects: local Grafana setups connecting to Prometheus, including k3d/kind host access

In the local setup, Prometheus and Grafana were not always reachable; the local-cluster data sources used `localhost:9080` and `localhost:9081`, and direct browser access is no longer available. The local-cluster URLs now point to `http://172.17.0.1:9090` and `http://172.17.0.1:9091`, while the other data source points to `http://prometheus-server:9090`.

Evidence: “So we need to connect using `proxy` access (from the container). We can use the address `172.17.0.1` to have access to the host network.” https://github.com/k8gb-io/k8gb/pull/2109

> * Fix Prometheus and Grafana exposure by @abaguas in https://github.com/k8gb-io/k8gb/pull/2109

## Important fixes (4)

### [Silent failure] IPv4 DNS resolution fixed for dual-stack load balancers

- Affects: dual-stack setups with load-balancer services exposing IPv4 and IPv6 addresses

In these setups, IPv6 addresses could appear in `DNSEndpoint` A records, which coreDNS converted to `0.0.0.0`, breaking IPv4 DNS resolution. Reconciliation now keeps only IPv4 addresses in `gslb.Status.LoadBalancer.ExposedIPs`, so IPv6 addresses no longer break resolution through A records.

> * Introduce support for IPv4 addresses in dual-stack setups by @abaguas in https://github.com/k8gb-io/k8gb/pull/2125
> - Better support for dual-stack environments, including initial preparation for IPv6

### CoreDNS GeoIP directives now use lowercase names

- Affects: k8gb chart configurations using `geoDataFilePath` or `geoDataField` (Inferred)

When the corresponding chart values were configured, the template previously rendered `geoDataFilePath` and `geoDataField`; it now renders `geodatafilepath` and `geodatafield`.

> - CoreDNS configuration fixes for smoother GeoIP integration

### Grafana and Prometheus services switched to `LoadBalancer` in local setup

- Affects: the local setup using Grafana and Prometheus services

In the local setup, the services were exposed as `NodePort` and were not always reachable on the author's machine. They are now exposed as `LoadBalancer` services.

> * Fix Prometheus and Grafana exposure by @abaguas in https://github.com/k8gb-io/k8gb/pull/2109

### CoreDNS directives use lowercase names

- Affects: Chart configurations that set `geoDataFilePath` or `geoDataField` (Inferred)

When either value was set, the chart previously generated the corresponding directive with a camel-case name. It now uses `geodatafilepath` for `geoDataFilePath` and `geodatafield` for `geoDataField`.

> * fix: geodatafilepath and geodatafield are lowercase in coredns by @actionjax in https://github.com/k8gb-io/k8gb/pull/2103

## Enhancements (9)

- Kubernetes Gateway API integration (To use: k8gb v0.17.0 or later)
- k8gb support for `HTTPRoute`, `GRPCRoute`, `TCPRoute`, `UDPRoute`, and `TLSRoute`
- Gateway API support for `HTTPRoute` and `GRPCRoute`
- Prometheus counter and gauge series initialized at startup
- k8gb Helm charts published to `oci://ghcr.io/k8gb-io/charts`
- Gateway API `TCPRoute` support (To use: A Gateway API `TCPRoute` using `apiVersion: gateway.networking.k8s.io/v1alpha2`, with its hostname supplied through the GSLB's `k8gb.io/hostname` annotation.)
- Gateway API `UDPRoute` support (To use: A `UDPRoute` using `gateway.networking.k8s.io/v1alpha2`, with its hostname supplied in the GSLB's `k8gb.io/hostname` annotation)
- Gateway API `TLSRoute` support
- amd64/arm64 release images and OCI attestations (To use: Docker Buildx `docker-container` driver and QEMU enabled for the release build)

## Dependency updates (12)

12 more, none mentioning security

- `* chore(deps): update dependency k8gb-io/k8gb to v0.16.0 by @renovate[bot] in https://github.com/k8gb-io/k8gb/pull/2085`
- `* chore(deps): update dependency go to v1.25.4 by @renovate[bot] in https://github.com/k8gb-io/k8gb/pull/2079`
- `* fix(deps): update kubernetes packages to v0.34.2 by @renovate[bot] in https://github.com/k8gb-io/k8gb/pull/2112`
- `* fix(deps): update module sigs.k8s.io/controller-runtime to v0.22.4 by @renovate[bot] in https://github.com/k8gb-io/k8gb/pull/2041`
- `* chore(deps): update actions/upload-artifact action to v5 by @renovate[bot] in https://github.com/k8gb-io/k8gb/pull/2091`
- `* fix(deps): update module github.com/gruntwork-io/terratest to v0.54.0 by @renovate[bot] in https://github.com/k8gb-io/k8gb/pull/2094`
- `* chore(deps): update otel/opentelemetry-collector docker tag to v0.141.0 by @renovate[bot] in https://github.com/k8gb-io/k8gb/pull/2088`
- `* fix(deps): update module sigs.k8s.io/external-dns to v0.20.0 by @renovate[bot] in https://github.com/k8gb-io/k8gb/pull/2115`
- `* chore(deps): update dependency go to v1.25.5 by @renovate[bot] in https://github.com/k8gb-io/k8gb/pull/2128`
- `* chore(deps): update otel/opentelemetry-collector docker tag to v0.142.0 by @renovate[bot] in https://github.com/k8gb-io/k8gb/pull/2139`
- `* chore(deps): update terraform kubernetes to v3 by @renovate[bot] in https://github.com/k8gb-io/k8gb/pull/2129`
- `* fix(deps): update all non-major dependencies by @renovate[bot] in https://github.com/k8gb-io/k8gb/pull/2086`

## Other changes (34)

- Local Prometheus and Grafana services now use `LoadBalancer`
- Gateway API documentation expanded with GatewayAPI and Istio examples
- Rollback documentation for procedures and CRD ownership conflicts
- Blog added to the k8gb MkDocs website
- Helm publishing workflow gains manual tag runs and OCI packaging
- Offline Changelog updated
- Helm chart README template now lists tested environments
- Rollback procedures documentation
- k8gb chart README adds CoreDNS 1.45.0 and lists GCP Cloud DNS among tested EdgeDNS environments
- `README.md` updated with Container Days Conference 2025 talks and online publications
- GoReleaser updated to v2.12.7 with v2 configuration
- Makefile `goreleaser` target pins the installed version
- Prometheus values key renamed to `prometheus-pushgateway`
- Makefile version fallback set to `v0.0.0`
- Gateway API integration docs and example namespace for local setup
- Helm chart adds Gateway API RBAC setting
- Helm documentation updated
- Documentation for using Kubernetes `LoadBalancer` Services as GSLB `ResourceRef`s
- Ingress Annotations documentation removed
- `ResourceRef` website integration list formatting fixed
- Website navigation reordered
- Local tutorial `dig` commands now use UDP
- Helm documentation updated
- `golangci/golangci-lint-action` updated to v9
- `actions/checkout` updated to v6
- Documentation expanded with more rollback procedures
- Community meeting agenda moved to GitHub
- K8GB blog site added to MkDocs
- `peter-evans/create-pull-request` action updated to `v8`
- `actions/upload-artifact` updated to `v6`
- `kyverno/action-install-chainsaw` action updated to `v0.2.14`
- Chart README tracing image tags updated
- `kubernetes-sigs/controller-tools` dependency updated to v0.20.0
- k8gb Helm chart version fields updated to v0.17.0

---

Summaries are produced by AI, so they can be wrong, and they are provided without warranty.
