# etcdを3.5から3.4にダウングレード > etcdを3.5から3.4にダウングレードする手順、チェックリスト、注意事項 --- LLMSインデックス: [llms.txt](/ja/llms.txt) --- 通常、etcd 3.5から3.4へのダウングレードは、停止時間なしのローリングダウングレードで実行できます。 - etcd 3.5のプロセスを1つずつ停止し、etcd 3.4のプロセスに置き換えます。 - 3.4のプロセスを1つでも起動すると、クラスターで3.5の新機能を利用できなくなります。 [ダウングレードを開始する](#downgrade-procedure)前に、このガイドの残りを読んで準備してください。 ### ダウングレードのチェックリスト {#downgrade-checklists} > [!WARNING] > クラスターで認証を有効にしている場合、3.5では[認証に関するWALエントリーの形式が変更される](https://github.com/etcd-io/etcd/pull/11943)ため、3.5からのローリングダウングレードはサポートされません。[認証の手順](/ja/docs/etcd/op-guide/authentication/rbac/)に従い、先に認証を無効にしてすべてのユーザーを削除できます。 3.5から3.4への移行に伴う主な互換性を損なう変更は次のとおりです。 #### フラグの違い {#difference-in-flags} 3.5の設定で次のフラグを使用している場合は、3.4にダウングレードするときに必ず削除、改名、またはデフォルト値の変更を行ってください。 > [!NOTE] > この差分は、バージョン3.5.14とv.3.4.33に基づいています。実際の差分は使用するパッチバージョンによって異なるため、先に`diff <(etcd-3.5/bin/etcd -h | grep \\-\\-) <(etcd-3.4/bin/etcd -h | grep \\-\\-)`で確認してください。 ```diff # flags not available in 3.4 -etcd --socket-reuse-port -etcd --socket-reuse-address -etcd --raft-read-timeout -etcd --raft-write-timeout -etcd --v2-deprecation -etcd --client-cert-file -etcd --client-key-file -etcd --peer-client-cert-file -etcd --peer-client-key-file -etcd --self-signed-cert-validity -etcd --enable-log-rotation --log-rotation-config-json=some.json -etcd --experimental-enable-distributed-tracing --experimental-distributed-tracing-address='localhost:4317' --experimental-distributed-tracing-service-name='etcd' --experimental-distributed-tracing-instance-id='' --experimental-distributed-tracing-sampling-rate='0' -etcd --experimental-compact-hash-check-enabled --experimental-compact-hash-check-time='1m' -etcd --experimental-downgrade-check-time -etcd --experimental-memory-mlock -etcd --experimental-txn-mode-write-with-shared-buffer -etcd --experimental-bootstrap-defrag-threshold-megabytes -etcd --experimental-stop-grpc-service-on-defrag # same flag with different names -etcd --backend-bbolt-freelist-type=map +etcd --experimental-backend-bbolt-freelist-type=array # same flag different defaults -etcd --pre-vote=true +etcd --pre-vote=false -etcd --logger=zap +etcd --logger=capnslog ``` #### `etcd --logger zap` {#etcd---logger-zap} 3.4のデフォルトは`--logger=capnslog`、3.5のデフォルトは`--logger=zap`です。 `zap`を引き続き使用するには、明示的に指定する必要があります。 ```diff +etcd --logger=zap --log-outputs=stderr +# to write logs to stderr and a.log file at the same time +etcd --logger=zap --log-outputs=stderr,a.log ``` #### Prometheusメトリクスの違い {#difference-in-prometheus-metrics} ```diff # metrics not available in 3.4 -etcd_debugging_mvcc_db_compaction_last ``` ### サーバーダウングレードのチェックリスト {#server-downgrade-checklists} #### ダウングレードの要件 {#downgrade-requirements} ローリングダウングレードを円滑に進めるには、稼働中のクラスターが正常でなければなりません。作業を進める前に、`etcdctl endpoint health`コマンドでクラスターの正常性を確認してください。 ダウングレード先の3.4バージョンは、>= 3.4.32でなければなりません。 #### 準備 {#preparation} etcdをダウングレードする際は、必ず本番環境に適用する前に、etcdに依存するサービスをステージング環境でテストしてください。 作業を始める前に、[スナップショットバックアップをダウンロード](/ja/docs/etcd/op-guide/maintenance/#snapshot-backup)してください。ダウングレードで問題が発生した場合は、このバックアップを使用して元のetcdバージョンに[ロールバック](#rollback)できます。`snapshot`コマンドでバックアップされるのはv3データのみであることに注意してください。v2データについては、[v2データストアのバックアップ](https://etcd.io/docs/v2.3/admin_guide#backing-up-the-datastore)を参照してください。 作業を始める前にetcd 3.4の最新リリースをダウンロードし、バージョンが>= 3.4.32であることを確認してください。 #### バージョンの混在 {#mixed-versions} ダウングレード中のetcdクラスターでは、異なるバージョンのetcdメンバーの混在がサポートされ、全メンバーに共通する最も低いバージョンのプロトコルで動作します。メンバーが1つでもバージョン3.4にダウングレードされると、クラスターはダウングレードされたと見なされます。内部では、etcdメンバーが相互にネゴシエーションを行ってクラスター全体のバージョンを決定し、そのバージョンによって報告されるバージョンとサポートされる機能が決まります。 #### 制限事項 {#limitations} 注：クラスターにv3データしかなく、v2データがない場合、この制限は適用されません。 クラスターが50MBを超えるv2データセットを提供している場合、新しくダウングレードした各メンバーが既存のクラスターに追いつくまでに最大2分かかることがあります。直近のスナップショットのサイズを調べて、データの総量を見積もってください。つまり、各メンバーのダウングレードの間に2分待つのが最も安全です。 データの総量が100MB以上とさらに大きい場合、この1回限りの処理にはより長い時間がかかることがあります。この規模の非常に大きなetcdクラスターを管理している場合は、ダウングレード前に[etcdチーム][etcd-contact]までお気軽にお問い合わせください。手順についてアドバイスします。 #### ロールバック {#rollback} メンバーが1つでも3.4にダウングレードされると、クラスターのバージョンは3.4に下がり、動作は「3.4」と互換になります。ロールバックするには、[etcdを3.4から3.5にアップグレード](/ja/docs/etcd/upgrades/upgrade_3_5/)の手順に従う必要があります。 クラスターのダウングレードが完全に完了した後でも、そのダウングレードをロールバックできるように、[スナップショットバックアップをダウンロード](/ja/docs/etcd/op-guide/maintenance/#snapshot-backup)してください。 ### ダウングレード手順 {#downgrade-procedure} この例では、ローカルマシンで稼働する3メンバー構成の3.5 etcdクラスターをダウングレードする方法を説明します。 #### 手順1：ダウングレード要件の確認 {#step-1-check-downgrade-requirements} クラスターは正常で、3.5.xで稼働していますか。 ```bash etcdctl --endpoints=localhost:2379,localhost:22379,localhost:32379 endpoint health < `{"level":"info","ts":"2024-05-13T21:05:43.981445Z","caller":"membership/cluster.go:561","msg":"set initial cluster version","cluster-id":"ef37ad9dc622a7c4","local-member-id":"8211f1d0f64f3269","cluster-version":"3.0"}` > `{"level":"info","ts":"2024-05-13T21:05:43.982188Z","caller":"api/capability.go:77","msg":"enabled capabilities for version","cluster-version":"3.0"}` > `{"level":"info","ts":"2024-05-13T21:05:43.982312Z","caller":"membership/cluster.go:549","msg":"updated cluster version","cluster-id":"ef37ad9dc622a7c4","local-member-id":"8211f1d0f64f3269","from":"3.0","from":"3.5"}` > `{"level":"info","ts":"2024-05-13T21:05:43.982376Z","caller":"api/capability.go:77","msg":"enabled capabilities for version","cluster-version":"3.5"}` > `{"level":"info","ts":"2024-05-13T21:05:44.000672Z","caller":"etcdserver/server.go:2152","msg":"published local member to cluster through raft","local-member-id":"8211f1d0f64f3269","local-member-attributes":"{Name:infra1 ClientURLs:[http://127.0.0.1:2379]}","request-path":"/0/members/8211f1d0f64f3269/attributes","cluster-id":"ef37ad9dc622a7c4","publish-timeout":"7s"}` > `{"level":"info","ts":"2024-05-13T21:05:46.452631Z","caller":"membership/cluster.go:549","msg":"updated cluster version","cluster-id":"ef37ad9dc622a7c4","local-member-id":"8211f1d0f64f3269","from":"3.5","from":"3.4"}` ``` 新しい3.4のetcdバイナリで、各メンバー、続いてクラスター全体が正常になることを確認してください。 ```bash etcdctl endpoint health --endpoints=localhost:2379,localhost:22379,localhost:32379 <