RATATOSK
← リリース一覧

etcdv3.7.4

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

etcdの通知を受け取る

週次メールは確認すべき変更がある週だけ、深刻度がcriticalのセキュリティアドバイザリは即時に届きます。

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

アップグレードガイド1
etcd v3.7.4 へのアップグレードガイド
リンク先ドキュメントからの項目16件
  • ダウンタイムなしでの 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 サーバーを停止するアップグレード手順サーバーが一時的に切断されている間、他のメンバーでエラーが報告される場合があります。リーダーの場合は、終了前にリーダーシップを移譲します。
  • メンバーとクラスターのエンドポイント状態確認に関するアップグレードガイド
元のリリースノート
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).
github.com/etcd-io/etcd/releases/tag/v3.7.4

破壊的変更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
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)
    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)
    github.com/etcd-io/etcd/blob/main/CHANGELOG/CHANGELOG-3.7.md
その他の変更6
  • alarmStore へのアクセスにおける競合状態の修正
    - [Define `alarmStore` as an `atomic.Pointer` to avoid race condition](https://github.com/etcd-io/etcd/pull/22705)
    github.com/etcd-io/etcd/blob/main/CHANGELOG/CHANGELOG-3.7.md
  • etcd v2 ストアと関連機能の削除
    The v2 store has been fully removed in v3.7. The v2 HTTP API ( --enable-v2 ), the v2-on-v3 emulation ( --experimental-enable-v2v3 ), the v2 discovery service, the client/v2 package, and the loading of v2 snapshot files are all gone. See the breaking-change references in CHANGELOG-3.7 .
    etcd.io/docs/v3.7/upgrades/upgrade_3_7/
  • etcd の protobuf コードの google.golang.org/protobuf への移行
    - Migration from gogo/protobuf to standard google.golang.org/protobuf (tracked in #14533 ).
    etcd.io/docs/v3.7/upgrades/upgrade_3_7/
  • gRPC プロキシのロギングとタグ付けを go-grpc-middleware v2 に切り替え
    - Migration of the deprecated go-grpc-middleware v1 logging and tags libraries to the v2 interceptors ( #20420 ).
    etcd.io/docs/v3.7/upgrades/upgrade_3_7/
  • etcd の gRPC トレーシングを NewServerHandler に移行
    - The OpenTelemetry gRPC interceptors were updated to otelgrpc v0.61.0, replacing the deprecated UnaryServerInterceptor and StreamServerInterceptor with NewServerHandler ( #20017 ).
    etcd.io/docs/v3.7/upgrades/upgrade_3_7/
  • 異なるバージョンが混在する etcd クラスターのアップグレード対応
    While upgrading, an etcd cluster supports mixed versions of etcd members, and operates with the protocol of the lowest common version. The cluster is only considered upgraded once all of its members are upgraded to version v3.7. Internally, etcd members negotiate with each other to determine the overall cluster version, which controls the reported version and the supported features.
    etcd.io/docs/v3.7/upgrades/upgrade_3_7/

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