Create a specific version of a user-managed notebooks instance

This page describes how you can create a user-managed notebooks instance based on a specific Deep Learning VM Images version.

Why you might want to create a specific version

User-managed notebooks instances are created using Deep Learning VM images.

Deep Learning VM images are updated frequently, and specific versions of pre-installed software and packages vary from version to version.

You might want to create a specific version of a user-managed notebooks instance to ensure that the instance has a version of a pre-installed software component or package that is compatible with your code or application.

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

Before you begin

Follow the steps in Before you begin to create a Google Cloud project and enable the Notebooks API.

Find the specific version that you want

To create a user-managed notebooks instance based on a specific Deep Learning VM version, you must know the image name of the specific Deep Learning VM version.

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

Complete the following steps to find the specific image name that you want by listing all of the image names included in a Deep Learning VM release.

  1. Find the Deep Learning VM release number that you want to use. 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, M79.

  2. Run the following command to list the image names for a specific Deep Learning VM release.

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

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

  3. Find the image name that you want to use in the list of results.

Create a specific verson from the command line

To create a specific version of a user-managed notebooks instance from the command line, complete the following steps.

  1. Run the following gcloud notebooks command:

    gcloud notebooks instances create INSTANCE_NAME \
        --vm-image-project="deeplearning-platform-release" \
        --vm-image-name=VM_IMAGE_NAME \
        --machine-type=MACHINE_TYPE \
        --location=LOCATION
    

    Replace the following:

    • INSTANCE_NAME: the name of your new instance
    • VM_IMAGE_NAME: the image name that you want to use to create your instance
    • MACHINE_TYPE: the machine type of your instance's VM
    • LOCATION: the Google Cloud location where you want your new instance to be
  2. Access your instance from the Google Cloud Console.

What's next