Quickstart: Use the Cloud Console to create a user-managed notebooks instance

This page shows you how to use the Google Cloud Console to create, stop, start, reset, or delete a user-managed notebooks instance. This page also includes authentication steps for using JupyterLab to create a notebook file and directs you to the JupyterLab tutorials.

Before you begin

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.
  2. In the Google Cloud Console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Cloud project. Learn how to confirm that billing is enabled for your project.

  4. Enable the Notebooks API.

    Enable the API

  5. In the Google Cloud Console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  6. Make sure that billing is enabled for your Cloud project. Learn how to confirm that billing is enabled for your project.

  7. Enable the Notebooks API.

    Enable the API

Create an instance

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

    Go to Notebooks

  2. On the User-managed notebooks tab, click  New notebook.

  3. For Notebook name, type my-instance.

  4. Click Create.

When you finish this tutorial, you can avoid continued billing by deleting the resources you created. For more information, see Clean up.

Open JupyterLab

After you create your instance, Vertex AI Workbench automatically starts the instance. When the instance is ready to use, Vertex AI Workbench activates an Open JupyterLab link.

  1. Next to your user-managed notebooks instance's name, click Open JupyterLab.

    Your user-managed notebooks instance opens JupyterLab.

Open a new notebook file

  1. Select File > New > Notebook.

  2. In the Select Kernel dialog, select Python 3, and then click Select.

  3. Your new notebook file opens.

Change the kernel

You can change the kernel of your JupyterLab notebook file from the menu or in the file.

  1. In JupyterLab, on the Kernel menu, click Change kernel.

  2. In the Select Kernel dialog, select another kernel to use and then click Select.

In the file

  1. In your JupyterLab notebook file, click the kernel name.

    The current kernel.

  2. In the Select Kernel dialog, select another kernel to use and then click Select.

Stop your instance

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

    Go to Notebooks

  2. On the User-managed notebooks tab, select the instance that you would like to stop.

  3. Click  Stop.

Start your instance

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

    Go to Notebooks

  2. On the User-managed notebooks tab, select the instance that you would like to start.

  3. Click  Start.

Reset your instance

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

    Go to Notebooks

  2. On the User-managed notebooks tab, select the instance that you would like to reset.

  3. Click  Reset.

Clean up

To avoid incurring charges to your Google Cloud account for the resources used on this page, follow these steps.

Delete the instance

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

    Go to Notebooks

  2. On the User-managed notebooks tab, select the instance that you would like to delete.

  3. Click  Delete.

Delete the project

If you used resources outside of your user-managed notebooks instance, you might want to delete your project to avoid incurring further charges.

  1. In the Cloud Console, go to the Manage resources page.

    Go to Manage resources

  2. In the project list, select the project that you want to delete, and then click Delete.
  3. In the dialog, type the project ID, and then click Shut down to delete the project.

What's next