Version 1.16. This version is no longer supported. For information about how to upgrade to version 1.28, seeUpgrade clustersin the latest documentation. For more information about supported and unsupported versions, see theVersioningpage 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 inPreview.
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, seeUpgrade 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 to the GA version from a Preview version requires deleting all VMs and disabling VM Runtime on GDC before the upgrade.\u003c/p\u003e\n"],["\u003cp\u003eThe upgrade process includes deleting all VMs and their resources, disabling VM Runtime, potentially uninstalling Multus, upgrading the cluster to version 1.12.0 or higher, 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\u003eIf upgrading from a cluster below 1.12.0, you cannot skip minor versions, and will need to upgrade to the next version in sequence.\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.16/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.16/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.16/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.16/vm-runtime/quickstart)"]]
