RATATOSK
← リリース一覧

NATSv2.11.11

重大な修正 28機能・改善 7依存関係の更新 6その他の変更 16

NATSの通知を受け取る

週次メールは確認すべき変更がある週だけ、深刻度がcriticalのセキュリティアドバイザリは即時に届きます。

アップグレード前の確認事項

アップグレードガイド1
2.10.x との互換性に関する 2.11 へのアップグレードガイド
リンク先ドキュメントからの項目1件
  • マイナーバージョン間のアップグレードガイド
元のリリースノート
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.11
  • JetStream 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.11
  • JetStream 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.11
  • Filestore のシーケンスギャップ削除追跡の修正
    影響対象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.11
  • Raft ピアアクティビティ報告の修正
    影響対象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.11
  • NATS ヘッダーの接尾辞一致バグの修正
    影響対象共通の接尾辞を持つヘッダーキーを含むメッセージ

    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.11
  • JetStreamの空ストリームにおける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.11
  • Filestore 末尾の欠番補完時に発生するシーケンスエラーの修正
    影響対象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.11
  • JetStream 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.11
  • JetStream 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.11
  • JetStream 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.11
  • R1から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.11
  • JetStream の復旧時ヘルスチェックから削除済みコンシューマーを除外
    影響対象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.11
  • JetStream のシャットダウン通知競合の修正
    影響対象クラスター構成の 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.11
  • JetStream メタクラスタのスナップショット統計情報を /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.11
  • JetStream キャッチアップログへの経過時間の追加
    - 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.11
  • JSZ による 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

    整理した内容は AI が作成するため誤っている可能性があり、無保証で提供されます。