Upgrade the environment of a managed notebooks instance

Vertex AI Workbench managed notebooks isdeprecated. On April 14, 2025, support for managed notebooks ended and the ability to create managed notebooks instances was removed. Existing instances will continue to function until March 30, 2026, but patches, updates, and upgrades won't be available. To continue using Vertex AI Workbench, we recommend that youmigrate your managed notebooks instances to Vertex AI Workbench instances.

Vertex AI Workbench managed notebooks instances areGoogle-managed environments with integrations andfeatures that help you set up and work inan end-to-end notebook-based production environment.This page describes how to upgrade the environment ofa managed notebooks instance.

Upgrade methods

There is one way to upgrade a managed notebooks instance:

• Manual upgrade: Ifan existing managed notebooks instancemeets therequirementsfor upgrading, you can upgrade the instance manually.

Requirements and limitations

Backward compatibility with your managed notebooks isn'tguaranteed.Make a copy ofyour databefore upgrading a managed notebooks instance.

To determine whether you can upgradea specific managed notebooks instance,see the following requirements and limitations:

• The Notebooks API must be enabled in the instance's Google Cloud project. For more information, seeList enabled services andEnable an API.

• After upgrading, an instance cannot be rolled back to the previous version.

• Instances that are version M112 or earlier use Python 3.7, and thereforecan't be upgraded to a more recent version than M112. This is because M112is the latest version to support Python 3.7.

How the upgrade works

Managed notebooks instances are dual-disk, withone boot disk and one data disk. The upgrade process upgrades the boot diskto a new image while preserving your data on the data disk.

Which components are upgraded

The following table shows which components ofyour managed notebooksinstance are upgraded, which are preserved,and which need to be reinstalled.

Before you begin

Before you upgrade, complete the following steps.

1. Check therelease notes to learn aboutupdates to newer versions.

2. Make a copy of your dataas a backup.

Check for a newer version of your instance's environment

To check whether a newer version of your instance's environment is available,access your instance from the Google Cloud console.

1. In the Google Cloud console, go to theManaged notebooks page.

   Go to Managed notebooks

2. On theManaged notebooks tab, "Upgrade available" will appear ineach upgradeable instance's row.There will also be a message at the top sayinghow many notebooks have available upgrades.

Upgrade your instance's environment to a newer version

You can manually upgrade a managed notebooks instance inthe Google Cloud console.

1. In the Google Cloud console, go to theManaged notebooks page.

   Go to Managed notebooks

2. If the instances that you want to upgrade aren't running,start theinstances.Vertex AI Workbench can only upgrade instances whenthey're running.

3. If you want to upgrade all upgradeablemanaged notebooks instances,then on theManaged notebooks tab, in the message at the topof the page, click theUpgrade all button. If thereis no message at the top, then there are nomanaged notebooks instances that can be upgraded.

4. If you want to upgrade an individual notebook,then on theManaged notebooks tab, selectthe managed notebooks instance thatyou want to upgrade. There will be an "Upgrade available" messagein the instance's row.

5. Make sure you havemade a copy of the data on yourinstance beforecontinuing.

6. On theManaged notebooks tab, click Upgrade.