# etcd v3.5.36

2026-11-18 · [릴리스 노트 원문](https://github.com/etcd-io/etcd/releases/tag/v3.5.36) · [전체 정리](https://ratatosk.io/ko/releases/etcd/v3.5.36)

호환성 변경 1 · 중요 수정 1 · 의존성 갱신 1 · 기타 1

## 업그레이드 전 확인

### 업그레이드 안내

- **v3.5.36 변경 사항 및 업그레이드 안내**
  > Please check out [CHANGELOG](https://github.com/etcd-io/etcd/blob/main/CHANGELOG/CHANGELOG-3.5.md) for a full list of changes. And make sure to read [upgrade guide](https://etcd.io/docs/v3.5/upgrades/upgrade_3_5/) before upgrading etcd (there may be breaking changes).

## 호환성 변경 (1)

### 강제 클러스터 재시작 시 범위를 벗어난 커밋 인덱스 거부

- 영향 대상: `--force-new-cluster`로 재시작하는 멤버

이전에는 백엔드의 일관성 인덱스가 마지막 WAL 엔트리나 스냅샷 인덱스보다 크면 멤버가 영구적으로 작동 불능 상태가 될 수 있었습니다. 이제는 사용 가능한 엔트리 범위를 넘어선 커밋 인덱스로 조정해 시작하는 대신, 시작 과정에서 오류를 반환합니다. 재시작에 실패해도 WAL은 변경되지 않습니다.

근거: “return 0, nil, nil, nil, nil, fmt.Errorf("adjusted commit index %d exceeds the last WAL entry index %d", adjustedCommitIndex, lastIdx)” https://github.com/etcd-io/etcd/pull/22688

> - Fix [`--force-new-cluster` permanently bricking a member whose backend consistent index is ahead of its WAL](https://github.com/etcd-io/etcd/pull/22688)

https://github.com/etcd-io/etcd/blob/main/CHANGELOG/CHANGELOG-3.5.md

## 중요 수정 (1)

### Raft의 오래된 ReadIndex 응답 수정

- 영향 대상: 리더가 스스로 제거되는 Raft 구성

이전에는 자신을 제거한 리더가 오래된 인덱스로 `ReadIndex`에 응답해, 남은 투표자가 이후에 커밋한 항목을 놓칠 수 있었습니다. 이제 읽기 결과에 해당 항목이 포함되므로 오래된 응답을 즉시 반환하지 않습니다.

> - Fix [A leader that removed itself answers ReadIndex with a stale index](https://github.com/etcd-io/etcd/pull/22652)

https://github.com/etcd-io/etcd/blob/main/CHANGELOG/CHANGELOG-3.5.md

## 의존성 갱신 (1)

그 외 1건 · 보안 언급 없음

- `- Compile binaries using [go 1.26.11](https://github.com/etcd-io/etcd/pull/22820).`

## 기타 (1)

- etcd 서버 알람 스토어에 대한 원자적 접근

---

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