Documentation On How To Upgrade Antrea CNI

[gbonazzoli]

Can someone help me in finding the document that describes the procedure to upgrade Antrea CNI.

I find only documentation regarding its installation.

I think it is only a matter to run kubectl apply -f .... as the installation but I've a doubt if it must be preceded by a deletion with the same yaml file that was used during the cluster's installation.

Thank you.

[luolanzone]

Hi @gbonazzoli you can check this section https://github.com/antrea-io/antrea/blob/main/docs/versioning.md#antrea-upgrade-and-supported-version-skew to see if this can help you or not. Could you let us know what's the old version and new version for your upgrade? Antrea didn't support "graceful" upgrades if the versions gap are large.

cc @tnqn @antoninbas @jianjuns

[antoninbas]

I guess we could rename this section from Installation to Installation and Upgrade.
But yes, the steps are the same for installation and upgrade.
For production workloads for which it may be important to minimize disruptions, we would recommend upgrading the Controller first and the Agent last, as described in the documentation. However, we do not provide "split" manifests to do that.

[gbonazzoli]

@antoninbas @luolanzone

Thanks a lot, I upgraded Antrea CNI with the following:

govc snapshot.create -vm=vm.kube.master bonaz-snapshot
kubectl apply -f https://github.com/antrea-io/antrea/releases/download/v1.13.2/antrea.yml
govc snapshot.remove -vm=vm.kube.master bonaz-snapshot

Looking at the upgrade process I was lucky. It was first upgraded the controller and then, one by one, the agents on the three node cluster.

The version I was coming was 1.13-dev-something and I was only worried by the "dev" string.

[antoninbas]

Looking at the upgrade process I was lucky. It was first upgraded the controller and then, one by one, the agents on the three node cluster.

I believe the controller and the "first" agent will usually upgrade concurrently. But once again, as far as we know, nothing breaks when some agents upgrade after the controller, which is why we haven't provided separate manifests. When using the Helm chart to install / upgrade, there is no specific order being enforced either.

The version I was coming was 1.13-dev-something and I was only worried by the "dev" string.

That doesn't sound right. Where do you get this version string? This should only happen if you use the current dev version of Antrea and apply https://raw.githubusercontent.com/antrea-io/antrea/main/build/yamls/antrea.yml. Even then, you would get 1.14-dev, since we are currently working on Antrea v1.14.