Upgrade VM Runtime on Google Distributed Cloud from a Preview version

VM Runtime on Google Distributed Cloud is released for General Availability (GA) with the release of GKE on Bare Metal version 1.12.0. All earlier releases of VM Runtime on Google Distributed Cloud are in Preview. You can't upgrade from a Preview version to the GA version without first deleting your VMs and disabling VM Runtime on Google Distributed Cloud. Once you've upgraded your clusters, then you can enable VM Runtime on Google Distributed Cloud again and recreate your VMs.

To upgrade from a pre-GA version of VM Runtime on Google Distributed Cloud:

  1. Delete all VMs and their resources from the cluster.

    For instructions for version 1.10 clusters, see Delete VMs and their resources in the 1.10 documentation. For instructions for 1.11 clusters, see Delete VMs and their resources in the 1.11 documentation.

  2. Disable VM Runtime on Google Distributed Cloud.

    For instructions for version 1.10 clusters, see Disable VM Runtime on Google Distributed Cloud in the 1.10 documentation. For instructions for 1.11 clusters, see Disable VM Runtime on Google Distributed Cloud in the 1.11 documentation.

  3. If Multus is installed on your cluster, uninstall it.

    Multus is used with the multi-NIC for pods feature.

  4. Upgrade the cluster to version 1.12.0 or higher.

    You can't skip minor versions when upgrading your GKE on Bare Metal. For example, if you have a version 1.10 cluster, you must first upgrade to version 1.11 before you can upgrade to version 1.12.0 or higher. For more information, see Upgrade clusters.

  5. Enable VM Runtime on Google Distributed Cloud on your 1.12.0 cluster.

    For instructions, see Enable VM Runtime on Google Distributed Cloud.

  6. Recreate your VMs.

    Due to changes in the VM schema for the GA release of VM Runtime on Google Distributed Cloud, you must recreate your VMs. For use with VM Runtime on Google Distributed Cloud on version 1.12.0 or higher clusters.

What's next