etcd Version Support and Upgrades in NixOS

pkgs/servers/etcd/README.md

3dcb3446099875b85908adea1acb36b9b1306d89fbf85d340000000300000391

# etcd


## Upstream release cadence and support

The etcd project maintains release branches for the current version and previous release.

For example, when v3.5 is the current version, v3.4 is supported. When v3.6 is released, v3.4 goes out of support.

Reference: https://etcd.io/docs/v3.5/op-guide/versioning/


## NixOS release and etcd version upkeep

Every major/minor version bump of `etcd` top-level alias in nixpkgs requires a notification in the next NixOS release notes scheduling the removal of the now unsupported etcd version.

After every NixOS release, the unsupported etcd versions should be removed by etcd maintainers.


## User guidelines on etcd upgrades

Before upgrading a NixOS release, certify to upgrade etcd to the latest version in the current used release.

Manual steps might be required for the upgrade.

NixOS release notes might have instructions on how to proceed on upgrades.

Chunks

deff3b11 (1st chunk of `pkgs/servers/etcd/README.md`)

Title: etcd Version Support and Upgrades in NixOS

Summary

This section outlines the etcd project's release cadence and support policy, which supports the current and previous major/minor versions. It details how NixOS handles etcd version upgrades, requiring notifications in release notes for removals of unsupported versions. Users are advised to upgrade etcd to the latest version within their current NixOS release before upgrading the NixOS release itself, potentially involving manual steps guided by the release notes.