Create a specific version of an instance

This page describes how you can create a Vertex AI Workbench instance based on a specific Deep Learning VM Images version.

Why you might want to create a specific version

To ensure that your Vertex AI Workbench instance has software that is compatible with your code or application, you might want to create a specific version.

Vertex AI Workbench instances are created by using Deep Learning VM images. Deep Learning VM images are updated frequently, and specific versions of preinstalled software and packages vary from version to version.

To learn more about specific Deep Learning VM versions, see the Deep Learning VM release notes.

After you create a specific version of a Vertex AI Workbench instance, you can upgrade it. Upgrading the instance updates the preinstalled software and packages.

Before you begin

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Notebooks API.

    Enable the API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Notebooks API.

    Enable the API

Find the specific version that you want

To create a Vertex AI Workbench instance based on a specific Deep Learning VM version, you must know the image name of the specific Deep Learning VM version that you want to use.

Each release of Deep Learning VM includes updates to many different images, and each image in the release has its own image name.

To find the specific image name that you want:

  1. Find the Deep Learning VM release number that you want to get image names for. Release numbers are included in the Deep Learning VM release notes. Release numbers are in the form of an M followed by the number of the release, for example, M108.

  2. To list the image names for a specific Deep Learning VM release, run the following command.

    gcloud compute images list --project="cloud-notebooks-managed" \
        --format="value(name)" \
        --filter="labels.release=RELEASE_NUMBER" \
        --show-deprecated
    

    Replace RELEASE_NUMBER with a Deep Learning VM release number, such as M108.

  3. Find the image name that you want to use.

Create a specific version

You can create a specific version of a Vertex AI Workbench instance by using the Google Cloud console.

  1. When you create an instance, in the Environment section, select Use a previous version.

  2. In the Verson drop-down list, select a version.

  3. Access your instance from the Google Cloud console.

What's next