Create a user-managed notebooks instance by using a custom container

You can create a user-managed notebooks instance based on a custom container. Using a custom container lets you customize a user-managed notebooks environment for your specific needs. The container must be accessible to your Google Cloud service account and expose a service on port 8080. We recommend creating a container derived from a Deep Learning Containers image, because those images are already configured to be compatible with user-managed notebooks.

Before you begin

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

Make sure you have a custom container that is accessible to your Google Cloud service account. Complete Creating a derivative container to learn how to create a custom container from a Deep Learning Containers image.

Create an instance using a custom container

To create a user-managed notebooks instance using a custom container, follow these steps:

  1. In the Google Cloud Console, go to the Notebooks page.

    Go to Notebooks page

  2. Make sure the User-managed notebooks tab is selected.

  3. Click  New notebook, and then select Customize instance.

  4. 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.
  5. In the Environment section, on the Environment drop-down menu, select Custom container.

  6. In the Docker container image field, enter the image you want to use in the format gcr.io/PROJECT_NAME/ IMAGE_NAME. Remember that your custom container must be accessible to your Google Cloud service account. If you don't yet have a custom container of your own, you can use one of the available deep learning container images.

  7. Make the rest of your selections, or leave them on their default setting. For more information on these settings, see Create a new notebook and specify your instance options.

  8. Click Create.

  9. Vertex AI Workbench creates a new user-managed notebooks instance for you based on your custom container.

What's next