Upgrading etcd clusters and applications

This section contains documents specific to upgrading etcd clusters and applications.

Upgrade policy

Before upgrading, note that etcd only supports the following two upgrade cases:

• Patch upgrade: Upgrading between patch releases within the same minor version (e.g. 3.4.18 - 3.4.20).
• Minor upgrade: Upgrading one minor version at a time (e.g. 3.3 - 3.4). Upgrades that skip a minor version are not supported and will likely fail. Update to the most recent patch version before upgrading to the next minor version.

Moving from etcd API v2 to API v3

• Migrate applications from using API v2 to API v3

Upgrading an etcd v3.x cluster

• Upgrade etcd from 3.0 to 3.1
• Upgrade etcd from 3.1 to 3.2
• Upgrade etcd from 3.2 to 3.3
• Upgrade etcd from 3.3 to 3.4

Upgrading from etcd v2.3

• Upgrade a v2.3 cluster to v3.0