# etcd v3.7.4

2026-11-19 · [元のリリースノート](https://github.com/etcd-io/etcd/releases/tag/v3.7.4) · [全体のまとめ](https://ratatosk.io/ja/releases/etcd/v3.7.4)

破壊的変更 1 · 重大な修正 2 · その他の変更 6

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

### アップグレードガイド

- **etcd v3.7.4 へのアップグレードガイド**
  > Please check out [CHANGELOG](https://github.com/etcd-io/etcd/blob/main/CHANGELOG/CHANGELOG-3.7.md) for a full list of changes. And make sure to read [upgrade guide](https://etcd.io/docs/v3.7/upgrades/upgrade_3_7/) before upgrading etcd (there may be breaking changes).

  - ダウンタイムなしでの etcd v3.6 から v3.7 へのアップグレードガイダンス
  - アップグレード準備ガイド
  - 3.7へのアップグレードに必要な3.6メンバーの更新: アップグレード前に、すべてのクラスターメンバーを3.6.11以降にする必要があります。それより前の3.6パッチリリースでは、ローリングアップグレードで3.7に移行できない場合があります。
  - 旧リリース向け v2 データ移行ガイド
  - etcd の組み込み利用者、`clientv3` 利用者、内部パッケージ依存者向けのアップグレードを網羅する CHANGELOG
  - v3.5 から v3.6 への削除されたフラグの置き換えガイド
  - v3.7へのアップグレードに必要なetcd v3.6.11以降: v3.6より前のバージョンを使用しているクラスターは、まずv3.6にアップグレードする必要があります。etcdでは、一度にアップグレードできるのはマイナーバージョン1つ分までです。
  - ローリングアップグレードの前提となるクラスターの健全性: ローリングアップグレードを円滑に進めるには、クラスターが健全である必要があります。健全性の確認には `etcdctl endpoint health` を使用します。
  - etcd 依存サービスのステージング環境での検証: この注記では、アップグレードを本番環境に展開する前に、これらのテストをステージング環境で実施するよう示しています。
  - etcd のアップグレード時のロールバックに備えたスナップショットバックアップ: アップグレード前に取得したスナップショットバックアップは、アップグレードに問題が発生した場合に、アップグレード前の etcd バージョンへロールバックするために使用できます。
  - アップグレードガイドにおけるクラスターのスナップショットとロールバック
  - 全メンバーが v3.7 に到達した後のバイナリロールバック不可: 復旧方法は、アップグレード前のスナップショットを復元するか、公式のダウングレードガイドに従うことです。
  - クラスターの健全性とバージョンの確認: この手順では、`etcdctl ... endpoint health` と `curl .../version` を使って、クラスターが正常であり、v3.6.11以降を実行していることを確認します。出力例では、3つすべてのエンドポイントが正常で、etcdserver は 3.6.12、etcdcluster は 3.6.0、storage は 3.6.0 と表示されています。
  - ダウングレード用のリーダースナップショットバックアップ
  - 既存の etcd サーバーを停止するアップグレード手順: サーバーが一時的に切断されている間、他のメンバーでエラーが報告される場合があります。リーダーの場合は、終了前にリーダーシップを移譲します。
  - メンバーとクラスターのエンドポイント状態確認に関するアップグレードガイド

## 破壊的変更 (1)

### 非推奨の etcd `--experimental-*` 起動フラグの削除

- 影響対象: 起動設定で列挙された `--experimental-*` フラグのいずれかを設定している etcd デプロイメント
- 必要な対応: v3.7 へのローリング前に、列挙された `--experimental-*` フラグを v3.6 での対応先に置き換えること

v3.6 では、非推奨の各フラグが、同じ名前の非実験的なフラグまたは `--feature-gates` の項目に置き換えられました。v3.7 では、削除されたフラグが設定に残っていると etcd の起動に失敗します。

> All deprecated --experimental-* flags have been removed in v3.7 ( #19959 ). In v3.6 each of these was replaced either by a non-experimental flag of the same name or by a --feature-gates entry. If you still have any of these set, replace them with the v3.6 equivalent before rolling to v3.7, otherwise the v3.7 process will fail to start.
> -etcd --experimental-bootstrap-defrag-threshold-megabytes
> -etcd --experimental-compact-hash-check-enabled
> -etcd --experimental-compact-hash-check-time
> -etcd --experimental-compaction-batch-limit
> -etcd --experimental-compaction-sleep-interval
> -etcd --experimental-corrupt-check-time
> -etcd --experimental-distributed-tracing-address
> -etcd --experimental-distributed-tracing-instance-id
> -etcd --experimental-distributed-tracing-sampling-rate
> -etcd --experimental-distributed-tracing-service-name
> -etcd --experimental-downgrade-check-time
> -etcd --experimental-enable-distributed-tracing
> -etcd --experimental-enable-lease-checkpoint
> -etcd --experimental-enable-lease-checkpoint-persist
> -etcd --experimental-initial-corrupt-check
> -etcd --experimental-memory-mlock
> -etcd --experimental-peer-skip-client-san-verification
> -etcd --experimental-snapshot-catchup-entries
> -etcd --experimental-stop-grpc-service-on-defrag
> -etcd --experimental-txn-mode-write-with-shared-buffer
> -etcd --experimental-warning-apply-duration
> -etcd --experimental-warning-unary-request-duration
> -etcd --experimental-watch-progress-notify-interval
> Flags removed

https://etcd.io/docs/v3.7/upgrades/upgrade_3_7/

## 重大な修正 (2)

### `--force-new-cluster` のブートストラップで WAL を超えるコミットインデックスを拒否

- 影響対象: `--force-new-cluster` を使用するメンバー

バックエンドの整合性インデックスが最後の WAL エントリーを上回っている場合、ブートストラップでパニックが発生し、メンバーが恒久的に起動不能になる可能性がありました。最後の WAL エントリーを超えるようコミットインデックスを調整して処理を続行する代わりに、エラーを返すようになりました。

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

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

### 旧 v2 WAL の再生時に発生するパニックの修正

- 影響対象: WALに旧 v2 のメンバー属性またはクラスターバージョンのメタデータエントリーを含むetcdメンバー

起動時の再生で、旧 v2 のメンバー属性エントリーが原因でパニックが発生することがありました。再生時に旧 v2 のメンバー属性およびクラスターバージョンのメタデータエントリーを破棄し、リクエストの処理を開始する前にメンバー属性を再公開します。また、新しいメンバーはクラスターバージョンを維持します。

> - Fix [etcd panics on startup replaying legacy v2 member-attribute WAL entries](https://github.com/etcd-io/etcd/pull/22804)

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

## その他の変更 (6)

- `alarmStore` へのアクセスにおける競合状態の修正
- etcd v2 ストアと関連機能の削除
- etcd の protobuf コードの `google.golang.org/protobuf` への移行
- gRPC プロキシのロギングとタグ付けを `go-grpc-middleware` v2 に切り替え
- etcd の gRPC トレーシングを `NewServerHandler` に移行
- 異なるバージョンが混在する etcd クラスターのアップグレード対応

---

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