# Linkerd edge-25.12.3

2025-12-18 · [릴리스 노트 원문](https://github.com/linkerd/linkerd2/releases/tag/edge-25.12.3) · [전체 정리](https://ratatosk.io/ko/releases/linkerd/edge-25.12.3)

호환성 변경 1 · 중요 수정 3 · 의존성 갱신 10 · 기타 6

## 호환성 변경 (1)

### linkerd-cni 기본 이미지 버전을 `v1.6.5`로 업데이트

- 영향 대상: 차트 또는 생성된 설치 매니페스트를 사용하고 기본 이미지 버전에 의존하는 CNI 플러그인 배포 (추정)

CNI 차트의 이미지 버전 기본값은 `v1.6.4`였습니다.

근거: “- version: "v1.6.4" + version: "v1.6.5"” https://github.com/linkerd/linkerd2/pull/14816

> * chore(deps): bump proxy-init(v2.4.4), linkerd-cni(v1.6.5) and validator(0.1.5) by @alpeb in https://github.com/linkerd/linkerd2/pull/14816

## 중요 수정 (3)

### `Get` API에서 네이티브 사이드카 opaque 포트 정보 노출

- 영향 대상: 해당 포트를 이름으로 참조하는 `Server` 리소스에서 opaque로 표시된 포트가 있는 네이티브 사이드카

`Server`가 이름으로 네이티브 사이드카 포트를 참조할 때, `Get` API는 해당 포트의 opaque 정보를 누락했습니다.

> This release correctly discovers ports and port opacity when using native sidecars, and fixes a race condition in the CNI plugin that could prevent proper deployment in some environments, particularly EKS.
> * fix(destination): properly discover native sidecar ports by @alpeb in https://github.com/linkerd/linkerd2/pull/14814

### 네이티브 사이드카 opaque 포트 감지 수정

- 영향 대상: `config.linkerd.io/opaque-ports` 어노테이션으로 네이티브 사이드카 포트를 opaque로 지정한 direct-IP 파드 접근

이전에는 `getProfile`이 init 컨테이너를 건너뛰어 어노테이션된 네이티브 사이드카 포트를 opaque로 표시하지 못했습니다. 이제 어노테이션을 해석할 때 해당 컨테이너의 포트도 포함합니다.

> * fix(destination): properly deal with native sidecar port opacity in getProfile by @alpeb in https://github.com/linkerd/linkerd2/pull/14791
> This release correctly discovers ports and port opacity when using native sidecars, and fixes a race condition in the CNI plugin that could prevent proper deployment in some environments, particularly EKS.

### CNI 플러그인 배포 레이스 컨디션 수정

- 영향 대상: CNI 플러그인을 사용하는 설정, 특히 EKS 환경

일부 환경, 특히 EKS에서는 레이스 컨디션으로 인해 정상적인 배포가 진행되지 않을 수 있었습니다. 이번 릴리스에서 배포를 막던 레이스 컨디션을 수정했습니다.

> This release correctly discovers ports and port opacity when using native sidecars, and fixes a race condition in the CNI plugin that could prevent proper deployment in some environments, particularly EKS.

## 의존성 갱신 (10)

그 외 10건 · 보안 언급 없음

- `* build(deps): bump google.golang.org/protobuf from 1.36.10 to 1.36.11 by @dependabot[bot] in https://github.com/linkerd/linkerd2/pull/14805`
- `* build(deps): bump tokio-metrics from 0.4.5 to 0.4.6 by @dependabot[bot] in https://github.com/linkerd/linkerd2/pull/14784`
- `* build(deps): bump helm.sh/helm/v3 from 3.19.2 to 3.19.4 by @dependabot[bot] in https://github.com/linkerd/linkerd2/pull/14804`
- `* build(deps): bump indexmap from 2.12.0 to 2.12.1 by @dependabot[bot] in https://github.com/linkerd/linkerd2/pull/14785`
- `* chore(deps): bump proxy-init(v2.4.4), linkerd-cni(v1.6.5) and validator(0.1.5) by @alpeb in https://github.com/linkerd/linkerd2/pull/14816`
- `* chore(deps): bump proxy-init(v2.4.4), linkerd-cni(v1.6.5) and validator(0.1.5) by @alpeb in https://github.com/linkerd/linkerd2/pull/14816`
- `* build(deps): bump the kube group with 7 updates by @dependabot[bot] in https://github.com/linkerd/linkerd2/pull/14797`
- `* build(deps): bump rustls-pki-types from 1.13.0 to 1.13.1 by @dependabot[bot] in https://github.com/linkerd/linkerd2/pull/14810`
- `* build(deps): bump socket2 from 0.6.0 to 0.6.1 by @dependabot[bot] in https://github.com/linkerd/linkerd2/pull/14811`
- `* build(deps): bump hostname from 0.4.1 to 0.4.2 by @dependabot[bot] in https://github.com/linkerd/linkerd2/pull/14787`

## 기타 (6)

- cli-setup GitHub Action의 `actions/download-artifact` 7.0.0 업데이트
- GitHub 액션 `dessant/lock-threads` 5.0.1에서 6.0.0으로 업데이트
- `actions/download-artifact` 7.0.0으로 업데이트
- `actions/upload-artifact`의 6.0.0 버전 업데이트
- `/web/app`의 `webpack-bundle-analyzer` 의존성 5.1.0으로 업데이트
- `tj-actions/changed-files` 업데이트

---

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