RATATOSK
← 전체 릴리스

NATSv2.12.3

보안 4호환성 변경 6중요 수정 27기능·개선 13의존성 갱신 8기타 11

NATS 알림 받기

확인할 변경이 있을 때만 주 1회, critical 보안 공지는 즉시 발송

업그레이드 전 확인

업그레이드 안내1
2.11.x 사용자용 2.12 업그레이드 가이드
링크된 문서 항목 2건
  • GOMEMLIMIT으로 제어하는 GC 임계값사용 가능한 시스템 메모리나 Kubernetes의 메모리 예약량에 따라 GOMEMLIMIT을 조정하는 것이 적절할 수 있다고 안내합니다.
  • 다운그레이드 후 스트림 상태 파일 재구축v2.12에서 v2.11로 다운그레이드한 뒤 처음 재시작할 때 모든 스트림 메시지 블록을 다시 스캔합니다. 이로 인해 CPU 사용량이 늘고 재시작한 노드가 정상 상태를 보고하기까지 지연될 수 있습니다. 데이터 손실은 발생하지 않습니다.
릴리스 노트 원문
Refer to the [2.12 Upgrade Guide](https://docs.nats.io/release-notes/whats_new/whats_new_212) for backwards compatibility notes with 2.11.x.
github.com/nats-io/nats-server/releases/tag/v2.12.3

보안4medium1

WebSocket 압축 폭탄으로 인한 메모리 사용 문제 수정

medium

2026-02-23 릴리스 뒤 보안 공지 GHSA-qrvq-68c2-7grw 공개

영향 대상압축된 프레임을 수신하는 WebSocket 연결

이전에는 압축률이 매우 높은 프레임을 압축 해제할 때, 서버가 최대 페이로드 크기 초과를 이유로 거부하기 전에 매우 큰 버퍼가 만들어질 수 있었습니다. 이로 인해 메모리를 과도하게 사용하고 서버가 종료될 위험이 있었습니다. 이제 압축 해제는 설정된 최대 페이로드 크기에서 중단됩니다. 최대 크기를 지정하지 않으면 기본 최대 크기를 적용하며, ErrMaxPayload를 반환합니다.

원문 보기
- WebSocket connections will now correctly limit the buffer size during decompression (#7625, thanks to Pavel Kokout at Aisle Research)
github.com/nats-io/nats-server/releases/tag/v2.12.3
보안 공지
This was fixed in the v2.11 series with v2.11.12 and in the v2.12 series with v2.12.3.
github.com/nats-io/nats-server/security/advisories/GHSA-qrvq-68c2-7grw

MQTT 클라이언트와 비클라이언트 연결에 대한 암묵적 $MQTT. subject 권한

영향 대상라우트와 리프 연결을 포함한 MQTT 클라이언트 및 비클라이언트 연결

이전에는 설정된 구독 권한에 JetStream 컨슈머 구독에서 사용하는 $MQTT_sub. 접두사에 대한 명시적 허용 규칙이 필요했습니다. 이제 이러한 연결은 허용 규칙이 없어도 $MQTT. 접두사가 붙은 subject에 publish하고 subscribe할 수 있지만, deny ACL은 계속 적용됩니다. 일반 NATS 코어 클라이언트에는 암묵적 허용이 적용되지 않습니다.

원문 보기
- Permissions to `$MQTT.` subscriptions are now handled implicitly, with the exception of `deny` ACLs which still permit restriction (#7637)
github.com/nats-io/nats-server/releases/tag/v2.12.3

TLS cipher suite 선택 방식 업데이트

영향 대상보안에 취약하거나 새로 제공되는 cipher suite에 의존하는 TLS 연결(추정)

crypto/tls의 새 cipher suite는 자동으로 추가됩니다. allow_insecure_cipher_suites를 활성화하지 않으면 보안에 취약한 cipher suite는 기본적으로 비활성화됩니다.

원문 보기
Use cipher suites from crypto/tls : New cipher suites are now automatically added. Additionally, insecure cipher suites are disabled by default, but can be allowed when enabling allow_insecure_cipher_suites .
docs.nats.io/release-notes/whats_new/whats_new_212

연결 로그에 식별 정보 추가

영향 대상클라이언트 연결 관련 로그와 연결 종료 로그(추정)

클라이언트 연결 관련 로그에는 계정 이름과 사용자가 포함됩니다. 연결 종료 로그에는 원격 서버 이름이 포함됩니다.

원문 보기
Account name and user logging: Any logging related to a client connection, for example when reaching maximum connections or for authentication errors, will now include the account name and user of that client connection. Connection closed logging now includes the remote server name.
docs.nats.io/release-notes/whats_new/whats_new_212

호환성 변경6

피어 제거 요청에 응답하기 전에 쿼럼을 기다리는 JetStream 메타 계층

영향 대상JetStream 메타 계층에서 처리하는 피어 제거 요청을 보내는 구성(추정)

이전에는 메타 리더가 피어 제거가 쿼럼에 반영되기 전에 성공을 보고할 수 있었습니다. 그러면 클러스터는 그대로인데도 사용자나 자동화 프로세스는 클러스터 크기가 줄었다고 생각할 수 있었습니다.

원문 보기
- The meta layer will now only respond to peer remove requests after quorum has been reached (#7581)
github.com/nats-io/nats-server/releases/tag/v2.12.3

디스크 작업에 맞춘 Filestore 제거 회계 처리

영향 대상Filestore 메시지 제거(추정)

이전에는 tombstone 기록 실패가 드러나지 않을 수 있었고, 보안 삭제 실패로 디스크 상태보다 회계 정보가 앞서갈 수 있었습니다. 이제 tombstone 기록 실패는 오류로 보고됩니다.

원문 보기
- The filestore now will process message removal on disk before updating accounting, which improves error handling (#7595, #7601)
github.com/nats-io/nats-server/releases/tag/v2.12.3

파일스토어 및 컨슈머 작업의 메시지 블록 로드 오류 전파

영향 대상캐시되지 않은 메시지 블록을 로드하는 파일스토어 및 컨슈머 작업(추정)

캐시되지 않은 메시지 블록을 로드하지 못하면 해당 작업은 계속 진행하는 대신 오류를 반환하거나 전파합니다.

원문 보기
- Improved error handling within the loading of message blocks if not already cached (#7631)
github.com/nats-io/nats-server/releases/tag/v2.12.3

MQTT 최대 페이로드 크기 제한 적용

영향 대상최대 페이로드 크기를 설정한 MQTT 클라이언트(추정)

이전에는 전체 NATS 메시지 크기가 최대 페이로드 크기를 초과하는 MQTT 퍼블리시가 연결 검사에서 실패하지 않고 조용히 수락될 수 있었습니다. 이제 이러한 퍼블리시는 해당 검사에서 실패합니다.

원문 보기
- The maximum payload size is now correctly enforced for MQTT clients (#7555, thanks to @yixianOu)
github.com/nats-io/nats-server/releases/tag/v2.12.3

Raft 동시 멤버십 변경 차단

영향 대상JetStream 피어 제거 작업을 포함해 Raft 멤버십 변경을 수행하는 설정

이전에는 진행 중인 멤버십 변경이 있어도 새로운 변경을 제안할 수 있었습니다. 이제 리더는 동시에 진행되는 변경을 버리며, JetStream 피어 제거 작업은 member-change-in-progress 오류를 반환할 수 있습니다.

근거“A simple approach based to avoid concurrent membership changes. The leader simply drops a membership change if there is another membership change in progress. A membership is in progress if it has been proposed, but not committed yet.” nats-io/nats-server/pull/7565 ↗
원문 보기
- Raft will no longer allow multiple membership changes to take place concurrently (#7565, #7609)
github.com/nats-io/nats-server/releases/tag/v2.12.3

복제된 인메모리 스트림 복구 안정성 향상

영향 대상복제된 인메모리 스트림

서버를 하나만 남기고 모두 재시작한 뒤에도 스트림 데이터가 안정적으로 따라잡을 수 있습니다. 복구 중에는 쿼럼만 확보하는 것으로는 부족하며, 해당 스트림을 복제하는 모든 서버가 가용 상태여야 합니다.

원문 보기
-
Stream/consumer scaleup and reset disk/state protection: The server now has better protections against leader elections based on empty state. This also improves reliability of replicated in-memory streams. Usually a quorum of servers needs to be online and contain data. Now all but one server can be restarted and the in-memory stream's data can reliably be caught back up. However, during such a scenario all servers involved with replication of that stream will need to be available, not just what's needed for quorum. This lets the servers decide the best course of action to preserve all data.
docs.nats.io/release-notes/whats_new/whats_new_212

중요 수정27

  • 잘못된 subject filter의 매칭 동작 수정
    영향 대상끝에 오지 않는 전체 와일드카드가 포함된 잘못된 subject filter

    잘못된 필터 foo.>.bar는 일치 항목이 0개여야 하지만, 예기치 않게 bar와 일치할 수 있었습니다. 이제는 bar와 일치하지 않습니다.

    - Invalid subject filters containing non-terminating full wildcard no longer produce unexpected matches (#7585)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • 파일스토어의 전체 메시지 블록 퍼지 시 subject 및 스케줄 추적 정보 갱신
    영향 대상메시지 블록 전체를 퍼지하는 파일스토어

    제한을 적용하기 위해 퍼지하는 경우를 포함해 메시지 블록 전체를 퍼지하면, subject별 상태가 조정되지 않거나 예약 메시지 메타데이터가 남아 있을 수 있었습니다.

    - When purging whole message blocks, the subject tracking and scheduled messages are now updated correctly (#7593)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • 제거된 피어의 응답을 무시하는 Raft 쿼럼 계산
    영향 대상피어 멤버십을 사용하는 Raft 그룹

    Raft가 피어 멤버십에서 제거된 노드로부터 append-entry 응답을 받으면, 오류가 반환되지 않은 경우에도 해당 응답이 쿼럼 계산에 잘못 반영될 수 있었습니다.

    - Raft will no longer count responses from peer-removed nodes towards quorum (#7589)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • Filestore의 대기 중인 쓰기 손실 수정
    영향 대상AsyncFlush를 설정한 filestore

    프로세스가 충분히 오래 멈춘 상태에서 sync_interval에 맞춰 syncBlocks가 실행되면 대기 중인 쓰기가 손실될 수 있었습니다. 이제 syncBlocks는 대기 중인 쓰기를 플러시하고, 쓰기가 대기 중일 때 블록 파일 디스크립터를 닫지 않아 쓰기 손실을 방지합니다.

    - The filestore will no longer unexpectedly lose writes when `AsyncFlush` is enabled after a process pause (#7594)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • 암묵적 ACK 계산 시 리더 멤버십 확인
    영향 대상리더가 멤버십에 포함되지 않은 Raft 그룹(추정)

    이전에는 리더가 더 이상 멤버가 아니어도 쿼럼 계산에서 리더의 암묵적 ACK를 셀 수 있었습니다.

    - Raft quorum counting has been refactored so the implicit leader ack is now only counted if still a part of the membership (#7600)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • Raft 피어 제거 시 상태 즉시 영속화
    영향 대상ProposePeerRemove를 통한 Raft 피어 제거

    이전에는 리더가 ProposePeerRemove로 피어를 제거한 뒤 재시작하면, 오래된 피어 및 쿼럼 정보를 다시 불러와 커밋된 멤버십 변경 사항을 잊을 수 있었습니다.

    - Raft now writes the peer state immediately when handling a peer-remove to ensure the removed peers cannot unexpectedly reappear after a restart (#7602)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • 복제 스트림 폐기 정책 동기화 불일치 수정
    영향 대상DiscardNewPerSubject 및 MaxMsgsPerSubject로 설정된 복제 스트림

    스냅샷을 따라잡는 중 스냅샷 이후에 메시지가 삭제되고, 폐기 정책에 막힌 클라이언트가 해당 subject에 반복해서 메시지를 게시하면, 따라잡는 중인 팔로워가 해당 시퀀스에 다른 메시지를 저장해 다른 서버와 달라질 수 있었습니다. 이제 리더는 폐기 정책을 통과하지 못한 메시지를 팔로워에게 제안하기 전에 거부해 동기화 불일치 가능성을 낮춥니다.

    - The `DiscardNewPerSubject` retention policy is now enforced by the leader before proposing rather than by individual replicas, reducing the potential for stream desync (#7607)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • Raft의 마지막 피어 제거 거부
    영향 대상Raft에서 마지막으로 남은 피어를 대상으로 하는 피어 제거 작업

    이전에는 제거 요청이 수락되어 클러스터가 유효하지 않은 상태가 될 수 있었지만, 이제 해당 피어는 멤버십에 남습니다.

    - Raft will no longer allow peer-removing the one remaining peer (#7610)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • 대규모 컴팩션 중 Filestore 메시지 손실 수정
    영향 대상컴팩션 중인 Filestore 블록

    컴팩션으로 파일 저장 공간의 절반 넘게 회수한 경우, 파일을 잘라낸 뒤 압축된 바이트를 모두 쓰기 전에 프로세스가 강제 종료되면 메시지가 손실될 수 있었습니다. 이제 압축된 바이트를 별도 파일에 쓴 다음 원본 파일을 원자적으로 대체합니다.

    - Compactions that reclaim over half of the available space now use an atomic write to avoid losing messages if killed (#7627)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • Raft 피어 집합에서 제거된 리더를 다시 추가하지 않음
    영향 대상피어 제거와 리더십 이전이 진행 중인 Raft 그룹

    피어 제거가 커밋된 뒤 리더십 이전이 처리되기 전에 하트비트가 발생하면, 팔로어가 제거된 리더를 피어 집합에 다시 추가할 수 있었습니다. 이제 해당 순서에서는 제거된 리더를 다시 추가하지 않습니다.

    - Raft groups should no longer readmit a previously removed peer if a heartbeat occurs between the peer removal and the leadership transfer (#7649)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • 복제 파일 기반 스트림 스냅샷 동기화 오류 수정
    영향 대상복제된 파일 기반 스트림

    스트림 스냅샷을 생성하는 동안 메시지를 제거하면 스트림의 동기화가 어긋날 수 있었고, 스냅샷이 진행 중일 때는 메시지 제거 요청이 거부됐습니다.

    - Potential stream desyncs that could happen during stream snapshotting have been fixed (#7655)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • MQTT retained 메시지 캐시 본문 손상 수정
    영향 대상retained 메시지 캐싱을 사용하는 클러스터형 MQTT 배포

    S-2에서 일치하는 MQTT 구독이 시작된 뒤 retained 메시지를 캐시에 저장한 상태에서, S-1이 같은 subject에 더 최신 retained 메시지를 보내면 캐시된 본문에 추가 \r\n이나 임의의 데이터가 남을 수 있었습니다. 새 본문을 캐시에 복사하고 끝에 붙은 \r\n을 제거합니다.

    - A bug which could corrupt retained messages in clustered deployments has been fixed (#7622)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • 서버 재시작 후 MQTT QoS2 메시지 전달 수정
    영향 대상MQTT QoS2 구독

    서버가 재시작된 뒤 구독을 다시 시작하면 오프라인 동안 저장된 메시지도 새로 들어오는 메시지도 받지 못했습니다. 이제 저장된 메시지를 가져오고 새 메시지도 받을 수 있습니다.

    - A bug where QoS2 messages could not be retrieved after a server restart has been fixed (#7643)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • 계정 간 MQTT retained 메시지 subject 변환 수정
    영향 대상다른 계정에서 가져온 subject transform 적용 MQTT retained-message stream

    복구 중에는 stream 메시지 subject에서 prefix를 제거한 뒤, 해당 값으로 topic과 subject를 다시 생성합니다.

    - Retained messages will now work correctly even when sourced from a different account and has a subject transform (#7636)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • JetStream ACK의 중복 @<subject> 접미사 수정
    영향 대상게이트웨이와 route 또는 leaf 트래픽이 있고 로컬 구독에 캡처된 stream import를 사용하는 JetStream 구성

    ACK 응답이 게이트웨이를 통과하고, 로컬 구독에 캡처된 stream import가 사용된 뒤, 응답이 route 또는 leaf를 통해 전달되면 중복 접미사로 인해 프로토콜 오류가 발생했습니다.

    - A protocol error caused by an invalid transform of acknowledgement reply subjects when originating from a gateway connection has been fixed (#7579)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • 할당 또는 노드 누락 시 JetStream 스냅샷 처리 패닉 방지
    영향 대상할당 또는 노드가 누락된 스트림의 JetStream 스냅샷 처리

    패닉을 일으키는 대신 errCatchupStreamStopped를 반환합니다.

    - A panic when processing snapshots with missing nodes or assignments has been fixed (#7588)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • 거의 비어 있는 Filestore 스트림의 시퀀스 복구 수정
    영향 대상컴팩션되거나 purge되어 시퀀스 2까지 남은 거의 비어 있는 Filestore 스트림

    서버가 컴팩션 또는 purge 후 톰스톤을 쓰기 전에 강제 종료되면 시퀀스를 복구할 수 없었습니다. 이제 이 상황에서도 복구할 수 있도록 톰스톤을 씁니다.

    - Tombstones are now correctly written for recovering the sequences after compacting or purging an almost-empty stream to seq 2 (#7627)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • Filestore 빈 블록 덮어쓰기 수정
    영향 대상filestore 스트림

    SkipMsg(seq), Compact(seq), SkipMsg(seq+1)를 차례로 호출한 뒤 빈 블록에서 SkipMsg(seq+1)를 다시 호출하면 파일 시작 부분의 데이터가 덮어써져 디스크 파일이 손상된 것처럼 보이고 indexCacheBuf corrupt record state 오류가 로그에 남을 수 있었습니다. 이제는 해당 순서로 호출해도 잘못된 오프셋의 블록을 덮어쓰거나 손상 오류를 발생시키지 않습니다.

    - Combining skip sequences and compactions will no longer overwrite the block at the wrong offset, correcting a `corrupt record state` error (#7627)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • Raft 피어 추가로 발생하는 과반수 분리 문제 수정
    영향 대상네트워크 분할 중 피어를 추가하는 Raft 그룹

    네트워크 분할 중 피어를 추가하면 Raft 그룹에서 서로 겹치지 않는 과반수 집합이 생길 수 있었습니다.

    - Add peer operations to Raft can no longer result in disjoint majorities (#7632)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • Filestore 압축에서 오래된 시퀀스와 삭제 맵 항목 수정
    영향 대상압축 중인 Filestore 메시지 블록

    압축 과정에서 mb.last.seq 값이 너무 높게 남고, 마지막 시퀀스가 낮아진 뒤에도 mb.dmap에 삭제된 tail 항목이 남을 수 있었습니다. 이로 인해 인덱스가 일치하지 않아 “no idx present” 오류가 발생하고 리로드가 필요했습니다. 이제 필요에 따라 마지막 시퀀스를 갱신하고 tail의 삭제 항목을 정리합니다.

    - Filestore compaction now correctly adjusts the high and low sequences for a message block, as well as cleaning up the deletion map accordingly (#7634)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • 파일 스토어 syncBlocks 스냅샷 중 스케줄링 수정
    영향 대상syncBlocks를 사용하는 파일 스토어

    스냅샷이 진행되는 동안 syncBlocks가 실행되면 서버를 재시작할 때까지 다시 실행되지 않았습니다.

    - Potential stream desyncs that could happen during stream snapshotting have been fixed (#7655)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • 리테인드 메시지 권한 확인 중 패닉 수정
    영향 대상MQTT 리테인드 메시지 권한 검사(추정)

    계정이나 사용자를 갱신하는 설정을 다시 불러오는 동안, 사용자에게 저장된 리테인드 메시지에 접근하는 데 필요한 권한이 없으면 권한을 확인하는 과정에서 패닉이 발생할 수 있었습니다. 권한이 정의되지 않은 경우도 포함됩니다.

    - Fixed a panic that could occur when reloading config if the user did not have permission to access retained messages (#7596)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • 비 JetStream 서버를 통한 MQTT JetStream API 매핑 수정
    영향 대상비 JetStream 리프 계정에서 JetStream이 활성화된 허브 계정으로 매핑되는 MQTT 계정

    JetStream이 없는 리프 계정에서 JS.API.>를 JetStream이 활성화된 허브의 JS.HUB.API.>로 매핑하면, 이전에는 요청이 매핑되지 않은 채 전송되어 MQTT 클라이언트가 연결할 수 없었습니다. 이제 요청은 매핑이 적용된 상태로 서버를 통과하므로 클라이언트가 연결할 수 있습니다.

    - Fixed account mapping for JetStream API requests when traversing non-JetStream-enabled servers (#7598)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • QoS0 MQTT 토픽에 계정 subject 매핑 적용
    영향 대상계정 import/export와 subject 매핑을 사용하는 QoS0 MQTT 퍼블리셔 및 컨슈머

    이전에는 계정 A에서 foo/x로 발행한 메시지가 매핑된 bar/x가 아니라 foo/x로 계정 B에 전달됐습니다. 이제 컨슈머는 bar/x와 같이 매핑된 subject에 해당하는 토픽을 받습니다.

    - QoS0 messages are now mapped correctly across account imports/exports with subject mappings (#7605)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • MQTT retained 메시지 복원 시 메시지 수 확인
    영향 대상MQTT retained 메시지 복원(추정)

    재시작 후 시퀀스에 간격이 있으면 retained 메시지를 모두 복원했더라도 복원 완료 확인이 시간 초과될 수 있었습니다.

    - Loading retained messages no longer fails after restarting due to last sequence checks (#7616)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • 파일 기반 스트림 캐시의 탄력적 포인터
    영향 대상파일 기반 스트림

    가비지 컬렉션 중이나 메모리 압박이 발생하면 서버가 filestore 캐시를 조기에 제거할 수 있습니다. 그러면 메모리를 운영 체제에 반환해 메모리 부족 상황을 방지하는 데 도움이 됩니다. 에셋 수와 퍼블리시 및 액세스 패턴에 따라 보고되는 RSS가 낮아지거나 높아질 수 있습니다.

    -
    Elastic pointers in the filestore: File-based streams now use elastic pointers for its write-through caches. This allows the server to better respond during garbage collection, these caches can be evicted early to avoid out-of-memory conditions (see upgrade considerations below).
    -
    With the new elastic pointers in the filestore, it is expected that a NATS Server running 2.12 may show a different memory usage pattern to before. In some systems this may result in lower resident set size (RSS) reported, in others it may result in higher, depending on the number of assets and publish/access patterns.
    docs.nats.io/release-notes/whats_new/whats_new_212
  • 메모리 압박 시 filestore 캐시 해제
    영향 대상filestore 캐시를 사용하는 NATS Server 구성

    필요할 때 캐시를 해제하면 갑작스러운 사용량 급증으로 OOM kill이 발생할 가능성이 줄어듭니다. 리소스 여유가 있을 때는 읽기 액세스 시간을 개선하기 위해 캐시를 더 적극적으로 유지할 수 있습니다.

    For the first time, the server will be able to respond to memory pressure by freeing filestore caches on demand and returning the memory to the operating system. This reduces the chance that sudden spikes in utilisation will result in an out-of-memory (OOM) kill. However, this means that the server can more optimistically retain caches in memory when available resources allow in order to facilitate improved read access times.
    docs.nats.io/release-notes/whats_new/whats_new_212

기능·개선13

  • WebSocket ping 간격 설정

    사용 조건 websocket 블록의 0이 아닌 ping_interval 값

    ### Added
    General
    - Added WebSocket-specific ping interval configuration with `ping_internal` in the `websocket` block (#7614)
    github.com/nats-io/nats-server/releases/tag/v2.12.3
  • 스트림의 원자적 배치 퍼블리싱

    사용 조건 스트림 설정 옵션 AllowAtomicPublish

    -
    Atomic batch publish: The AllowAtomicPublish stream configuration option allows to atomically publish N messages into a stream. This includes support for replicated and non-replicated streams, as well as doing per-message consistency checks prior to committing the batch. See Advanced publishing and ADR-50 .
    docs.nats.io/release-notes/whats_new/whats_new_212
  • 스트림 카운터 증감 의미

    사용 조건 AllowMsgCounter 스트림 구성 옵션

    -
    Distributed Counter CRDT: The AllowMsgCounter stream configuration option allows increment/decrement counter semantics on a stream. These counter streams can also be mirrored or aggregated through stream mirroring and sourcing. More information is available in ADR-49 .
    docs.nats.io/release-notes/whats_new/whats_new_212
  • 스트림 메시지 스케줄링

    사용 조건 AllowMsgSchedules 스트림 설정 옵션

    -
    Delayed Message Scheduling: The AllowMsgSchedules stream configuration option allows the scheduling of messages. Users can use this feature for delayed publishing/scheduling of messages. More information is available in ADR-51 .
    docs.nats.io/release-notes/whats_new/whats_new_212
  • 풀 컨슈머용 우선순위 정책
    - Prioritized pull consumer policy: In addition to the consumer policies like overflow or client pinning, a new prioritized policy has been added. In contrast with the overflow policy, this allows a consumer to receive messages sooner instead of delaying failover, but at the cost of potentially flip-flopping work between clients. See Priority groups and ADR-42 .
    docs.nats.io/release-notes/whats_new/whats_new_212
  • server_metadata 맵 추가
    -
    Server metadata: Similar to server_tags which contains a set of tags describing the server, server_metadata is a map containing string keys and values describing metadata of the server.
    docs.nats.io/release-notes/whats_new/whats_new_212
  • 미러링 스트림의 프라이머리 승격
    -
    Promoting mirrors: A stream that's mirroring can now be promoted to be the primary, enabling new disaster recovery methodology. The current primary stream should be deleted or have its configured subjects removed prior to promoting mirrors, before configuring the promoted mirrors to start listening on those subjects. See Disaster recovery .
    docs.nats.io/release-notes/whats_new/whats_new_212
  • 클러스터 라우트 및 게이트웨이 재연결에 지수 백오프 적용

    사용 조건 클러스터 라우트 또는 게이트웨이에 connect_backoff를 true로 설정

    -
    Exponential backoff on route and gateway connections: Cluster routes and gateways can now use exponential backoff on reconnection attempts by setting connect_backoff . If true , will start exponential backoff at 1 second up to 30 seconds. This can slow down the speed of reconnection but significantly reduces the amount of DNS queries and general connection attempts during server restarts or outages.
    docs.nats.io/release-notes/whats_new/whats_new_212
  • 글로벌 계정의 시스템 이벤트
    System events for the $G account: The global account ( $G ) will now also produce system events, such as connect and disconnect events.
    docs.nats.io/release-notes/whats_new/whats_new_212
  • NATS 서버 통계에 GOMAXPROCS 및 GOMEMLIMIT 추가
    GOMAXPROCS and GOMEMLIMIT in server stats: The server stats already contained the CPU and memory usage of the server but now also contains the effective Go limits.
    docs.nats.io/release-notes/whats_new/whats_new_212
  • subject 전체를 사용하는 partition(n) 및 random(n) 변환 함수
    New subject transforms: partition(n) and random(n) : In addition to partition(n, …) which allows to determine a partition number based on tokens at specified indices, partition(n) and random(n) are convenience functions to create a partition or random number up to n based on the whole subject.
    docs.nats.io/release-notes/whats_new/whats_new_212
  • isolate_leafnode_interest를 사용한 리프 노드 interest 격리
    Isolated leaf node property: In a large deployment with lots of leaf nodes, propagating east-west interest can result in a lot of traffic, which is wasted if leaf nodes don't need to be able to publish/subscribe to each other directly. Instead of the workaround of setting the cluster name of those leaf nodes to be the same, the isolate_leafnode_interest property can now be used.
    docs.nats.io/release-notes/whats_new/whats_new_212
  • 설정 다시 불러오기를 통한 원격 리프 노드 비활성화

    사용 조건 설정 다시 불러오기를 통해 disabled: true로 설정

    Disable leaf node connection through config reload: This allows disabling a remote leaf node using configuration reload, when using disabled: true . If changed from false to true, a solicited leaf node will be disconnected and will not reconnect. If changed from true to false, the leafnode will be solicited again.
    docs.nats.io/release-notes/whats_new/whats_new_212

의존성 갱신8

    그 외 8건 · 보안 언급 없음
    • - 1.25.5 (#7604)
    • - github.com/google/go-tpm v0.9.7 (#7578)
    • - github.com/nats-io/nkeys v0.4.12 (#7578)
    • - golang.org/x/crypto v0.45.0 (#7578)
    • - github.com/klauspost/compress v1.18.2 (#7604)
    • - github.com/antithesishq/antithesis-sdk-go v0.5.0-default-no-op (#7604)
    • - golang.org/x/crypto v0.46.0 (#7648)
    • - golang.org/x/sys v0.39.0 (#7648)
    기타11
    • subject 필터 소스의 시퀀스 스캔 속도 향상
      - The scan for the last sourced message sequence when setting up a subject-filtered source is now considerably faster (#7553)
      github.com/nats-io/nats-server/releases/tag/v2.12.3
    • JetStream 메타레이어의 복구 작업 단계화 및 중복 제거
      - The metalayer will now stage and deduplicate recovery operations at startup, instead of rapidly applying and then undoing conflicting assignments (#7540)
      github.com/nats-io/nats-server/releases/tag/v2.12.3
    • JetStream 컨슈머 interest 검사 속도 개선
      - Consumer interest checks on interest-based streams are now significantly faster when there are large gaps in interest (#7656)
      github.com/nats-io/nats-server/releases/tag/v2.12.3
    • 클러스터 모드 스트림 생성 데이터 레이스 수정
      - A data race when creating a stream in clustered mode has been fixed (#7586)
      github.com/nats-io/nats-server/releases/tag/v2.12.3
    • Filestore 보안 삭제 시 올바른 subject 추적 유지
      - The filestore now will process message removal on disk before updating accounting, which improves error handling (#7595, #7601)
      github.com/nats-io/nats-server/releases/tag/v2.12.3
    • 스트림 상태 점검의 복제본 읽기에 읽기 잠금 적용
      - A data race has been fixed in the stream health check (#7619)
      github.com/nats-io/nats-server/releases/tag/v2.12.3
    • errNoCache 이후 파일스토어 캐시 만료
      - Filestore message lookups will now expire the cache if a cache error is encountered (#7630)
      github.com/nats-io/nats-server/releases/tag/v2.12.3
    • 시퀀스 불일치 시 Filestore 인덱스 재구축 및 로딩 재시도
      - Filestore compaction should no longer result in `no idx present` cache errors (#7634)
      github.com/nats-io/nats-server/releases/tag/v2.12.3
    • v2.12 기능을 사용하는 스트림 및 컨슈머의 다운그레이드 비지원 표시
      -
      Offline assets: When downgrading to an older version, the server can now recognize new features were used and puts the stream and/or consumer into an unsupported/offline mode. For more information, read also the downgrade considerations. More information is available in ADR-44 .
      docs.nats.io/release-notes/whats_new/whats_new_212
    • 복제 스트림, 디스크에 비동기식으로 데이터 플러시
      -
      Async stream flushing: Replicated streams will now asynchronously flush data to the underlying store on disk, resulting in a significant improvement in performance. Writes to a replicated stream are still persisted synchronously in the Raft log prior to committing them, so the improved performance has no downsides with respect to consistency.
      docs.nats.io/release-notes/whats_new/whats_new_212
    • JetStream 엄격 모드 기본 활성화
      Strict JetStream API ​
      Starting from version v2.11, the server would start logging the following statement if an invalid JetStream request was received:
      [WRN] Invalid JetStream request '$G > $JS.API.STREAM.CREATE.test-stream': json: unknown field "unknown"
      Starting from version v2.12, the server will not only log, but also return an error to the client as "strict mode" is now enabled by default. This means invalid JetStream requests will be rejected by default.
      If the above log message is observed, please make sure that the application or client is sending correct requests to the server and that NATS client libraries are up-to-date. Strict mode can be temporarily disabled in the server configuration, allowing you more time to fix the issue:
      jetstream {
      strict: false
      }
      docs.nats.io/release-notes/whats_new/whats_new_212

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