Notizbuchsession erstellen
Erstellen Sie eine Data Science-Notizbuchsession, um auf eine JupyterLab-Schnittstelle zuzugreifen, die eine anpassbare Compute-, Speicher- und Netzwerkkonfiguration verwendet.
Bevor Sie beginnen
Um eine Laufzeitkonfiguration zu verwenden, identifizieren Sie die benutzerdefinierten Umgebungsvariablen und Git-Repository-URLs, die Sie verwenden möchten.
Die Netzwerkkonfiguration einer Notizbuchsession kann nicht geändert werden, wenn die Notizbuchsession erneut aktiviert wird. Wenn eine Notizbuchsession für die Verwendung eines Standardnetzwerks konfiguriert wurde, können Sie die Notizbuchsession nicht deaktivieren und dann benutzerdefiniertes Networking auswählen, wenn Sie sie erneut aktivieren.
Netzwerksetup für die Verwendung von Oracle Managed Features
Um eine der von Oracle verwalteten Features in Notizbuch, Notizbuchlebenszyklusskripten, KI-Schnellaktionen, Umgebungs-Explorer und Beispielnotizbüchern verwenden zu können, muss das Notizbuchsubnetz über Berechtigungen für den Zugriff auf OCI Object Storage verfügen.
Wenn Sie "Standardnetzwerk" für Ihr Notizbuch auswählen, hat Ihr Notizbuchsubnetz Zugriff auf Object Storage. Wenn Sie "Benutzerdefiniertes Networking" auswählen, müssen Sie den Object Storage-Zugriff mit dem Servicegateway oder Nat-Gateway einrichten. Sie können Servicegateway für den Zugriff auf alle Services oder regionsspezifischen Object Storage einrichten. Weitere Informationen finden Sie unter Servicegateway erstellen und Servicegateways - Überblick in der Networkingdokumentation. Sie können auch das Nat-Gateway einrichten, um den öffentlichen Internetzugang zu ermöglichen. Weitere Informationen finden Sie unter Nat-Gateway in der Networking-Dokumentation.
Wenn Sie Internet Gateway verwenden, können Sie mit Ihrem Notebook keine Verbindung zum öffentlichen Internet herstellen. Dies liegt daran, dass das Internetgateway erwartet, dass die dahinter stehenden Ressourcen ein öffentliches Subnetz mit öffentlichen IPs sind, die Data Science-Notizbücher nicht verwenden. Das Notebook wird auch nicht mit der Verbindung zu von Oracle verwalteten Features arbeiten.
Speichermounts einrichten
Um Speichermounts zu verwenden, benötigen Sie einen Objektspeicher-Bucket oder ein OCI File Storage Service-(FSS-)Mountziel und einen Exportpfad.
Um FSS verwenden zu können, müssen Sie zunächst das Dateisystem und den Einhängepunkt erstellen. Verwenden Sie die benutzerdefinierte Networkingoption, und stellen Sie sicher, dass das Mountziel und das Notizbuch mit demselben Subnetz konfiguriert sind. Konfigurieren Sie Sicherheitslistenregeln für das Subnetz mit den spezifischen Ports und Protokollen.
Stellen Sie sicher, dass Servicelimits File-System-count und Mount-Ziel-count zugewiesen werden.
Sie müssen Policys einrichten, um Object Storage oder File Storage Service (FSS) für Speichermounts im Notizbuch zu verwenden.
OCI File Storage verwenden
Richten Sie Speichermounts ein, wenn Sie OCI File Storage verwenden.
Speichermounts einrichten
OCI Object Storage verwendet
Richten Sie Speichermounts bei Verwendung von OCI Object Storage ein.
Storage-Mounts für Object Storage verwenden Ressourcen-Principals-basierte Autorisierung für die Kommunikation zwischen Notizbuch und dem erforderlichen Bucket.
Um die Standardnetzwerkoption für ein Notizbuch zu verwenden, funktioniert der verwaltete Egress, ohne dass zusätzliche Netzwerkregeln konfiguriert werden müssen.
Um die benutzerdefinierte Netzwerkoption für ein Notizbuch zu verwenden, ist ein weiteres Netzwerksetup erforderlich.
Speichermounts einrichten
- Erstellen Sie das Servicegateway nach Wahl des VCN.
-
Fügen Sie für das erforderliche private Subnetz
Service Gatewayzu den Routentabellenkonfigurationen hinzu. - Ändern Sie die Egress-Regeln der Sicherheitsliste des erforderlichen Subnetzes, um Traffic zu allen Services im regionalen Oracle-Netzwerk zuzulassen.
Konsole, CLI oder API verwenden
Wir empfehlen Ihnen, die Daten und Dateien auf dem Block-Volume einer Notizbuchsession persistieren zu lesen, um die Größe des Block-Volumes zu ermitteln.
1. Basisinformationen
Ändern Sie optional die Kennungsdaten.
- Compartment: Wählen Sie das Compartment aus, in dem die Notizbuchsession erstellt werden soll.
- Name (optional): Geben Sie einen eindeutigen Namen für die Notizbuchsession (maximal 255 Zeichen) ein. Wenn Sie keinen Namen angeben, wird automatisch ein Name generiert. Beispiel:
datasciencenotebooksession20200108222435. - Tags (optional): Fügen Sie der Notizbuchsession Tags hinzu. Wenn Sie über Berechtigungen zum Erstellen von Ressourcen verfügt, sind Sie auch berechtigt: Freiformtags auf diese Ressource anwenden. Um ein definiertes Tag anzuwenden, benötigen Sie Die Berechtigungen zum Verwenden des Tag-Namespace. Weitere Informationen zu Tagging finden Sie unter Ressourcentags. Wenn Sie nicht sicher sind, ob Tags angewendet werden sollen, überspringen Sie diese Option, oder fragen Sie einen Administrator. Sie können Tags später anwenden.
2. Konfiguration
Geben Sie die Compute-Ausprägung und das Networkingsetup an.
- Ausprägung (optional): Ändern Sie die Compute-Ausprägung, indem Sie Ausprägung ändern auswählen. Führen Sie anschließend die folgenden Schritte im Bereich Compute-Ausprägung auswählen aus.
- Wählen Sie einen Instanztyp aus.
- Wählen Sie eine Ausprägungsreihe aus.
- Wählen Sie eine der unterstützten Compute-Ausprägungen in der Reihe aus. Wählen Sie die Ausprägung, die am besten zur gewünschten Verwendung der Ressource passt.
- Blenden Sie die ausgewählte Ausprägung ein, um OCPUs und Arbeitsspeicher zu konfigurieren.
- Anzahl OCPUs
- Arbeitsspeicher (GB): Wählen Sie für jede OCPU bis zu 64 GB Arbeitsspeicher und maximal 512 GB Arbeitsspeicher aus. Der zulässige Mindestarbeitsspeicher ist entweder 1 GB oder ein Wert, der mit der Anzahl der OCPUs übereinstimmt, je nachdem, welcher Wert größer ist.
- Burstfähige Ausprägung aktivieren: Wählen Sie diese Option aus, wenn Sie burstfähige VMs verwenden, und wählen Sie unter Baselineauslastung pro OCPU den Prozentsatz der OCPUs aus, den Sie normalerweise verwenden möchten. Die unterstützten Werte lauten 12,5% und 50%. (Bei Modell-Deployments wird nur der Wert von 50% unterstützt.)
- Wählen Sie Ausprägung auswählen aus.
- Blockspeichergröße: Geben Sie die zu verwendende Blockspeichergröße zwischen 50 GB und 10, 240 GB (10 TB) ein. Sie können den Wert in 1-GB-Inkrementen ändern. Der Standardwert ist 100 GB.
- Netzwerktyp: Wählen Sie die entsprechende Option aus.
-
Standardmäßiges Networking: Die Workload wird mit einer sekundären VNIC an ein vorkonfiguriertes, serviceverwaltetes VCN und Subnetz angehängt. Dieses bereitgestellte Subnetz ermöglicht Egress-Traffic zum öffentlichen Internet über ein NAT-Gateway und Zugriff auf andere Oracle Cloud-Services über ein Servicegateway.
Wenn Sie nur Zugriff auf das öffentliche Internet und die OCI-Services benötigen, wird empfohlen, diese Option zu verwenden. Damit müssen Sie keine Netzwerkressourcen erstellen oder Policys für Netzwerkberechtigungen schreiben.
-
Benutzerdefiniertes Networking - Wählen sie das VCN und das Subnetz (aus dem angegebenen Compartment) aus, das Sie für die Ressource (Notizbuchsession oder Job) verwenden möchten.
Verwenden Sie für den Egress-Zugriff auf das öffentliche Internet ein privates Subnetz mit einer Route zu einem NAT-Gateway.
Wenn das gewünschte VCN oder Subnetz nicht angezeigt wird, wählen Sie ein anderes Compartment aus.
Wichtig
Um einen Dateispeichermount zu verwenden, müssen Sie ein benutzerdefiniertes Networking auswählen. VCN und Subnetz müssen mit denen identisch sein, die für die Erstellung des Mountziels verwendet werden.
Hinweis
Die Netzwerkkonfiguration einer Notizbuchsession kann nicht geändert werden, wenn die Notizbuchsession erneut aktiviert wird. Wenn eine Notizbuchsession für die Verwendung eines Standardnetzwerks konfiguriert wurde, können Sie die Notizbuchsession nicht deaktivieren und dann benutzerdefiniertes Networking auswählen, wenn Sie sie erneut aktivieren. -
- Endpunkttyp: Wählen Sie die entsprechende Option aus.
- Öffentlicher Endpunkt - Datenzugriff in einer verwalteten Instanz von außerhalb eines VCN.
- Privater Endpunkt - Wählen Sie das VCN, das Subnetz und den privaten Endpunkt (aus dem angegebenen Compartment) aus, das Sie für die Notizbuchsession verwenden möchten.
3. Zusätzliche Konfigurationsschritte
Fügen Sie optional Speichermounts, Laufzeitkonfiguration und Tags hinzu.
Hinweis
Stellen Sie bei Speichermounts sicher, dass Sie die Autorisierung zur Verwendung von Speichermounts haben.- Dateispeicher-Mounts (optional): Wählen Sie Dateispeicher-Mount hinzufügen aus, und geben Sie die folgenden Informationen ein.
- Compartment: Wählen Sie das Compartment mit dem Ziel aus, das Sie mounten möchten.
- Mountziel: Das Mountziel, das Sie verwenden möchten.
- Exportpfad: Der Exportpfad, den Sie verwenden möchten.
- Zielpfad und Verzeichnis: Geben Sie den Pfad ein, der zum Mounten des Speichers verwendet werden soll.
Der Pfad muss mit einem alphanumerischen Zeichen beginnen. Das Zielverzeichnis muss in allen angegebenen Speichermounts eindeutig sein. Die zulässigen Zeichen sind alphanumerische Zeichen, Bindestriche ( - ) und Unterstriche ( _ ).
Sie können den vollständigen Pfad angeben, z.B.
/opc/storage-directory. Wenn nur ein Verzeichnis angegeben wird, z.B./storage-directory, wird es unter dem Standardverzeichnis/mntgemountet. Sie können keine BS-spezifischen Verzeichnisse angeben, wie/binoder/etc.
- Object Storage-Mounts (optional): Wählen Sie Object Storage-Mount hinzufügen aus, und geben Sie die folgenden Informationen ein.
- Compartment: Wählen Sie das Compartment mit dem Bucket aus, den Sie mounten möchten.
- Bucket: Wählen Sie den Bucket aus, den Sie verwenden möchten.
- Objektnamenpräfix (optional): Objektnamenpräfix. Das Präfix muss mit einem alphanumerischen Zeichen beginnen. Die zulässigen Zeichen sind alphanumerische Zeichen, Schrägstriche ( / ), Bindestriche ( - ) und Unterstriche ( _ ).
- Zielpfad und Verzeichnis: Geben Sie den Pfad ein, der für das Mounten des Speichers verwendet werden soll.
Der Pfad muss mit einem alphanumerischen Zeichen beginnen. Das Zielverzeichnis muss in allen angegebenen Speichermounts eindeutig sein. Die zulässigen Zeichen sind alphanumerische Zeichen, Bindestriche ( - ) und Unterstriche ( _ ).
Sie können den vollständigen Pfad angeben, wie
/opc/storage-directory. Wenn nur ein Verzeichnis angegeben wird, wie/storage-directory, wird es unter dem Standardverzeichnis/mntgemountet. Sie können keine BS-spezifischen Verzeichnisse angeben, wie/binoder/etc.
Hinweis
Wenn Sie benutzerdefiniertes Networking verwenden:- Erstellen Sie das Servicegateway im VCN.
- Fügen Sie für die Routentabellenkonfigurationen im privaten Subnetz das Servicegateway hinzu.
- Ändern Sie die Egress-Regeln der Sicherheitsliste des erforderlichen Subnetzes, um Traffic zu allen Services im Netzwerk zuzulassen.
- Laufzeitkonfiguration (Optional): Definieren Sie benutzerdefinierte Umgebungsvariablen (Schlüssel/Wert-Paare) und Git-Einstellungen.
- Schlüsselwertpaare: Wählen Sie Schlüsselwertpaar hinzufügen aus, und geben Sie einen Schlüssel und einen Wert ein. Es können bis zu 30 Schlüsselwertpaare hinzugefügt werden. Informationen zum Benennen von Schlüsseln finden Sie unter Constraints für Schlüsselwertepaare.
- Git-Einstellungen: Wählen Sie Git-Einstellung hinzufügen aus, und geben Sie eine öffentliche Git-Repository-URL ein. Es können bis zu 3 Git-Repositorys hinzugefügt werden. Prüfen Sie die Git-Repository-Constraints auf Anzahl und Größe der URLs.Tipp
Mit dem ADS-Repository-Beispiel können Sie schnell ein Git-Repository für ein Notizbuch erstellen, das Sie verwenden können, wenn Sie es in JupyterLab öffnen. Siehe https://github.com/oracle/accelerated-data-science.git.
- Tags (optional): Fügen Sie der Notizbuchsession Tags hinzu. Wenn Sie über Berechtigungen zum Erstellen von Ressourcen verfügt, sind Sie auch berechtigt: Freiformtags auf diese Ressource anwenden. Um ein definiertes Tag anzuwenden, benötigen Sie Die Berechtigungen zum Verwenden des Tag-Namespace. Weitere Informationen zu Tagging finden Sie unter Ressourcentags. Wenn Sie nicht sicher sind, ob Tags angewendet werden sollen, überspringen Sie diese Option, oder fragen Sie einen Administrator. Sie können Tags später anwenden.
4. Prüfen und Erstellen
Prüfen Sie die Konfiguration, und wählen Sie Erstellen aus.
Die Seite "Notizbuchsessions" wird geöffnet. Wenn die Notizbuchsession erfolgreich erstellt wurde, wechselt der Status zu "Aktiv", und Sie können die Notizbuchsession öffnen Die Aktion "Notizbuchsession erstellen" ist asynchron und startet eine Arbeitsanforderung. Mit der Arbeitsanforderung können Sie den Status eines Vorgangs verfolgen.
Allgemeine Informationen zur Verwendung von Arbeitsanforderungen in OCI finden Sie unter Arbeitsanforderungen.
Verwenden Sie die Befehle oci data-science notebook-session create und die erforderlichen Parameter, um eine Notizbuchsession in einem Compartment zu erstellen:
oci data-science notebook-session create --compartment-id <compartment-id>, -c [<name>], -c [<project-id>] ... [OPTIONS]Eine vollständige Liste der Parameter und Werte für CLI-Befehle finden Sie in der CLI-Befehlsreferenz.
Führen Sie den Vorgang CreateNotebookSession aus, um eine Notizbuchsession zu erstellen.