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:
In the Google Cloud Console, go to the Notebooks page.
Make sure the User-managed notebooks tab is selected.
ClickNew notebook, and then select Customize instance.
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.
In the Environment section, on the Environment drop-down menu, select Custom container.
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.
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.
Vertex AI Workbench creates a new user-managed notebooks instance for you based on your custom container.
- Read about how to push container images to Container Registry. If the container images you push to Container Registry are derived from a Deep Learning Containers image, you can use these container images in creating user-managed notebooks instances.
- Read Best practices for writing Dockerfiles to learn more about modifying your custom containers.