NATSv2.11.11
週次メールは確認すべき変更がある週だけ、深刻度がcriticalのセキュリティアドバイザリは即時に届きます。
アップグレード前の確認事項
アップグレードガイド1
2.10.x との互換性に関する 2.11 へのアップグレードガイド
- マイナーバージョン間のアップグレードガイド
Refer to the [2.11 Upgrade Guide](https://docs.nats.io/release-notes/whats_new/whats_new_211) for backwards compatibility notes with 2.10.x.github.com/nats-io/nats-server/releases/tag/v2.11.11
重大な修正28表面化しなかった不具合2
JetStream ストリームのキャッチアップ中のヘルス報告を修正表面化しなかった不具合
影響対象キャッチアップ中の JetStream ストリームストリームのキャッチアップ中は、キャッチアップが完了するまで Raft の状態が進まないため、ヘルスチェックが
group node unhealthyと報告していました。ヘルスチェックはキャッチアップ状態を先に確認し、stream catching upと報告するようになりました。- Healthchecks now correctly report when streams are catching up, instead of showing them as unhealthy (#7535)
github.com/nats-io/nats-server/releases/tag/v2.11.11JetStream filestore の secure erase 時に tombstone が失われる問題の修正
影響対象JetStream filestore で secure erase を使用する構成ブロック内の tombstone より前にあるメッセージを消去した後、インデックスの再構築が必要となる異常終了が発生すると、tombstone が失われ、削除済みメッセージが復元される可能性がありました。このケースでも filestore が tombstone を保持するようになりました。
- The filestore no longer loses tombstones when using secure erase (#7384)
github.com/nats-io/nats-server/releases/tag/v2.11.11JetStream filestore の復旧時におけるシーケンス巻き戻りの修正
影響対象tombstone のみを含むブロックを復旧する JetStream filestore 構成メッセージの確認応答後、対応する tombstone が新しいブロックにあふれ、元のメッセージブロックが削除された状態で異常終了後に再起動すると、既知の tombstone のシーケンスとタイムスタンプの最小値が使われ、ストリームのシーケンスが巻き戻ることがありました。tombstone が複数のブロックにまたがる場合、空のストリームに低すぎる最初のシーケンスが割り当てられることもありました。この場合、復旧処理では既知の tombstone のシーケンスとタイムスタンプの最大値を使うようになりました。
- The filestore no longer loses the last sequence when recovering blocks containing only tombstones (#7384)
github.com/nats-io/nats-server/releases/tag/v2.11.11ストリームレプリカにおける順不同の
SkipMsg処理の修正影響対象レプリカを持つストリームストリームのレプリカが順不同の
SkipMsgを受信すると、本来スキップすべきでないメッセージにスキップ済みの印を付けて削除し、ストリームの同期がずれることがありました。適用前にスキップシーケンスの順序を確認するようになり、キャッチアップ中に同期がずれるのを防ぎます。- Skipped message sequences are now checked for ordering before apply, fixing a potential stream desync on catchups (#7400)
github.com/nats-io/nats-server/releases/tag/v2.11.11フィルストアの消去済みメッセージのギャップ追跡を修正
影響対象フィルストアを使用する JetStream ストリーム(推定)フィルストア内のメッセージのギャップが消去済みの最後のメッセージで終わる場合、消去されたスロットが削除として登録されず、キャッシュが継続的に無効化され、読み取りやキャッチアップが遅くなり、削除の追跡も不正確になっていました。状態の再構築時に、欠落しているシーケンス番号を削除として登録するようになりました。
- Skipped message sequences now correctly detect gaps from erased message slots, fixing potential cache issues, slow reads and issues with catchups (#7399, #7401)
github.com/nats-io/nats-server/releases/tag/v2.11.11Filestore のシーケンスギャップ削除追跡の修正
影響対象filestore を使用する JetStream ストリーム複数の
SkipMsgsを含むブロックが開始時点で空、または完全に空の場合、再構築時に、スキップによってシーケンス番号が進むだけであるにもかかわらず、シーケンスのギャップが削除済みメッセージとしてdmapに記録されることがありました。再構築時に、こうしたギャップは削除済みメッセージのマップに含まれなくなりました。- Skipped message sequences now correctly detect gaps from erased message slots, fixing potential cache issues, slow reads and issues with catchups (#7399, #7401)
github.com/nats-io/nats-server/releases/tag/v2.11.11Raft ピアアクティビティ報告の修正
影響対象API、アセット情報、監視エンドポイントでの Raft グループおよびピアアクティビティの報告リーダーの変更やクラスターのサイズ変更後も古いアクティブ時刻が更新されず、「最終確認時刻」や「アクティブ」の値が実態と異なる場合がありました。このリリースではピアのアクティビティをより一貫して追跡し、リーダーの変更時に古い時刻をクリアするため、報告される値が前のリリースと異なる場合があります。
- Raft groups now report peer activity more consistently, fixing some cases where asset info and monitoring endpoints may report misleading values after leader changes (#7402)
github.com/nats-io/nats-server/releases/tag/v2.11.11キャッチアップ後に Raft フォロワーの WAL が切り詰められる問題の修正
影響対象並行してキャッチアップを実行する Raft フォロワー複数のキャッチアップが並行して実行されていると、完了後に別のキャッチアップから遅れて届いた append をフォロワーが受け入れ、コミット可能と報告済みの WAL エントリーを切り詰めることがありました。キャッチアップ完了後に予期しないキャッチアップエントリーを受信しても、WAL は切り詰められなくなりました。
- Raft groups will no longer permit truncations from unexpected catchup entries if the catchup is completed (#7424)
github.com/nats-io/nats-server/releases/tag/v2.11.11NATS ヘッダーの接尾辞一致バグの修正
影響対象共通の接尾辞を持つヘッダーキーを含むメッセージPrevious-Nats-Msg-Idが存在する状態でNats-Msg-Idの取得、削除、設定を行うと、代わりに先にあるキーと値が使われることがありました。- A couple of issues related to header handling have been fixed (#7465)
github.com/nats-io/nats-server/releases/tag/v2.11.11既存ヘッダーを正しく更新する
setHeader影響対象既存のヘッダー更新にsetHeaderを使用するコード以前は、値の先頭に空白がない既存の
k:vヘッダーに対してsetHeaderでkを設定すると、既存のヘッダーが更新されず、別のヘッダーが追加されていました。- A couple of issues related to header handling have been fixed (#7465)
github.com/nats-io/nats-server/releases/tag/v2.11.11JetStreamの空ストリームにおける
NoWait応答の修正影響対象有効期限を指定しないNoWaitリクエストを使用するJetStreamコンシューマーこのようなリクエストがメッセージを配信せずに空のストリームの末尾に達した場合、以前は
404 No Messagesを受信できませんでしたが、現在は受信できます。- No-wait requests now return a 400 No Messages response correctly if the stream is empty (#7466)
github.com/nats-io/nats-server/releases/tag/v2.11.11Filestore 末尾の欠番補完時に発生するシーケンスエラーの修正
影響対象JetStream filestoreブロック末尾の欠番を埋める際、1つずれた処理により、あるシーケンスが削除済みとマークされ、最後のシーケンスが見落とされることがありました。
- An off-by-one when detecting holes at the end of a filestore block has been fixed (#7508)
github.com/nats-io/nats-server/releases/tag/v2.11.11リーダーのシャットダウン・降格時におけるRaftクォーラム喪失の誤報を修正表面化しなかった不具合
影響対象サーバーがリーダーを務めるRaftグループ以前は、LDM によるリーダーのシャットダウン時やリーダーの降格時にピアのタイムスタンプが消去され、Raft グループがクォーラムを失ったと報告し、「NO quorum, stalled」と表示してアドバイザリを送信していました。現在は、リーダーは降格後も自身のピアのタイムスタンプを保持します。新しいリーダーが稼働した後は、他のフォロワーのタイムスタンプを引き続き消去できます。
- Raft groups should no longer report no quorum incorrectly when shutting down (#7522)
github.com/nats-io/nats-server/releases/tag/v2.11.11JetStream filestore のブロック末尾の欠落検出を修正
影響対象JetStream filestore(推定)ブロック末尾の欠落を検出する際、削除マーカーが最後のシーケンスとして扱われ、削除が見落とされることがありました。filestore は、最後に正常と確認されたシーケンスを基準にシーケンスを処理するようになりました。
- An off-by-one when detecting holes at the end of a filestore block has been fixed (#7525)
github.com/nats-io/nats-server/releases/tag/v2.11.11新規ルート接続でバイナリスナップショットを優先する NATS サーバー
影響対象v2.10.0 以降を実行するサーバーとの新規ルート接続に参加するノード新たに確立されたルート接続で
STATSZが届く前に、サーバーが従来の形式にフォールバックすることがありました。この形式では、中間削除を[]uint64で表現するため、中間削除が多いストリームで膨大なメモリを消費する可能性がありました。- Binary stream snapshots are now preferred by default for nodes on new route connections (#7479)
github.com/nats-io/nats-server/releases/tag/v2.11.11インタレストベースのストリームレプリカの非同期状態からの復旧
影響対象InterestPolicyを使用するクラスター化された JetStream ストリームコンシューマーの変更によって、サーバー間で異なる論理時刻にインタレストが確立されると、レプリカ間で非同期が発生し、異なる初期メッセージが保存されることがありました。サーバーはこの
noInterestの非同期を検出し、インタレストのない先頭メッセージを削除できるようになりました。ただし、根本にある順序競合は引き続き発生する可能性があります。- Improve interest detection when consumers are created or deleted across different servers (#7440)
github.com/nats-io/nats-server/releases/tag/v2.11.11ゲートウェイごとの
hopヘッダー破損の修正影響対象ゲートウェイ間でメッセージトレーシングを使用する構成メッセージトレーシングを有効にした状態で、ゲートウェイごとに
hopヘッダーを設定すると、ヘッダーが破損することがありました。現在は、この問題を起こさずにゲートウェイごとにヘッダーが設定されます。- When using message tracing, header corruption when setting the hop header has been fixed (#7443)
github.com/nats-io/nats-server/releases/tag/v2.11.11レイムダックモードでの接続数上限エラーの修正
影響対象レイムダックモードを使用するサーバー上で、最大接続数の上限を設定しているアカウントアカウントの接続数が上限に近い状態でレイムダックモードに入ると、切断済みの接続がカウントに残り、再接続中のクライアントが二重に数えられていました。そのため、まだ再接続を完了していないクライアントに
maximum account active connections exceededエラーが返されることがありました。接続数の集計を修正し、二重計上を防ぐようになりました。s.Shutdown()によるシャットダウン中は、残りのクライアントを接続数に計上せずに切断できます。- Shutting down a server using lame-duck mode should no longer result in max connection exceeded errors (#7527)
github.com/nats-io/nats-server/releases/tag/v2.11.11JetStream API ハンドラーの競合状態と nil メタデータによるパニックの修正
影響対象JetStream API ハンドラー(consumer-info の処理を含む)一部のハンドラーが
cc.metaをロックせずに参照していたため、競合状態が発生し、nil の場合にはパニックする可能性もありました。該当するハンドラーはロックなしでcc.metaにアクセスしなくなり、consumer-info ハンドラーは使用前に nil かどうかを確認します。- Race conditions and potential panics fixed in the handling of some JetStream API handlers (#7380)
github.com/nats-io/nats-server/releases/tag/v2.11.11ファイルストアの TTL とスケジューリング状態の書き込みでの
sync_alwaysの尊重影響対象TTL またはスケジューリング状態ファイルの書き込みにsync_alwaysを使用する JetStream ファイルストア- The filestore now correctly obeys `sync_always` for writing TTL and scheduling state files (#7385)
github.com/nats-io/nats-server/releases/tag/v2.11.11メッセージ削除エラー時の filestore ロック解放
影響対象filestore を使用する JetStream ストリーム(推定)メッセージの削除中に
slotInfoまたはmb.eraseMsgがエラーを返した場合、filestore は関連するロックを解放せずに戻ることがありました。現在は、エラーを返す前にロックを解放します。- The filestore will now correctly release locks when erasing messages returns an error (#7431)
github.com/nats-io/nats-server/releases/tag/v2.11.11JetStream filestore のシャットダウン時の競合状態の修正
影響対象JetStream filestoreシャットダウン中に
index.dbの生成中にロックが再取得されると、インデックスの書き込み後もfs.StoreMsgが処理を続行し、再起動時に無効なインデックスが残る可能性がありました。- Fixed a race condition in the filestore that could happen between storing messages and shutting down (#7496)
github.com/nats-io/nats-server/releases/tag/v2.11.11並列ストリーム復元時のパニック修正
影響対象起動時の並列ストリーム復元起動時に、アクセス時刻サービスが値を登録する前に
ats.Register()が実行され、「アクセス時刻サービスが起動していません」というパニックが発生することがありました。この場合、AccessTime()は初期タイムスタンプを保存して返すようになりました。起動時には、このタイムスタンプがわずかに古い場合があります。- A panic that could occur when recovering streams in parallel has been fixed (#7503)
github.com/nats-io/nats-server/releases/tag/v2.11.11ストリーム再作成後にJetStreamの監視が正しいRaftグループを使用
影響対象ストリームを再作成した場合の JetStream メタレイヤーリカバリーと、関連するコンシューマー(推定)ストリームとコンシューマーがメタスナップショットに含まれている状態で、ストリームを削除して異なる設定で再作成すると、監視ゴルーチンが削除済みの Raft グループに属するノードを使用し、正常に機能しなくなることがありました。
- Fixed a bug on metalayer recovery where stream and consumer monitor goroutines for recreated assets would run with the wrong Raft group (#7510)
github.com/nats-io/nats-server/releases/tag/v2.11.11R1からR3へのストリームのスケールアップ時におけるスナップショットのインストール修正
影響対象R1からR3へスケールアップするJetStreamストリームスケールアップの途中でJetStreamのキャッチアップに失敗すると、不完全なピアがリーダーになろうとしてストリームの同期がずれる可能性がありました。リカバリーで処理できるようスナップショットがインストールされ、完全に同期するまで新しいピアはリーダーになれません。
- Scaling up an asset from R1 now results in an installed snapshot, allowing recovery after restart if interrupted, avoiding a potential desync (#7509)
github.com/nats-io/nats-server/releases/tag/v2.11.11JetStream の復旧時ヘルスチェックから削除済みコンシューマーを除外
影響対象JetStream のメタレイヤースナップショットの復旧復旧中にメタスナップショット内のコンシューマーが削除された場合、そのコンシューマーがヘルスチェックに再び現れ、
consumer not foundエラーを引き起こすことがありました。- Consumers that existed in a metalayer snapshot but were deleted on recovery will no longer result in failing healthchecks (#7523)
github.com/nats-io/nats-server/releases/tag/v2.11.11JetStream のシャットダウン通知競合の修正
影響対象クラスター構成の JetStreamシャットダウン中、複数のゴルーチンがクラスター終了チャネルを待ち受けていると、
monitorCluster()ではなく別のゴルーチンがシグナルを受け取ることがありました。現在はチャネルを閉じてすべての待ち受け側に通知し、2つ目のチャネルを使ってモニターの終了を待ちます。- Fixed a race condition that could happen with shutdown signals when shutting down JetStream (#7536)
github.com/nats-io/nats-server/releases/tag/v2.11.11ストリームのパージ時のエラー処理におけるデッドロック修正
影響対象ストリームのパージ(推定)コンシューマーの状態が一致せず、パージ中にコンシューマーストアの状態を書き込む際にエラーが発生すると、エラー処理で保持中のストリームロックを再取得しようとしてデッドロックすることがありました。現在は、ロックを再取得せずにストリーム名を取得します。
- Fixed a deadlock that could occur when purging a stream with mismatched consumer state (#7546)
github.com/nats-io/nats-server/releases/tag/v2.11.11
機能・改善7
JetStream のメタレイヤーログにおけるコンパクションしきい値
利用条件 しきい値によるコンパクションを使用するには、
meta_compact、meta_compact_size、または両方を設定- Added `meta_compact` and `meta_compact_size`, advanced JetStream config options to control how many log entries must be present in the metalayer log before snapshotting and compaction takes place (#7484, #7521)
github.com/nats-io/nats-server/releases/tag/v2.11.11クライアント、ルート、ゲートウェイ、リーフノード向けの
write_timeout動作設定- Added `write_timeout` option for clients, routes, gateways and leafnodes which controls the behaviour on reaching the `write_deadline`, values can be `default`, `retry` or `close` (#7513)
github.com/nats-io/nats-server/releases/tag/v2.11.11JetStream メタクラスタのスナップショット統計情報を
/jszで公開- Meta cluster snapshot statistics have been added to the `/jsz` endpoint (#7524)
github.com/nats-io/nats-server/releases/tag/v2.11.11/jszのダイレクトコンシューマー詳細利用条件
direct-consumers=trueクエリパラメーターを指定した/jszリクエスト- The `/jsz` endpoint can now show direct consumers with the `direct-consumers?true` flag (#7543)
github.com/nats-io/nats-server/releases/tag/v2.11.11JetStream キャッチアップログへの経過時間の追加
- Stream catchups will now use delete ranges more aggressively, speeding up catchups of large streams with many interior deletes (#7512)
github.com/nats-io/nats-server/releases/tag/v2.11.11サブジェクト変換による再公開で両フィールドの
>を許可利用条件 ストリーム唯一のサブジェクトをマッピングする
SubjectTransformがあり、RePublish.SourceとRePublish.Destinationの両方に>を指定- Streams with subject transforms can now implicitly republish based on those transforms by configuring `>` for both republish source and destination (#7515)
github.com/nats-io/nats-server/releases/tag/v2.11.11JSZ による Raft リーダー数の報告
利用条件
raftフラグの設定- The `jsz` monitoring endpoint can now report leader counts (#7429)
github.com/nats-io/nats-server/releases/tag/v2.11.11
依存関係の更新6
ほか6件(いずれもセキュリティへの言及なし)
- - 1.25.4 (#7520)
- - golang.org/x/crypto v0.43.0 (#7423)
- - golang.org/x/sys v0.37.0 (#7423)
- - golang.org/x/time v0.14.0 (#7423)
- - golang.org/x/sys v0.38.0 (#7538)
- - github.com/minio/highwayhash 070ab1a (#7539)
その他の変更16
sublist と subject 変換でのアロケーション削減
- Reduced allocations in the sublist and subject transforms (#7519)
github.com/nats-io/nats-server/releases/tag/v2.11.11Observer Mode の初回起動時ログの明確化
- Improved the logging for observer mode (#7433)
github.com/nats-io/nats-server/releases/tag/v2.11.11JetStream filestore の対象メッセージブロックの一括削除
- Improved the performance of enforcing `max_bytes` and `max_msgs` limits (#7455)
github.com/nats-io/nats-server/releases/tag/v2.11.11スナップショットの試行をサーバー終了時に限定
- Streams and consumers will no longer unnecessarily snapshot when being removed or scaling down (#7495)
github.com/nats-io/nats-server/releases/tag/v2.11.11JetStream 起動時のストリーム並列読み込み
- Streams are now loaded in parallel when enabling JetStream, often reducing the time it takes to start up the server (#7482)
github.com/nats-io/nats-server/releases/tag/v2.11.11親ストリーム起動直後の JetStream コンシューマー起動
- Streams are now loaded in parallel when enabling JetStream, often reducing the time it takes to start up the server (#7482)
github.com/nats-io/nats-server/releases/tag/v2.11.11削除数のより低いしきい値で
LoadNextMsgを選択- Stream catchups will now use delete ranges more aggressively, speeding up catchups of large streams with many interior deletes (#7512)
github.com/nats-io/nats-server/releases/tag/v2.11.11スケールアップ時のストリームリーダーのキャッチアップ競合の修正
- A race condition where subscriptions may not be set up before catchup requests are sent after a leader change has been fixed (#7518)
github.com/nats-io/nats-server/releases/tag/v2.11.11JetStream の起動・復旧時の並行処理数を
len(dios)に制限- JetStream recovery parallelism now matches the I/O gated semaphore (#7526)
github.com/nats-io/nats-server/releases/tag/v2.11.11ハッシュチェックを
highwayhash.Digest64に切り替え- Reduced heap allocations in hash checks (#7539)
github.com/nats-io/nats-server/releases/tag/v2.11.11空の先頭 tombstone ブロックのクリーンアップ
- The filestore now correctly cleans up empty blocks when selecting the next first block (#7384)
github.com/nats-io/nats-server/releases/tag/v2.11.11ミラーコンシューマー設定時のデータ競合を修正
- Fixed a data race on a wait group when mirroring streams (#7395)
github.com/nats-io/nats-server/releases/tag/v2.11.11JetStream filestore で最後のシーケンスを繰り返し読み込む際のキャッシュ期限切れを修正
- Caches will now no longer expire unnecessarily when re-reading the same sequences multiple times in first-matching code paths (#7435)
github.com/nats-io/nats-server/releases/tag/v2.11.11NATS のヘッダー処理で
key+":"の文字列割り当てを回避- A couple of issues related to header handling have been fixed (#7465)
github.com/nats-io/nats-server/releases/tag/v2.11.11no-op エントリーの適用後にリーダーシップを報告する Raft リカバリー
- Raft groups will now only report leadership status after a no-op entry on recovery (#7460)
github.com/nats-io/nats-server/releases/tag/v2.11.11JetStream filestore の skip 書き込み中のメッセージブロック mutex 保持
- Writing skip message records in the filestore no longer releases and reacquires the lock unnecessarily (#7508)
github.com/nats-io/nats-server/releases/tag/v2.11.11
整理した内容は AI が作成するため誤っている可能性があり、無保証で提供されます。