# k8gb v0.17.0

2025-12-24 · [元のリリースノート](https://github.com/k8gb-io/k8gb/releases/tag/v0.17.0) · [全体のまとめ](https://ratatosk.io/ja/releases/k8gb/v0.17.0)

破壊的変更 3 · 重大な修正 4 · 機能・改善 9 · 依存関係の更新 12 · その他の変更 34

## 破壊的変更 (3)

### リリースワークフローからの Helm チャートのパッケージ化と OCI 公開の削除

- 影響対象: `oci://ghcr.io/k8gb-io/charts` から取得した k8gb Helm チャート (推定)

以前は、ワークフローで Helm チャートをパッケージ化し、OCI レジストリにプッシュしていました。このワークフローで作成するリリースでは、同レジストリへのチャートの公開がなくなりました。

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

### Prometheus のローカルアクセス用ポートの変更

- 影響対象: Prometheus エンドポイントを使用するローカル環境のセットアップ

ローカル環境のセットアップでは、以前は Prometheus へのアクセスにポート 9080 と 9081 を使用することがドキュメントに記載され、マッピングされていました。現在はそれぞれポート 9090 と 9091 を使用するように記載・マッピングされています。

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

### Grafana の Prometheus データソースをプロキシ経由に変更

- 影響対象: Prometheus に接続するローカルの Grafana 環境（k3d/kind からのホストアクセスを含む）

ローカル環境では、Prometheus と Grafana に常にアクセスできるとは限りませんでした。ローカルクラスタ用データソースでは `localhost:9080` と `localhost:9081` を使用していましたが、ブラウザーからの直接アクセスは利用できなくなりました。現在、ローカルクラスタの URL は `http://172.17.0.1:9090` と `http://172.17.0.1:9091` を指し、もう一方のデータソースは `http://prometheus-server:9090` を指します。

根拠: “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

## 重大な修正 (4)

### [表面化しなかった不具合] デュアルスタックロードバランサーの IPv4 DNS 解決を修正

- 影響対象: ロードバランサーサービスが IPv4 アドレスと IPv6 アドレスを公開するデュアルスタック構成

このような構成では、`DNSEndpoint` の A レコードに IPv6 アドレスが含まれることがあり、CoreDNS がこれを `0.0.0.0` に変換するため、IPv4 の DNS 解決に支障が出ていました。調整処理では `gslb.Status.LoadBalancer.ExposedIPs` に IPv4 アドレスのみを保持するようになり、A レコードを介した名前解決が IPv6 アドレスによって妨げられることはなくなりました。

> * 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 ディレクティブ名の小文字化

- 影響対象: `geoDataFilePath` または `geoDataField` を使用する k8gb chart の設定 (推定)

対応する chart values を設定した場合、テンプレートはこれまで `geoDataFilePath` と `geoDataField` を出力していましたが、現在は `geodatafilepath` と `geodatafield` を出力します。

> - CoreDNS configuration fixes for smoother GeoIP integration

### ローカルセットアップでの Grafana と Prometheus のサービスの `LoadBalancer` への切り替え

- 影響対象: Grafana と Prometheus のサービスを使用するローカルセットアップ

ローカルセットアップでは、サービスは `NodePort` として公開されており、作成者のマシンから常に到達できるとは限りませんでした。現在は `LoadBalancer` サービスとして公開されます。

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

### CoreDNS ディレクティブ名の小文字化

- 影響対象: `geoDataFilePath` または `geoDataField` を設定するチャート構成 (推定)

いずれかの値が設定されている場合、以前はチャートが対応するディレクティブをキャメルケースの名前で生成していました。現在は、`geoDataFilePath` には `geodatafilepath`、`geoDataField` には `geodatafield` を使用します。

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

## 機能・改善 (9)

- Kubernetes Gateway API との統合 (利用条件: k8gb v0.17.0 以降)
- k8gb の `HTTPRoute`、`GRPCRoute`、`TCPRoute`、`UDPRoute`、`TLSRoute` 対応
- Gateway API の `HTTPRoute` と `GRPCRoute` のサポート
- Prometheus のカウンターとゲージの系列を起動時に初期化
- k8gb Helm チャートを `oci://ghcr.io/k8gb-io/charts` に公開
- Gateway API `TCPRoute` のサポート (利用条件: `apiVersion: gateway.networking.k8s.io/v1alpha2` を使用し、ホスト名を GSLB の `k8gb.io/hostname` アノテーションで指定した Gateway API `TCPRoute`)
- Gateway API の `UDPRoute` 対応 (利用条件: `gateway.networking.k8s.io/v1alpha2` を使用し、ホスト名を GSLB の `k8gb.io/hostname` アノテーションで指定した `UDPRoute`)
- Gateway API `TLSRoute` 対応
- amd64/arm64 リリースイメージと OCI アテステーション (利用条件: リリースビルドでの Docker Buildx `docker-container` ドライバーと QEMU の有効化)

## 依存関係の更新 (12)

ほか12件（いずれもセキュリティへの言及なし）

- `* 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`

## その他の変更 (34)

- ローカルの Prometheus と Grafana サービスでの `LoadBalancer` の使用
- GatewayAPI と Istio の例による Gateway API ドキュメントの拡充
- 手順と CRD 所有権の競合に関するロールバック文書
- k8gb の MkDocs サイトにブログを追加
- Helm 公開ワークフローでのタグ指定手動実行と OCI パッケージ化
- オフライン変更履歴の更新
- Helm chart README テンプレートへのテスト済み環境の記載
- ロールバック手順のドキュメント
- k8gb chart の README に CoreDNS 1.45.0 とテスト済み EdgeDNS 環境として GCP Cloud DNS を追加
- Container Days Conference 2025 の講演とオンライン公開資料を反映した `README.md` の更新
- GoReleaser v2.12.7 への更新と v2 設定の採用
- Makefile の `goreleaser` ターゲットでインストールするバージョンを固定
- Prometheus values のキーを `prometheus-pushgateway` に変更
- Makefile のバージョンフォールバックを `v0.0.0` に設定
- ローカルセットアップ向け Gateway API 統合ドキュメントとサンプル名前空間
- Helm chart に Gateway API の RBAC 設定を追加
- Helm ドキュメントの更新
- GSLB の `ResourceRef` として Kubernetes `LoadBalancer` サービスを使用するためのドキュメント
- Ingress Annotations のドキュメント削除
- `ResourceRef` ウェブサイトの統合一覧の書式修正
- Webサイトのナビゲーションの並び替え
- ローカルチュートリアルの `dig` コマンドを UDP 使用に変更
- Helm ドキュメントの更新
- `golangci/golangci-lint-action` の v9 への更新
- `actions/checkout` の v6 への更新
- ロールバック手順を追加したドキュメントの拡充
- コミュニティミーティング議題の GitHub への移行
- MkDocs に K8GB ブログサイトを追加
- `peter-evans/create-pull-request` アクションの `v8` への更新
- `actions/upload-artifact` の `v6` への更新
- `kyverno/action-install-chainsaw` アクションの `v0.2.14` への更新
- Chart README の tracing イメージタグの更新
- `kubernetes-sigs/controller-tools` 依存関係の v0.20.0 への更新
- k8gb Helm chart のバージョンフィールドを v0.17.0 に更新

---

整理した内容は AI が作成するため誤っている可能性があり、無保証で提供されます。
