# Mettre à jour etcd de la version v3.5 à la version v3.6 > Processus, listes de vérification et notes sur la mise à niveau d'etcd de la version 3.5 à la version 3.6 --- Index LLMS : [llms.txt](/fr/llms.txt) --- Dans le cas général, la mise à niveau de etcd v3.5 vers v3.6 peut être une mise à niveau progressive sans interruption de service : - un à un, arrêtez les processus etcd v3.5 et remplacez-les par des processus etcd v3.6 - après avoir lancé tous les processus v3.6, les nouvelles fonctionnalités de la version v3.6 sont disponibles pour le cluster Avant de [lancer la mise à jour](#upgrade-procedure), lisez le reste du présent guide afin de vous préparer. ### Listes de vérification pour la mise à jour {#upgrade-checklists} #### Mise à jour 3.5 {#update-35} > [!IMPORTANT] > Avant de mettre à jour vers la version 3.6, assurez-vous que [tous vos membres 3.5 sont mis à jour vers la version 3.5.32 ou ultérieure](https://etcd.io/blog/2026/july-patch-release/). Les correctifs 3.5.24 à 3.5.26 corrigent plusieurs blocages potentiels liés à la mise à jour ; [3.5.32](https://etcd.io/blog/2026/july-patch-release/) ajoute `--v2-deprecation=write-only-skip-check` et étend `etcdutl check v2store` afin d'inspecter les enregistrements WAL ainsi que l'instantané v2. #### Magasin V2 {#v2-store} > [!NOTE] > Si le drapeau `--enable-v2` n'est pas configuré ou est défini à false, aucune action supplémentaire n'est requise. Si `--enable-v2` est configuré, exécutez la commande `etcdutl check v2store` pour vérifier si le v2store contient des données non liées aux membres (données personnalisées). Si aucune donnée personnalisée n'est présente, le drapeau peut être supprimé en toute sécurité. Sinon, consultez le guide de migration [v2](https://etcd.io/docs/v3.4/op-guide/v2-migration/) pour plus de détails. ### Drapeaux ajoutés {#flags-added} ```diff +etcd --discovery-token '' +etcd --discovery-endpoints '' +etcd --discovery-dial-timeout '2s' +etcd --discovery-request-timeout '5s' +etcd --discovery-keepalive-time '2s' +etcd --discovery-keepalive-timeout '6s' +etcd --discovery-insecure-transport 'true' +etcd --discovery-insecure-skip-tls-verify 'false' +etcd --discovery-cert '' +etcd --discovery-key '' +etcd --discovery-cacert '' +etcd --discovery-user '' +etcd --discovery-password '' +etcd --feature-gates +etcd --log-format ``` ### Drapeaux supprimés {#flags-removed} ```diff -etcd --enable-v2 -etcd --experimental-enable-v2v3 -etcd --proxy -etcd --proxy-failure-wait -etcd --proxy-refresh-interval -etcd --proxy-dial-timeout -etcd --proxy-write-timeout -etcd --proxy-read-timeout ``` ### Drapeaux obsolètes {#flags-deprecated} **Le drapeau `etcd --experimental-bootstrap-defrag-threshold-megabytes` a été déprécié.** ```diff -etcd --experimental-bootstrap-defrag-threshold-megabytes +etcd --bootstrap-defrag-threshold-megabytes ``` **Le drapeau `etcd --experimental-compaction-batch-limit` a été déprécié.** ```diff -etcd --experimental-compaction-batch-limit +etcd --compaction-batch-limit ``` **Le drapeau `etcd --experimental-compact-hash-check-time` a été déprécié.** ```diff -etcd --experimental-compact-hash-check-time +etcd --compact-hash-check-time ``` **Le drapeau `etcd --experimental-compaction-sleep-interval` a été déprécié.** ```diff -etcd --experimental-compaction-sleep-interval +etcd --compaction-sleep-interval ``` **Le drapeau `etcd --experimental-corrupt-check-time` a été déprécié.** ```diff -etcd --experimental-corrupt-check-time +etcd --corrupt-check-time ``` **Le drapeau `etcd --experimental-enable-distributed-tracing` a été déprécié.** ```diff -etcd --experimental-enable-distributed-tracing +etcd --enable-distributed-tracing ``` **Le drapeau `etcd --experimental-distributed-tracing-address` a été déprécié.** ```diff -etcd --experimental-distributed-tracing-address +etcd --distributed-tracing-address ``` **Le drapeau `etcd --experimental-distributed-tracing-instance-id` a été déprécié.** ```diff -etcd --experimental-distributed-tracing-instance-id +etcd --distributed-tracing-instance-id ``` **Le drapeau `etcd --experimental-distributed-tracing-sampling-rate` a été déprécié.** ```diff -etcd --experimental-distributed-tracing-sampling-rate +etcd --distributed-tracing-sampling-rate ``` **Le drapeau `etcd --experimental-distributed-tracing-service-name` a été déprécié.** ```diff -etcd --experimental-distributed-tracing-service-name +etcd --distributed-tracing-service-name ``` **Le drapeau `etcd --experimental-downgrade-check-time` a été déprécié.** ```diff -etcd --experimental-downgrade-check-time +etcd --downgrade-check-time ``` **Le drapeau `etcd --experimental-max-learners` a été déprécié.** ```diff -etcd --experimental-max-learners +etcd --max-learners ``` **Le drapeau `etcd --experimental-memory-mlock` a été déprécié.** ```diff -etcd --experimental-memory-mlock +etcd --memory-mlock ``` **Le drapeau `etcd --experimental-peer-skip-client-san-verification` a été déprécié.** ```diff -etcd --experimental-peer-skip-client-san-verification +etcd --peer-skip-client-san-verification ``` **Le drapeau `etcd --experimental-snapshot-catchup-entries` a été déprécié.** ```diff -etcd --experimental-snapshot-catchup-entries +etcd --snapshot-catchup-entries ``` **Le drapeau `etcd --experimental-warning-apply-duration` a été déprécié.** ```diff -etcd --experimental-warning-apply-duration +etcd --warning-apply-duration ``` **Le drapeau `etcd --experimental-warning-unary-request-duration` a été déprécié.** ```diff -etcd --experimental-warning-unary-request-duration +etcd --warning-unary-request-duration ``` **Le drapeau `etcd --experimental-watch-progress-notify-interval` a été déprécié.** ```diff -etcd --experimental-watch-progress-notify-interval +etcd --watch-progress-notify-interval ``` ### Drapeaux équivalents des fonctionnalités v3.5 {#equivalent-flags-of-v35-feature-gates} **drapeau équivalent pour la fonctionnalité `etcd --experimental-compact-hash-check-enabled=true`** ```diff -etcd --experimental-compact-hash-check-enabled=true +etcd --feature-gates=CompactHashCheck=true ``` **drapeau équivalent pour la fonctionnalité `etcd --experimental-initial-corrupt-check=true`** ```diff -etcd --experimental-initial-corrupt-check=true +etcd --feature-gates=InitialCorruptCheck=true ``` **drapeau équivalent pour la fonctionnalité `etcd --experimental-enable-lease-checkpoint=true`** ```diff -etcd --experimental-enable-lease-checkpoint=true +etcd --feature-gates=LeaseCheckpoint=true ``` **drapeau équivalent pour la fonctionnalité `etcd --experimental-enable-lease-checkpoint-persist=true`** ```diff -etcd --experimental-enable-lease-checkpoint-persist=true +etcd --feature-gates=LeaseCheckpointPersist=true ``` **drapeau équivalent pour la fonctionnalité `etcd --experimental-stop-grpc-service-on-defrag=true`** ```diff -etcd --experimental-stop-grpc-service-on-defrag=true +etcd --feature-gates=StopGRPCServiceOnDefrag=true ``` **drapeau équivalent pour la fonctionnalité `etcd --experimental-txn-mode-write-with-shared-buffer=false`** ```diff -etcd --experimental-txn-mode-write-with-shared-buffer=false +etcd --feature-gates=TxnModeWriteWithSharedBuffer=false ``` ### Drapeaux avec de nouvelles valeurs par défaut {#flags-with-new-defaults} **Drapeau par défaut par défaut `etcd --snapshot-count=100000`** ```diff -etcd --snapshot-count=100000 +etcd --snapshot-count=10000 ``` **Drapeau par défaut `etcd --v2-deprecation='not-yet'`** ```diff -etcd --v2-deprecation='not-yet' +etcd --v2-deprecation='write-only' ``` **Drapeau par défaut `etcd --discovery-fallback='proxy'`** ```diff -etcd --discovery-fallback='proxy' +etcd --discovery-fallback='exit' ``` ### Différence entre les métriques Prometheus {#difference-in-prometheus-metrics} ```diff # metrics added in v3.6 +etcd_network_known_peers +etcd_server_feature_enabled ``` ### Liste de vérification pour la mise à jour du serveur {#server-upgrade-checklists} #### Exigences de mise à jour {#upgrade-requirements} Pour mettre à jour un déploiement etcd existant vers la version 3.6, le cluster en cours d'exécution doit être la version 3.5 ou ultérieure. Si la version est antérieure à 3.5, veuillez [mettre à jour vers la version 3.5](/fr/docs/etcd/upgrades/upgrade_3_4/) avant de procéder à la mise à jour vers la version 3.6. En outre, pour garantir une mise à niveau progressive sans incident, le cluster en cours d'exécution doit être sain. Vérifiez l'état de santé du cluster à l'aide de la commande `etcdctl endpoint health` avant de poursuivre. #### Préparation {#preparation} Avant de mettre à jour etcd, testez toujours les services dépendants d’etcd dans un environnement de préproduction avant de déployer la mise à jour dans l’environnement de production. Avant de commencer, [téléchargez la sauvegarde d'instantané](/fr/docs/etcd/op-guide/maintenance/#snapshot-backup). Si une erreur survient lors de la mise à jour, il sera possible d'utiliser cette sauvegarde pour [annuler](#rollback) la mise à jour et revenir à la version existante de etcd. Veuillez noter que la `snapshot` commande ne sauvegarde que les données v3. #### Versions mixtes {#mixed-versions} Lors d'une mise à jour, un cluster etcd prend en charge des versions mixtes de membres et fonctionne selon le protocole de la version commune la plus basse. Le cluster n'est considéré comme mis à jour qu'une fois que tous ses membres ont été mis à jour vers la version v3.6. Internement, les membres etcd négocient entre eux afin de déterminer la version globale du cluster, qui contrôle la version signalée et les fonctionnalités prises en charge. #### Annuler {#rollback} Avant de mettre à jour votre cluster etcd, créez et [téléchargez une sauvegarde sous forme d'instantané](/fr/docs/etcd/op-guide/maintenance/#snapshot-backup) de votre cluster etcd. Cet instantané peut être utilisé pour restaurer le cluster dans son état antérieur à la mise à jour si nécessaire. Si les utilisateurs rencontrent des problèmes pendant la mise à jour, ils doivent d'abord identifier et résoudre la cause racine. Si le cluster est toujours dans un état mixte — où au moins un membre reste sur la version v3.5 —, il est possible de remplacer le binaire ou l'image par la version v3.5 antérieure, ou de restaurer directement le cluster à l'aide de l'instantané. Dans cet état mixte, le cluster continue de fonctionner en tant que cluster v3.5, permettant ainsi un retour arrière sans suivre un processus formel de rétrogradation. Toutefois, une fois que tous les membres ont été mis à jour vers la version v3.6, le cluster est considéré comme entièrement mis à jour et la récupération à l’aide des binaires n’est plus possible. Dans ce cas, la seule option de récupération consiste à restaurer à partir de l’instantané pris avant la mise à jour. Si les utilisateurs souhaitent revenir à la version d’origine après une mise à jour complète, ils doivent suivre le guide officiel de rétrogradation afin d’assurer la cohérence et éviter toute corruption des données. ### Procédure de mise à jour {#upgrade-procedure} Cet exemple montre comment mettre à jour un cluster etcd v3.5 composé de 3 membres, en cours d'exécution sur une machine locale. #### Étape 1 : vérifier les exigences de mise à jour {#step-1-check-upgrade-requirements} Le cluster est-il sain et en cours d'exécution sous la version 3.5.x ? ```bash etcdctl --endpoints=localhost:2379,localhost:22379,localhost:32379 endpoint health < `{"level":"info","ts":"2025-03-01T04:40:36.828+0530","caller":"api/capability.go:76","msg":"enabled capabilities for version","cluster-version":"3.5"}` > > `{"level":"info","ts":"2025-03-01T04:40:36.889+0530","caller":"membership/cluster.go:539","msg":"updated cluster version","cluster-id":"59a05384c9b79ee","local-member-id":"bf9071f4639c75cc","from":"3.0","to":"3.5"}` > > `{"level":"info","ts":"2025-03-01T04:40:36.828+0530","caller":"api/capability.go:76","msg":"enabled capabilities for version","cluster-version":"3.5"}` > > `{"level":"info","ts":"2025-03-01T04:40:36.894+0530","caller":"etcdserver/server.go:1686","msg":"published local member to cluster through raft","local-member-id":"bf9071f4639c75cc","local-member-attributes":"{Name:node1 ClientURLs:[http://127.0.0.1:2379]}","cluster-id":"59a05384c9b79ee","publish-timeout":"7s"}` Vérifiez que chaque membre, puis l’ensemble du cluster, devient sain avec la nouvelle binaire etcd v3.6 : ```bash etcdctl endpoint health --endpoints=localhost:2379,localhost:22379,localhost:32379 < `{"level":"info","ts":"2025-03-01T04:58:32.375+0530","caller":"etcdserver/server.go:2149","msg":"updating cluster version using v3 API","from":"3.5","to":"3.6"}` > `{"level":"info","ts":"2025-03-01T04:58:32.377+0530","caller":"etcdserver/server.go:2164","msg":"cluster version is updated","cluster-version":"3.6"}` Membre 2 : > `{"level":"info","ts":"2025-03-01T04:58:32.377+0530","caller":"membership/cluster.go:539","msg":"updated cluster version","cluster-id":"59a05384c9b79ee","local-member-id":"91bc3c398fb3c146","from":"3.5","to":"3.6"}` Membre 3 : > `{"level":"info","ts":"2025-03-01T04:58:32.377+0530","caller":"membership/cluster.go:539","msg":"updated cluster version","cluster-id":"59a05384c9b79ee","local-member-id":"fd422379fda50e48","from":"3.5","to":"3.6"}` ```bash endpoint health --endpoints=localhost:2379,localhost:22379,localhost:32379 <