RATATOSK
← 전체 릴리스

NATSv2.11.11

중요 수정 28기능·개선 7의존성 갱신 6기타 16

NATS 알림 받기

확인할 변경이 있을 때만 주 1회, 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 스트림 catch-up 헬스 보고 수정드러나지 않던 결함
    영향 대상catch-up 중인 JetStream 스트림

    스트림이 catch-up 중일 때는 catch-up이 끝날 때까지 Raft 상태가 진전되지 않아 헬스 체크에서 group node unhealthy를 보고했습니다. 이제 헬스 체크가 먼저 catch-up 여부를 확인하고 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 손실 수정
    영향 대상secure erase를 사용하는 JetStream filestore 구성

    블록에서 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를 받으면 건너뛰면 안 되는 메시지를 건너뛴 것으로 표시하고 삭제해 스트림 동기화가 어긋날 수 있었습니다. 이제 스킵 시퀀스를 적용하기 전에 순서를 확인하므로 catch-up 중 동기화가 어긋나는 문제를 방지합니다.

    - 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
  • filestore의 소거된 메시지 간격 추적 수정
    영향 대상filestore를 사용하는 JetStream 스트림(추정)

    filestore 메시지 시퀀스 간격의 끝이 소거된 마지막 메시지인 경우, filestore가 소거된 슬롯을 삭제로 등록하지 않았습니다. 이로 인해 캐시 무효화가 계속 발생하고, 읽기나 catchup이 느려지며, 삭제 추적이 잘못되었습니다. 이제 상태를 재구성할 때 누락된 시퀀스 번호를 삭제로 등록합니다.

    - 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가 있는 블록이 처음부터 비어 있거나 완전히 비어 있으면, 재구축 과정에서 시퀀스 번호만 증가시키는 skip으로 생긴 시퀀스 간격을 삭제된 메시지로 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 피어 활동 보고 수정
    영향 대상Raft 그룹과 API, 자산 정보 및 모니터링 엔드포인트의 피어 활동 보고

    리더가 바뀌거나 클러스터 크기가 조정된 뒤에도 이전 활성 타임스탬프가 그대로 남아 ‘마지막 확인’과 ‘활성’ 값이 실제와 다르게 표시될 수 있었습니다. 이번 릴리스에서는 피어 활동을 더 일관되게 추적하고 리더 변경 시 오래된 타임스탬프를 지우므로, 보고되는 값이 이전 릴리스와 다를 수 있습니다.

    - 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 헤더의 값이 공백으로 시작하지 않을 때 k에 setHeader를 호출하면, 기존 헤더를 업데이트하는 대신 헤더를 하나 더 추가했습니다.

    - 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
  • 파일스토어 끝부분 빈 구간 채우기 시퀀스 오류 수정
    영향 대상JetStream 파일스토어

    블록 끝의 빈 구간을 채울 때 오프바이원 오류로 시퀀스 하나가 삭제된 것으로 표시되고 마지막 시퀀스가 누락될 수 있었습니다.

    - 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의 블록 끝 hole 감지 수정
    영향 대상JetStream filestore(추정)

    블록 끝의 hole을 감지할 때 tombstone이 마지막 시퀀스로 처리되어 삭제를 놓칠 수 있었습니다. 이제 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 메타데이터 패닉 수정
    영향 대상consumer-info 처리 핸들러를 포함한 JetStream API 핸들러

    일부 핸들러가 cc.meta에 락을 걸지 않고 접근해 경쟁 상태가 발생했고, 값이 nil이면 패닉이 발생할 수 있었습니다. 영향을 받는 핸들러는 이제 락 없이 접근하지 않으며, 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
  • Filestore의 TTL 및 스케줄링 상태 파일 기록에 sync_always 설정 적용
    영향 대상TTL 또는 스케줄링 상태 파일에 sync_always를 사용하는 JetStream filestore
    - 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()가 실행되면 access time service not running 패닉이 발생할 수 있었습니다. 이제 이 경우 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 catchup이 중간에 실패하면, 동기화가 완료되지 않은 피어가 리더가 되려고 시도해 스트림의 동기화가 어긋날 수 있었습니다. 이제 스냅샷을 설치해 복구 과정에서 처리할 수 있으며, 새 피어는 완전히 동기화될 때까지 리더가 될 수 없습니다.

    - 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 메타레이어 스냅샷 복구

    복구 중 meta 스냅샷에 있던 컨슈머가 삭제되면, 해당 컨슈머가 상태 확인에 다시 나타나 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() 대신 종료 시그널을 소비할 수 있었습니다. 이제 모든 수신 대기자에게 알리도록 채널을 닫고, 모니터가 종료될 때까지 별도의 두 번째 채널을 기다립니다.

    - 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
  • 스트림 purge 오류 경로 데드락 수정
    영향 대상스트림 purge(추정)

    컨슈머 상태가 일치하지 않고 purge 중 컨슈머 스토어 상태를 기록할 때 오류가 발생하면, 오류 처리 과정에서 이미 보유한 스트림 락을 다시 획득하려다 데드락이 발생할 수 있었습니다. 이제 해당 락을 다시 획득하지 않고 스트림 이름을 가져옵니다.

    - 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 metalayer 로그 컴팩션 임계값 추가

    사용 조건 임계값 기반 컴팩션을 사용하려면 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 메타 클러스터 스냅샷 통계 노출
    - Meta cluster snapshot statistics have been added to the `/jsz` endpoint (#7524)
    github.com/nats-io/nats-server/releases/tag/v2.11.11
  • /jsz의 다이렉트 컨슈머 세부 정보

    사용 조건 /jsz 요청에 direct-consumers=true 쿼리 매개변수 지정

    - 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 catchup 로그에 경과 시간 추가
    - 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 재게시에서 두 필드 모두 \u003e 허용

    사용 조건 스트림의 단일 subject를 매핑하며 RePublish.Source와 RePublish.Destination 모두에 \u003e를 지정하는 SubjectTransform

    - 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가 작성하므로 틀릴 수 있으며, 보증 없이 제공합니다.