Version 1.15. This version is no longer supported. For information about how to upgrade to version 1.16, see Upgrade clusters in the latest documentation. For more information about supported and unsupported versions, see the Version history page in the latest documentation.
VM Runtime on GDC is released for General Availability (GA) with the
release of Google Distributed Cloud version 1.12.0. All earlier releases of
VM Runtime on GDC 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 GDC. Once you've upgraded
your clusters, then you can enable VM Runtime on GDC again and recreate
your VMs.
To upgrade from a pre-GA version of VM Runtime on GDC:
Delete all VMs and their resources from the cluster.
You can't skip minor versions when upgrading your Google Distributed Cloud.
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.
Due to changes in the VM schema for the GA release of
VM Runtime on GDC, you must recreate your VMs. For use with
VM Runtime on GDC on version 1.12.0 or higher clusters.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[[["\u003cp\u003eVM Runtime on GDC is now generally available (GA) with Google Distributed Cloud version 1.12.0, while earlier releases were in Preview.\u003c/p\u003e\n"],["\u003cp\u003eUpgrading from a Preview version to the GA version requires deleting all VMs and disabling VM Runtime on GDC before the upgrade.\u003c/p\u003e\n"],["\u003cp\u003eThe upgrade process from a pre-GA version involves deleting VMs, disabling VM Runtime, potentially uninstalling Multus, upgrading the cluster to at least version 1.12.0, and then re-enabling VM Runtime.\u003c/p\u003e\n"],["\u003cp\u003eDue to schema changes in the GA release, VMs must be recreated after upgrading to version 1.12.0 or higher.\u003c/p\u003e\n"],["\u003cp\u003eUpgrading to 1.12.0 can not skip minor versions, for example, upgrading from version 1.10 must first upgrade to 1.11 before being able to go to 1.12.0 or higher.\u003c/p\u003e\n"]]],[],null,["# Upgrade VM Runtime on GDC from a Preview version\n\n\u003cbr /\u003e\n\nVM Runtime on GDC is released for General Availability (GA) with the\nrelease of Google Distributed Cloud version 1.12.0. All earlier releases of\nVM Runtime on GDC are in [Preview](/products#product-launch-stages).\nYou can't upgrade from a Preview version to the GA version without first\ndeleting your VMs and disabling VM Runtime on GDC. Once you've upgraded\nyour clusters, then you can enable VM Runtime on GDC again and recreate\nyour VMs.\n\nTo upgrade from a pre-GA version of VM Runtime on GDC:\n\n1. Delete all VMs and their resources from the cluster.\n\n | **Note:** If you have version 1.11 clusters, you can delete VMs and resource and disable VM Runtime on GDC with a single command. For information on how to use `bmctl` to disable VM Runtime on GDC, see [Disable VM Runtime on GDC](/anthos/clusters/docs/bare-metal/1.11/how-to/vm-workloads#disable) in the version 1.11 documentation.\n\n For instructions for version 1.10 clusters, see\n [Delete VMs and their resources](/anthos/clusters/docs/bare-metal/1.10/how-to/vm-workloads#delete_vms_and_their_resources)\n in the 1.10 documentation. For instructions for 1.11 clusters, see\n [Delete VMs and their resources](/anthos/clusters/docs/bare-metal/1.10/how-to/vm-workloads#delete_vms_and_their_resources)\n in the 1.11 documentation.\n2. Disable VM Runtime on GDC.\n\n For instructions for version 1.10 clusters, see\n [Disable VM Runtime on GDC](/anthos/clusters/docs/bare-metal/1.10/how-to/vm-workloads#disable_anthos_vm_runtime)\n in the 1.10 documentation. For instructions for 1.11 clusters, see\n [Disable VM Runtime on GDC](/anthos/clusters/docs/bare-metal/1.10/how-to/vm-workloads#disable)\n in the 1.11 documentation.\n3. If Multus is installed on your cluster, uninstall it.\n\n Multus is used with the\n [multi-NIC for pods](/anthos/clusters/docs/bare-metal/1.15/how-to/multi-nic) feature.\n4. Upgrade the cluster to version 1.12.0 or higher.\n\n You can't skip minor versions when upgrading your Google Distributed Cloud.\n For example, if you have a version 1.10 cluster, you must first upgrade to\n version 1.11 before you can upgrade to version 1.12.0 or higher. For more\n information, see [Upgrade clusters](/anthos/clusters/docs/bare-metal/1.15/how-to/upgrade).\n5. Enable VM Runtime on GDC on your 1.12.0 cluster.\n\n For instructions, see\n [Enable VM Runtime on GDC](/anthos/clusters/docs/bare-metal/1.15/vm-runtime/enable-disable#enable).\n6. Recreate your VMs.\n\n Due to changes in the VM schema for the GA release of\n VM Runtime on GDC, you must recreate your VMs. For use with\n VM Runtime on GDC on version 1.12.0 or higher clusters.\n\nWhat's next\n-----------\n\n- [Quickstart: Create a VM in Google Distributed Cloud](/anthos/clusters/docs/bare-metal/1.15/vm-runtime/quickstart)"]]
