Create a new notebook instance

An AI Platform Notebooks (JupyterLab) instance is a Deep Learning virtual machine instance with the latest machine learning and data science libraries pre-installed, with the option to include Nvidia GPUs for hardware acceleration.

Before you begin

Follow the steps in Before you begin to create a Google Cloud Platform (GCP) project and enable the Compute Engine API.

Create a new notebook with default options

To create an AI Platform Notebooks instance with default options, follow these steps:

  1. Go to the AI Platform Notebooks page in the Google Cloud Platform Console.

    Go to the AI Platform Notebooks page

  2. Select New Instance, select an instance type (for example, TensorFlow 1.x), and then choose whether to include a GPU.

    Create new AI Platform Notebooks instance

  3. If you chose to include a GPU, you must select the option to Install NVIDIA GPU driver automatically on first startup (this is a legal requirement). You can adjust the number of GPUs later if you need to. For information on adjusting the number of GPUs, see Manage hardware accelerators for a notebook.

  4. Click Create.

  5. AI Platform Notebooks creates a new instance for you, based on your selected option, with a default name, for example, tensorflow-1550869641175.

    List of notebooks

Create a new notebook and specify your instance options

If you prefer to create an instance with options other than those provided by the default instance types, you can create a new instance and specify your preferred options.

To create an AI Platform Notebooks instance and specify the options for your instance, follow these steps:

  1. Go to the AI Platform Notebooks page in the Google Cloud Platform Console.

    Go to the AI Platform Notebooks page

  2. Select New Instance, and then select Customize instance.

    Create new AI Platform Notebooks instance with options

  3. On the New notebook instance page, provide the following information for your new instance:

    • Instance name - provide a name for your new instance.
    • Region - select a region for the new instance. Select the region that is geographically closest to you for best network performance.
    • Zone - select a zone within the region that you selected.
    • ML framework - select the Machine Learning framework to use for your new AI Platform Notebooks instance.
    • Machine type - select the number of CPUs and amount of RAM for your new instance. AI Platform Notebooks provides monthly cost estimates for each machine type that you select.
    • GPUs - select the GPU type and Number of GPUs for your new instance. For information about the different GPUS, see GPUs on Compute Engine.

      Select the option to Install NVIDIA GPU driver automatically on first startup (this is a legal requirement).

      You can modify the GPU type and number of GPUs for your instance after it is created. For more information, see Manage hardware accelerators for a notebook.

  4. If you want to change the default boot disk settings or encryption settings, expand the Boot disk section and complete the following steps:

    1. Select the Boot disk type and Boot disk size in GB that you want. See Storage options to learn more about disk types.

    2. Under Encryption, select Customer-managed key to use customer-managed encryption. Select the customer-managed key that you want to use, or enter the resource ID for your customer-managed key. The resource ID for your customer-managed key looks like this:

      projects/project-id/locations/global/keyRings/name-of-key-ring/cryptoKeys/name-of-key

      You can retrieve a resource ID by running the following gcloud command in Cloud Shell, or any terminal where Cloud SDK is installed.

      gcloud kms keys list --location global --keyring name-of-key-ring

      If necessary, click Grant to give your service account permissions to encrypt and decrypt using this key.

      Learn about customer-managed encryption keys and how to use customer-managed encryption keys to encrypt specific objects. Then create your own customer-managed encryption key.

  5. If you want to change network settings, such as to select a Virtual Private Cloud, disable proxy access, or disable the external IP address, complete the following steps:

    1. Expand the Networking section.

    2. Select either Networks in this project or Networks shared with me.

    3. On the Network menu, select the network that you want. You can select a VPC network, as long as the network has Private Google Access enabled or can access the internet.

    4. On the Subnetwork menu, select the subnetwork that you want.

    5. If you want to disable the external IP address, set the External IP menu to None.

    6. If you want to disable proxy access, clear the checkbox next to Allow proxy access when it's available.

  6. If you want to grant access to all users who have access to a specific Compute Engine service account or to a specific user, expand the Permission section and complete one of the following steps:

    • To grant access to a specific service account, click the Access to JupyterLab menu, and select Other service account. Then fill out the Service account field. Learn more about service accounts.

    • To grant access to a single user, click the Access to JupyterLab menu, and select Single user only. Then fill out the User email field.

  7. Click Create.

  8. AI Platform Notebooks creates a new instance for you with the options that you selected and the name that you provided.

    Notebook created

Determine who has access to the JupyterLab instance

Unless you granted access to a specific service account or a single user, anyone that has editor permissions to your GCP project can access the notebook.

If you granted access to a specific service account, anyone who has access to that service account can access the JupyterLab instance. Note that you will not have access to the JupyterLab instance unless you also have access to the specified service account.

If you granted access to a single user, that user is the only one who has access to the JupyterLab instance. Note that you will not have access yourself.

Open a notebook

To open a notebook:

  1. Go to the AI Platform Notebooks page in the Google Cloud Platform Console.

    Go to the AI Platform Notebooks page

  2. Select Open JupyterLab for the instance that you want to open.

    Open JupyterLab

  3. AI Platform Notebooks directs you to a URL for your notebook instance. For example, https://18390f97483e752e-dot-datalab-vm-us-west1.googleusercontent.com/lab?.

Troubleshooting

If you encounter a problem when you create a notebook, see Troubleshooting notebooks for help with common issues.

Was this page helpful? Let us know how we did:

Send feedback about...

AI Platform Notebooks
Need help? Visit our support page.