etcd Versioning, Support, and NixOS Integration

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

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

Title: etcd Versioning, Support, and NixOS Integration

Summary

The etcd project supports the current and previous major/minor versions. In the NixOS ecosystem, each etcd version bump requires a notification in the NixOS release notes for the eventual removal of unsupported versions by maintainers. Users are advised to upgrade etcd to the latest version within their current NixOS release before upgrading NixOS itself, as manual steps or specific instructions in the NixOS release notes might be necessary.