RATATOSKRATATOSK
로그인

NATS

v2.14.0Networking & Messaging
2026년 4월 30일

NATS v2.14.0은 2.13.x를 건너뛰고 출시됐습니다. JetStream 스케줄링, 고속 배치 퍼블리싱, 컨슈머 리셋 API, Raft 데이터 손실 방지 수정이 핵심입니다. 업그레이드 전 마이그레이션 가이드 확인이 필수입니다.

  • breaking2.13.x 건너뜀 — 반드시 2.14 업그레이드 가이드를 먼저 읽으세요

    이번 릴리스는 2.12.x에서 바로 2.14.x로 올라갑니다. ACL로 JetStream ACK·플로우 컨트롤 주제를 제어하고 있다면 지금 당장 주목해야 합니다. 새 도메인 인식 형식($JS.ACK.domain.acchash.stream.consumer.>)은 현재 기본 비활성이지만 v2.15에서 기본 활성화됩니다. v2.15 업그레이드 전에 ACL 규칙을 미리 업데이트해 두세요.

  • breakingRaft 스냅샷 손상 시 기동 거부 — 복구 절차를 미리 검증하세요

    기존에는 스냅샷이 손상되거나 로그와 정렬이 맞지 않아도 노드가 조용히 기동됐습니다. 이제는 기동 자체를 거부합니다. 올바른 방향이지만, 비정상 종료를 경험한 클러스터가 있다면 업그레이드 전에 스냅샷 무결성을 먼저 점검하세요. 운영 런북에도 이 시나리오의 복구 절차를 추가해 두는 게 좋습니다.

  • enhancementConsumer Reset API로 컨슈머 재설정 작업이 훨씬 간단해졌습니다

    기존에는 컨슈머를 이전 시퀀스로 되돌리려면 삭제 후 재생성하는 번거로운 과정이 필요했습니다. 새 $JS.API.CONSUMER.RESET API를 쓰면 그 자리에서 바로 되감기가 됩니다. 컨슈머 재처리나 장애 복구 시나리오를 다루는 내부 도구나 런북이 있다면 이 API를 쓰도록 업데이트하세요.

주요 변경 (5)

  • JetStream 고속 배치 퍼블리싱 지원 (ADR-50)
  • Nats-Schedule 헤더로 반복/크론 기반 메시지 스케줄링 추가 (ADR-51)
  • 컨슈머 삭제 없이 이전 시퀀스로 되돌리는 Consumer Reset API 도입
  • 도메인 인식 ACK/FC 주제 형식 추가 (js_ack_fc_v2 플래그, v2.15에서 기본값으로 전환 예정)
  • 스냅샷이 손상되거나 없을 경우 Raft 노드 기동 거부로 데이터 손실 방지