# KubeEdge v1.21.1

2025-12-17 · [릴리스 노트 원문](https://github.com/kubeedge/kubeedge/releases/tag/v1.21.1) · [전체 정리](https://ratatosk.io/ko/releases/kubeedge/v1.21.1)

호환성 변경 3 · 중요 수정 6 · 기능·개선 1 · 기타 3

## 호환성 변경 (3)

### MySQL `ReportCycle`의 밀리초 단위 사용

- 영향 대상: MySQL 데이터 메서드와 `ReportCycle`을 사용하는 mapper-framework 설정 (추정)

이전에는 MySQL 핸들러가 시간 단위를 적용하지 않은 채 `ReportCycle`을 `time.Duration`으로 바로 변환했습니다.

근거: “+ reportCycle := time.Millisecond * time.Duration(twin.Property.ReportCycle)” https://github.com/kubeedge/kubeedge/pull/6578

> - Fix data push operation in mapper-framework. ([#6578](https://github.com/kubeedge/kubeedge/pull/6578), [@aAAaqwq](https://github.com/aAAaqwq))

https://github.com/kubeedge/kubeedge/blob/master/CHANGELOG/CHANGELOG-1.21.md

### Redis 정렬 집합 멤버에 JSON 마셜링 데이터 저장

- 영향 대상: mapper-framework Redis 데이터베이스 메서드가 기록하는 Redis 정렬 집합 멤버 (추정)

기존에는 멤버가 `TimeStamp`, `PropertyName`, `data.Value`를 포함한 포맷 문자열이었습니다. 이제 멤버에는 JSON으로 마셜링한 데이터 객체가 저장되며, 정렬 집합의 점수는 계속 `data.TimeStamp`를 기준으로 합니다.

근거: “- deviceData := "TimeStamp: " + strconv.FormatInt(data.TimeStamp, 10) + " PropertyName: " + data.PropertyName + " data: " + data.Value” https://github.com/kubeedge/kubeedge/pull/6578

> - Fix data push operation in mapper-framework. ([#6578](https://github.com/kubeedge/kubeedge/pull/6578), [@aAAaqwq](https://github.com/aAAaqwq))

https://github.com/kubeedge/kubeedge/blob/master/CHANGELOG/CHANGELOG-1.21.md

### Mapper-framework MQTT 설정에서 `mqtt` JSON 키 사용

- 영향 대상: JSON을 통해 MQTT 게시 방식을 설정하는 mapper-framework 구성 (추정)

이전에는 MQTT 설정 필드에 `http` JSON 키를 사용했습니다.

근거: “- MQTT *MQTTConfig `json:"http"`” https://github.com/kubeedge/kubeedge/pull/6578

> - Fix data push operation in mapper-framework. ([#6578](https://github.com/kubeedge/kubeedge/pull/6578), [@aAAaqwq](https://github.com/aAAaqwq))

https://github.com/kubeedge/kubeedge/blob/master/CHANGELOG/CHANGELOG-1.21.md

## 중요 수정 (6)

### PolicyManager 리컨실리에이션에서 비캐시 읽기 사용

- 영향 대상: 클라우드 PolicyManager의 정책 리컨실리에이션 (추정)

최근 생성된 Pod가 캐시 읽기에 보이지 않으면 PolicyManager가 잘못된 리컨실리에이션 결정을 내리고 일부 노드에서 `send2Edge()`를 건너뛸 수 있었습니다. 이제 리컨실리에이션 조회에는 캐시를 사용하지 않는 리더가 사용됩니다.

> - Fix policyManager reconciliation with non-cached reader. ([#6558](https://github.com/kubeedge/kubeedge/pull/6558), [@mkhon](https://github.com/mkhon))

https://github.com/kubeedge/kubeedge/blob/master/CHANGELOG/CHANGELOG-1.21.md

### PolicyManager Pod 업데이트 리컨실리에이션 수정

- 영향 대상: 일치하는 Pod가 있는 PolicyManager 구성

DaemonSet Pod는 처음 생성될 때 `.Spec.NodeName`이 없어 필터링됐고, 이후 업데이트로 리컨실리에이션이 트리거되지 않았습니다. 이제 처음 생성 시 필터링된 뒤에도 일치하는 Pod가 업데이트되면 리컨실리에이션을 트리거할 수 있습니다.

> - Fix policyManager reconciliation with non-cached reader. ([#6558](https://github.com/kubeedge/kubeedge/pull/6558), [@mkhon](https://github.com/mkhon))

https://github.com/kubeedge/kubeedge/blob/master/CHANGELOG/CHANGELOG-1.21.md

### MetaServer의 Leases kind 변환 수정

- 영향 대상: MetaServer가 Leases 리소스나 kind를 처리하는 설정 (추정)

MetaServer가 Leases를 파싱할 때 `Leases` 대신 `Leas`를 생성했습니다. 이제 변환 시 `leases`를 `Leases`로, `Leases`를 `leases`로 매핑합니다.

> - Fix Leases being parsed as Leas in MetaServer. ([#6567](https://github.com/kubeedge/kubeedge/pull/6567), [@brinker-tbaker](https://github.com/brinker-tbaker))

https://github.com/kubeedge/kubeedge/blob/master/CHANGELOG/CHANGELOG-1.21.md

### `keadm reset`의 컨테이너 제거 수정

- 영향 대상: `keadm reset`으로 KubeEdge가 관리하는 컨테이너를 제거하는 엣지 재설정 (추정)

엣지 재설정 흐름에서 컨테이너 런타임에 먼저 연결하지 못하면 컨테이너가 제거되지 않았습니다. 이제 유틸리티는 Kube 컨테이너를 나열하기 전에 런타임에 연결하며, 연결에 실패하면 오류를 반환합니다.

> - Fix keadm reset edge failed to remove containers for containerRuntime.Connect missed. ([#6575](https://github.com/kubeedge/kubeedge/pull/6575), [@will4j](https://github.com/will4j))

https://github.com/kubeedge/kubeedge/blob/master/CHANGELOG/CHANGELOG-1.21.md

### 브로커 연결 오류에도 종료하지 않는 mapper-framework MQTT 퍼블리셔

- 영향 대상: MQTT 퍼블리셔를 사용하는 mapper-framework 설정

이전에는 브로커 연결에 실패하면 오류를 출력하고 프로세스를 종료했습니다. 이제는 오류를 로그에 남기고 `Push`가 반환되며 프로세스는 종료되지 않습니다.

> - Fix data push operation in mapper-framework. ([#6578](https://github.com/kubeedge/kubeedge/pull/6578), [@aAAaqwq](https://github.com/aAAaqwq))

https://github.com/kubeedge/kubeedge/blob/master/CHANGELOG/CHANGELOG-1.21.md

### Mapper-framework OpenTelemetry 핸들러의 디바이스 데이터 타입 어서션 대체

- 영향 대상: OpenTelemetry 데이터 핸들러를 사용하고 해당 핸들러에 디바이스 데이터를 제공하는 Mapper-framework 구성 (추정)

이전에는 핸들러가 직접 `float64` 타입 어서션을 거쳐 데이터를 `ObserveFloat64`에 전달했습니다. 이제 데이터를 문자열로 변환한 다음 `float64`로 파싱하고, 파싱한 값을 관측합니다. 변환이나 파싱에 실패하면 오류를 반환합니다.

> - Fix data push operation in mapper-framework. ([#6578](https://github.com/kubeedge/kubeedge/pull/6578), [@aAAaqwq](https://github.com/aAAaqwq))

https://github.com/kubeedge/kubeedge/blob/master/CHANGELOG/CHANGELOG-1.21.md

## 기능·개선 (1)

- PolicyManager의 `send2Edge` 상세 로그 추가 (사용 조건: `klog.V(4)` 로그 상세 수준)

## 기타 (3)

- NodeUpgradeJob 러너 등록에 `ResourceNodeUpgradeJob` 사용
- MySQL 초기화 오류 로그 메시지 수정
- Mapper 디바이스 데이터 핸들러의 직접 데이터베이스 호출 제거

---

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