etcd upgrades on etcd

Upgrade etcd from 2.3 to 3.0

Mon, 01 Jan 0001 00:00:00 +0000

In the general case, upgrading from etcd 2.3 to 3.0 can be a zero-downtime, rolling upgrade:

one by one, stop the etcd v2.3 processes and replace them with etcd v3.0 processes
after running all v3.0 processes, new features in v3.0 are available to the cluster

Before starting an upgrade, read through the rest of this guide to prepare.

Upgrade checklists

NOTE: When migrating from v2 with no v3 data, etcd server v3.2+ panics when etcd restores from existing snapshots but no v3 ETCD_DATA_DIR/member/snap/db file. This happens when the server had migrated from v2 with no previous v3 data. This also prevents accidental v3 data loss (e.g. db file might have been moved). etcd requires that post v3 migration can only happen with v3 data. Do not upgrade to newer v3 versions until v3.0 server contains v3 data.

Upgrade etcd from 3.0 to 3.1

Mon, 01 Jan 0001 00:00:00 +0000

In the general case, upgrading from etcd 3.0 to 3.1 can be a zero-downtime, rolling upgrade:

one by one, stop the etcd v3.0 processes and replace them with etcd v3.1 processes
after running all v3.1 processes, new features in v3.1 are available to the cluster

Before starting an upgrade, read through the rest of this guide to prepare.

Upgrade checklists

Upgrade etcd from 3.1 to 3.2

Mon, 01 Jan 0001 00:00:00 +0000

In the general case, upgrading from etcd 3.1 to 3.2 can be a zero-downtime, rolling upgrade:

one by one, stop the etcd v3.1 processes and replace them with etcd v3.2 processes
after running all v3.2 processes, new features in v3.2 are available to the cluster

Before starting an upgrade, read through the rest of this guide to prepare.

Upgrade checklists

Upgrade etcd from 3.2 to 3.3

Mon, 01 Jan 0001 00:00:00 +0000

In the general case, upgrading from etcd 3.2 to 3.3 can be a zero-downtime, rolling upgrade:

one by one, stop the etcd v3.2 processes and replace them with etcd v3.3 processes
after running all v3.3 processes, new features in v3.3 are available to the cluster

Before starting an upgrade, read through the rest of this guide to prepare.

Upgrade checklists

Upgrade etcd from 3.3 to 3.4

Mon, 01 Jan 0001 00:00:00 +0000

In the general case, upgrading from etcd 3.3 to 3.4 can be a zero-downtime, rolling upgrade:

one by one, stop the etcd v3.3 processes and replace them with etcd v3.4 processes
after running all v3.4 processes, new features in v3.4 are available to the cluster

Before starting an upgrade, read through the rest of this guide to prepare.

Upgrade checklists

Upgrading etcd clusters and applications

Mon, 01 Jan 0001 00:00:00 +0000

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

etcd upgrades on etcd

Upgrade etcd from 2.3 to 3.0

Upgrade checklists

Upgrade etcd from 3.0 to 3.1

Upgrade checklists

Upgrade etcd from 3.1 to 3.2

Upgrade checklists

Upgrade etcd from 3.2 to 3.3

Upgrade checklists

Upgrade etcd from 3.3 to 3.4

Upgrade checklists

Upgrading etcd clusters and applications

Moving from etcd API v2 to API v3

Upgrading an etcd v3.x cluster

Upgrading from etcd v2.3