Upgrading Calico for Kubernetes

Before you begin

• You must first upgrade to at least Calico v2.6.5 before you can upgrade to Calico v3.2.1.

  Important: Calico v2.6.5 was a special transitional release that included changes to enable upgrade to Calico v3.x. Do not skip this step!

• If you are using the etcd datastore, upgrade etcd to the latest stable v3 release.

About upgrading to Calico v3.2.1

The steps to upgrade differ according to your current version and datastore type.

• Kubernetes API datastore, Calico v2.6.5 or later: Complete the steps in Upgrade Calico.

• etcd datastore, Calico v3.x: Complete the steps in Upgrade Calico.

• etcd datastore, Calico v2.6.x: You must migrate your data before you can upgrade. Complete the steps in each of the following sections.

  1. Install and configure calico-upgrade

  2. Test the data migration and check for errors

  3. Migrate Calico data

  4. Upgrade Calico