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
To ensure that your user-managed notebooks instance has software that is compatible with your code or application, you might want to create a specific version.
User-managed notebooks 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 user-managed notebooks instance, you can upgrade it. Upgrading the instance updates the preinstalled software and packages. For more information, see Upgrade a user-managed notebooks instance's environment.
Before you begin
To create a Google Cloud project and enable the Notebooks API, complete the steps in Before you begin.
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 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, list all of the image names included in a Deep Learning VM release by completing the following steps:
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
Mfollowed by the number of the release, for example,
To list the image names for a specific Deep Learning VM release, run the following command.
gcloud compute images list --project="deeplearning-platform-release" \ --format="value(name)" \ --filter="labels.release=RELEASE_NUMBER" \ --show-deprecated
RELEASE_NUMBERwith a Deep Learning VM release number, such as
Find the image name that you want to use.
Create a specific version from the command line
To create a specific version of a user-managed notebooks instance from the command line, complete the following steps:
Run the following
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
Access your instance from the Google Cloud console.
Learn more about upgrading user-managed notebooks instances to ensure that your instance upgrades only when you are ready.
Install dependencies on your new user-managed notebooks instance.
Learn more about Deep Learning VM instances in the Deep Learning VM documentation.
Learn about monitoring the health status of your user-managed notebooks instance.