# KubeEdge v1.21.1

2025-12-17 · [元のリリースノート](https://github.com/kubeedge/kubeedge/releases/tag/v1.21.1) · [全体のまとめ](https://ratatosk.io/ja/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 設定における JSON キーの `mqtt` への変更

- 影響対象: JSON で MQTT の publish method を設定する Mapper-framework の構成 (推定)

従来、MQTT 設定フィールドには JSON キーとして `http` が使われていました。

根拠: “- 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 でも、該当する 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 種別変換の修正

- 影響対象: MetaServer が Leases リソースまたは種別を処理する構成 (推定)

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 publisher

- 影響対象: MQTT publisher を使用する 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 が作成するため誤っている可能性があり、無保証で提供されます。
