Creating a Notebook Session
Create a Data Science notebook session to access a JupyterLab interface that uses a customizable compute, storage, and network configuration.
Before you begin:
-
To use a runtime configuration, identify the custom environment variables and any Git repository URLs that you want you want to use.
-
To use storage mounts, you must have an Object Storage bucket or OCI File Storage Service (FSS) mount target and export path.
To use FSS, you must first create the file system and the mount point. Use the custom networking option and ensure that the mount target and the notebook are configured with the same subnet. Configure security list rules for the subnet with the specific ports and protocols.
Ensure that service limits are allocated to
file-system-count
andmount-target-count
.
The network configuration of a notebook session can't be changed when the notebook session is reactivated. If a notebook session was configured to use a default network, you can't deactivate the notebook session then select custom networking when you reactivate it.
Networking Setup for Using Oracle Managed Features
To use any of the Oracle managed features inside the Notebook, Notebook Lifecycle Scripts, AI QUick Actions, Environment Explorer and Example Notebooks, the Notebook subnet must have permissions to access OCI Object Storage.
If you choose Default Networking for your Notebook, your Notebook subnet has access to Object Storage. If you choose Custom Networking, you need to set up Object Storage access with either the Service Gateway or Nat Gateway. You can set up Service Gateway to access all services or region specific Object Storage. For more information, see Creating a Servcie Gateway and Overview of Service Gateways in the Networking documentation. Or, you can set up the Nat Gateway to allow public internet access. For more information, see Nat Gateway in the Networking documentation.
We recommend that you review Persisting Data and Files on a Notebook Session Block Volume to help decide the block volume size.
The notebook sessions page opens. When the notebook session is successfully created, the status turns to Active, and you can open the notebook session. The create notebook session action is asynchronous and starts a work request. You can use the work request to track the status of an operation. For general information about using work requests in OCI, see Work Requests and the Work Requests API. Use the oci data-science notebook-session create commands and required parameters to create a notebook session in a compartment:
oci data-science notebook-session create --compartment-id
<compartment-id>
, -c [<name>
], -c [<project-id>
] ... [OPTIONS]For a complete list of flags and variable options for CLI commands, see the CLI Command Reference.
Run the CreateNotebookSession operation to create a notebook session.