# k8gb v0.17.0

2025-12-24 · [릴리스 노트 원문](https://github.com/k8gb-io/k8gb/releases/tag/v0.17.0) · [전체 정리](https://ratatosk.io/ko/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 주소를 노출하는 로드 밸런서 서비스가 있는 듀얼 스택 구성

이러한 구성에서는 IPv6 주소가 `DNSEndpoint`의 A 레코드에 포함될 수 있었고, coreDNS가 이를 `0.0.0.0`으로 변환해 IPv4 DNS 해석이 실패했습니다. 이제 리컨실리에이션 과정에서 `gslb.Status.LoadBalancer.ExposedIPs`에는 IPv4 주소만 유지하므로, IPv6 주소가 A 레코드를 통한 해석을 더 이상 방해하지 않습니다.

> * 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 차트 설정 (추정)

해당 차트 값을 설정하면 템플릿은 이전에 `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`를 사용하는 Gateway API `TCPRoute`와 GSLB의 `k8gb.io/hostname` 어노테이션으로 제공하는 호스트 이름)
- Gateway API `UDPRoute` 지원 (사용 조건: `gateway.networking.k8s.io/v1alpha2`를 사용하는 `UDPRoute`와 GSLB의 `k8gb.io/hostname` 어노테이션으로 호스트 이름을 제공하는 구성)
- 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` 사용
- Gateway API 문서에 GatewayAPI 및 Istio 예제 추가
- 롤백 절차 및 CRD 소유권 충돌 관련 문서
- k8gb MkDocs 웹사이트에 블로그 추가
- Helm 게시 워크플로에 수동 태그 실행 및 OCI 패키징 추가
- 오프라인 변경 로그 업데이트
- Helm chart README 템플릿에 테스트 환경 목록 추가
- 롤백 절차 문서화
- k8gb 차트 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 차트에 Gateway API RBAC 설정 추가
- Helm 문서 업데이트
- Kubernetes `LoadBalancer` Service를 GSLB `ResourceRef`로 사용하는 방법 문서
- Ingress 어노테이션 문서 제거
- `ResourceRef` 웹사이트 통합 목록 서식 수정
- 웹사이트 내비게이션 순서 변경
- 로컬 튜토리얼의 `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 차트 버전 필드를 v0.17.0으로 갱신

---

정리 내용은 AI가 작성하므로 틀릴 수 있으며, 보증 없이 제공합니다.
