# containerd v2.1.6

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

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

## 업그레이드 전 확인

### 전제 조건

- **추가 설치 요건**: containerd 외에도 runc와 CNI 플러그인은 일반적으로 공식 사이트에서 설치해야 합니다.
  > In addition to containerd, typically you will have to install [runc](https://github.com/opencontainers/runc/releases)
  > and [CNI plugins](https://github.com/containernetworking/plugins/releases) from their official sites too.

## 보안 (1)

### CRI 실패 로그의 URL 쿼리 매개변수 마스킹

- 영향 대상: CRI `PullImage`, `ListImages`, `ImageStatus`, `RemoveImage` 작업 (추정)

이 작업에서 실패하면 `*url.Error`를 포함한 오류를 로그에 남기기 전에 URL 쿼리 매개변수를 모두 `[REDACTED]`로 바꿉니다.

> * Redact all query parameters in CRI error logs ([#12547](https://github.com/containerd/containerd/pull/12547))
>   * [`b72d0dfe0`](https://github.com/containerd/containerd/commit/b72d0dfe0458e1b5f1e67ba70476fc4887ee5f08) fix: redact all query parameters in CRI error logs

## 호환성 변경 (3)

### 2.1 브랜치 빌드의 최신 릴리스 지정 중단

- 영향 대상: 최신 릴리스 지정을 기준으로 릴리스를 선택하는 사용자 또는 자동화 (추정)

이전에는 2.1 브랜치 빌드가 최신 릴리스로 지정되어 2.2 빌드의 지정을 덮어쓸 수 있었습니다.

> * Update 2.1 branch to no longer build as latest ([#12487](https://github.com/containerd/containerd/pull/12487))
>   * [`ecd58bd65`](https://github.com/containerd/containerd/commit/ecd58bd6507cb6c566c68b440ceea5d7d99b3260) Update 2.1 branch to no longer build as latest
> </p>
> </details>

### Windows 호스트와 컨테이너의 호환성 매칭에 Server 2025 추가

- 영향 대상: Windows 호스트와 컨테이너의 호환성 매칭

매처가 `ltsc2025`를 빌드 `26100`으로 인식하고, 호환성 목록에 `ltsc2022`와 함께 포함합니다. 컨테이너 빌드 검사에서는 호스트 빌드보다 낮은 목록상 최신 LTSC 릴리스를 하한값으로 사용합니다.

> * Add WS2025 to Windows matcher and code optimizations ([containerd/platforms#24](https://github.com/containerd/platforms/pull/24))
>   * [`4549974`](https://github.com/containerd/platforms/commit/4549974181760492ffc528fae4d7f29620a2c67c) Add WS2025 to Windows matcher and code optimizations

### Go 1.23 빌드 지원 제거

- 영향 대상: Go 1.23을 사용하는 빌드 환경
- 필요 조치: containerd 빌드에 Go 1.24.0 필요

> * go.mod: golang.org/x/crypto v0.45.0 (drop support for Go 1.23) ([#12639](https://github.com/containerd/containerd/pull/12639))
>   * [`55a2d8c8d`](https://github.com/containerd/containerd/commit/55a2d8c8d0bf6c5a7481c8922eb5a351f82f9344) CI: drop Go 1.23
>   * [`fd8e3c39b`](https://github.com/containerd/containerd/commit/fd8e3c39b952b2fb9278df64f9de4e46fa78dd36) Update Go requirements in BUILDING

## 중요 수정 (1)

### 기본 Windows 플랫폼 매처의 전체 `OSVersion` 기준 일치 항목 정렬

- 영향 대상: 일치하는 플랫폼 항목(예: 매니페스트 항목)을 정렬할 때 기본 Windows 플랫폼 매처를 사용하는 설정

이전에는 Windows 플랫폼이 둘 다 일치하면 `Less`가 `winRevision`을 통해 버전의 네 번째 구성 요소만 비교했습니다. 이제는 두 플랫폼의 전체 `OSVersion` 문자열을 비교합니다.

> * use windowsMatchComparer for OSVersion match order ([containerd/platforms#25](https://github.com/containerd/platforms/pull/25))
>   * [`8c0d9f9`](https://github.com/containerd/platforms/commit/8c0d9f9835bbe848b9c6f6f4a3a23f7dc97de927) use windowsMatchComparer for OSVersion match order

## 의존성 갱신 (21)

### `golang.org/x/crypto`를 `v0.41.0`에서 `v0.45.0`으로 업데이트

- [CVE-2025-47913](https://www.cve.org/CVERecord?id=CVE-2025-47913), [CVE-2025-47914](https://www.cve.org/CVERecord?id=CVE-2025-47914), [CVE-2025-58181](https://www.cve.org/CVERecord?id=CVE-2025-58181), [GHSA-56w8-48fp-6mgv](https://github.com/advisories/GHSA-56w8-48fp-6mgv), [GHSA-f6x5-jh6r-wrfv](https://github.com/advisories/GHSA-f6x5-jh6r-wrfv), [GHSA-j5w8-q4qc-rx2x](https://github.com/advisories/GHSA-j5w8-q4qc-rx2x), [GO-2025-4116](https://osv.dev/vulnerability/GO-2025-4116)

이번 업데이트로 `v0.41.0`에서 발견된 취약점에 대한 `govulncheck` 보고가 더 이상 나오지 않습니다.

> * go.mod: golang.org/x/crypto v0.45.0 (drop support for Go 1.23) ([#12639](https://github.com/containerd/containerd/pull/12639))
>   * [`e81678853`](https://github.com/containerd/containerd/commit/e816788537ca2b9484aa86da58391923e873f571) go.mod: golang.org/x/crypto v0.45.0

그 외 20건 · 보안 언급 없음

- `` * go.mod: containerd/zfs v2.0.0 ([#12655](https://github.com/containerd/containerd/pull/12655)) * [`7e75db3a9`](https://github.com/containerd/containerd/commit/7e75db3a929414f46a3e7c8790ea0eec3288e394) build(deps): bump github.com/containerd/zfs/v2 from 2.0.0-rc.0 to 2.0.0 ``
- `` * go.mod: github.com/containernetworking/plugins v1.9.0 ([#12659](https://github.com/containerd/containerd/pull/12659)) * [`69efd067c`](https://github.com/containerd/containerd/commit/69efd067caca778588edd945a5e9f2a4feb156a6) go.mod: github.com/containernetworking/plugins v1.9.0 ``
- `` * Update runc binary to v1.3.4 ([#12618](https://github.com/containerd/containerd/pull/12618)) * [`251f0a285`](https://github.com/containerd/containerd/commit/251f0a2854f7831ca040d7ba2dab181fd02f2240) runc: Update runc binary to v1.3.4 ``
- `` * build(deps): bump github.com/opencontainers/selinux ([#12590](https://github.com/containerd/containerd/pull/12590)) * [`55a25ec6e`](https://github.com/containerd/containerd/commit/55a25ec6efa335cdb9e6b56207643f33277be4d4) build(deps): bump github.com/opencontainers/selinux ``
- `* **github.com/containerd/platforms**         v1.0.0-rc.1 -> v1.0.0-rc.2`
- `* **github.com/containerd/zfs/v2**            v2.0.0-rc.0 -> v2.0.0`
- `* **github.com/containernetworking/plugins**  v1.7.1 -> v1.9.0`
- `* **github.com/coreos/go-systemd/v22**        v22.5.0 -> v22.6.0`
- `* **github.com/cyphar/filepath-securejoin**   v0.5.1 **_new_**`
- `* **github.com/go-logr/logr**                 v1.4.2 -> v1.4.3`
- `* **github.com/opencontainers/selinux**       v1.12.0 -> v1.13.1`
- `* **github.com/vishvananda/netlink**          0e7078ed04c8 -> v1.3.1`
- `* **golang.org/x/crypto**                     v0.36.0 -> v0.45.0`
- `* **golang.org/x/mod**                        v0.24.0 -> v0.29.0`
- `* **golang.org/x/net**                        v0.38.0 -> v0.47.0`
- `* **golang.org/x/sync**                       v0.14.0 -> v0.18.0`
- `* **golang.org/x/sys**                        v0.33.0 -> v0.38.0`
- `* **golang.org/x/term**                       v0.30.0 -> v0.37.0`
- `* **golang.org/x/text**                       v0.23.0 -> v0.31.0`
- `* **google.golang.org/protobuf**              v1.36.6 -> v1.36.7`

## 기타 (6)

- v2.1.6 릴리스 노트 준비 완료
- Linux CRI/NRI의 nil 조정값 조기 반환
- Runtime v2 gRPC OpenTelemetry 계측을 stats 핸들러로 이전
- CI 및 릴리스 빌드용 Go 툴체인 버전 업데이트
- Ubuntu 24.04 지원을 위한 CIFuzz `build_fuzzers` 및 `run_fuzzers` 액션 업데이트
- containerd/platforms CI 워크플로의 Go 및 project-checks 버전 업데이트

---

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