Création d'une session de bloc-notes
Créez une session de bloc-notes Data Science pour accéder à une interface JupyterLab qui utilise une configuration réseau, de stockage et de calcul personnalisable.
Avant de commencer
Pour utiliser une configuration d'exécution, identifiez les variables d'environnement personnalisées et les URL de référentiel Git que vous souhaitez utiliser.
La configuration réseau d'une session de bloc-notes ne peut pas être modifiée lorsque la session de bloc-notes est réactivée. Si une session de bloc-notes a été configurée pour utiliser un réseau par défaut, vous ne pouvez pas désactiver la session de bloc-notes, puis sélectionner un réseau personnalisé lorsque vous la réactivez.
Configuration réseau pour l'utilisation des fonctionnalités gérées par Oracle
Pour utiliser l'une des fonctionnalités gérées par Oracle dans le bloc-notes, les scripts de cycle de vie de bloc-notes, les actions rapides AI, l'explorateur d'environnement et les exemples de bloc-notes, le sous-réseau de bloc-notes doit disposer des droits d'accès à OCI Object Storage.
Si vous sélectionnez Networking par défaut pour votre bloc-notes, le sous-réseau de votre bloc-notes a accès à Object Storage. Si vous sélectionnez Custom Networking, vous devez configurer l'accès Object Storage avec Service Gateway ou Nat Gateway. Vous pouvez configurer Service Gateway pour accéder à tous les services ou à Object Storage propre à une région. Pour plus d'informations, reportez-vous à Création d'une passerelle de service et à Présentation des passerelles de service dans la documentation Networking. Ou, vous pouvez configurer la passerelle Nat pour autoriser l'accès Internet public. Pour plus d'informations, reportez-vous à Passerelle NAT dans la documentation Networking.
Si vous utilisez la passerelle Internet, vous ne pouvez pas vous connecter au réseau Internet public avec votre bloc-notes. En effet, la passerelle Internet s'attend à ce que les ressources qu'elle contient soient un sous-réseau public avec des adresses IP publiques que les blocs-notes Data Science n'utilisent pas. Le bloc-notes ne fonctionnera pas non plus avec la connexion aux fonctionnalités gérées par Oracle.
Configuration de montages de stockage
Pour utiliser les montages de stockage, vous devez disposer d'un bucket Object Storage ou d'une cible de montage et d'un chemin d'export OCI File Storage Service (FSS).
Pour utiliser FSS, vous devez d'abord créer le système de fichiers et le point de montage. Utilisez l'option de mise en réseau personnalisée et vérifiez que la cible de montage et le bloc-notes sont configurés avec le même sous-réseau. Configurez les règles de liste de sécurité pour le sous-réseau avec les ports et protocoles spécifiques.
Assurez-vous que les limites de service sont allouées au nombre de systèmes de fichiers et au nombre de cibles de montage.
Vous devez configurer des stratégies pour utiliser Object Storage ou File Storage Service (FSS) pour les montages de stockage dans le bloc-notes.
Utilisation d'OCI File Storage
Configurez des montages de stockage lorsque vous utilisez OCI File Storage.
Configuration de montages de stockage
Utilisation d'OCI Object Storage
Configurez des montages de stockage lors de l'utilisation d'OCI Object Storage.
Les montages de stockage pour Object Storage utilisent l'autorisation basée sur des principaux de ressource pour communiquer entre le bloc-notes et le bucket requis.
Pour utiliser l'option réseau par défaut pour un bloc-notes, la sortie gérée fonctionne sans qu'il soit nécessaire de configurer des règles réseau supplémentaires.
Pour utiliser l'option réseau personnalisée pour un bloc-notes, une configuration réseau supplémentaire est requise.
Configuration de montages de stockage
- Dans le choix de votre VCN, créez la passerelle de service.
-
Pour le sous-réseau privé requis, ajoutez
Service Gatewayaux configurations de table de routage. - Modifiez les règles sortantes de la liste de sécurité du sous-réseau requis pour autoriser le trafic vers tous les services du réseau Oracle régional.
à l'aide de la console, de la CLI ou d'API
Nous vous recommandons de consulter Persistance des données et des fichiers sur le volume des blocs de la session de bloc-notes pour déterminer la taille des volumes de blocs.
1. Informations de base
Modifiez éventuellement les informations d'identification.
- Compartiment : sélectionnez le compartiment dans lequel créer la session de bloc-notes.
- Nom (Facultatif) : entrez un nom unique pour la session du bloc-notes (limite de 255 caractères). Si vous n'indiquez aucun nom, un nom est automatiquement généré. Par exemple,
datasciencenotebooksession20200108222435. - Balises (facultatif) : ajoutez des balises à la session de bloc-notes. Si vous disposez des droits d'accès nécessaires pour créer une ressource, vous disposez également de droits d'accès permettant d'appliquer des balises à format libre à cette ressource. To apply a defined tag, you must have permissions to use the tag namespace. Pour plus d'informations sur le balisage, reportez-vous à Balises de ressource. Si vous n'êtes pas certain d'appliquer des balises, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des balises ultérieurement.
2. Configuration
Indiquez la configuration réseau et la forme de calcul.
- Forme (facultatif) : modifiez la forme de calcul en sélectionnant Modifier la forme. Ensuite, suivez ces étapes dans le panneau Sélectionner une forme de calcul.
- Sélectionner un type d'instance.
- Sélectionnez une série de formes.
- Sélectionnez l'une des formes de calcul prises en charge de la série. Sélectionnez la forme qui convient Le mieux à l'utilisation de la ressource.
- Développez la forme sélectionnée pour configurer les OCPU et la mémoire.
- Nombre d'OCPU
- Montant de mémoire (Go) : pour chaque OCPU, sélectionnez jusqu'à 64 Go de mémoire et un total maximal de 512 Go. La quantité minimale de mémoire autorisée est 1 Go ou une valeur correspondant au nombre d'OCPU, la valeur la plus élevée étant retenue.
- Activer la forme éclatable : sélectionnez cette option si vous utilisez des machines virtuelles éclatables, puis, pour Utilisation de référence par OCPU, sélectionnez le pourcentage d'OCPU que vous souhaitez généralement utiliser. Les valeurs prises en charge sont 12,5 % et 50 %. (Pour les déploiements de modèle, seule la valeur de 50 % est prise en charge.)
- Sélectionnez Sélectionner une forme.
- Taille de stockage de blocs : entrez la taille de stockage de blocs à utiliser, entre 50 Go et 10, 240 Go (10 To). Vous pouvez modifier cette valeur par incrément de 1 Go. Par défaut, cette valeur est 100 Go.
- Type de réseau : sélectionnez l'option appropriée.
-
Mise en réseau par défaut : la charge de travail est attachée à l'aide d'une carte d'interface réseau virtuelle secondaire à un VCN et un sous-réseau préconfigurés et gérés par le service. Ce sous-réseau fourni autorise la sortie vers le réseau Internet public via une passerelle NAT et l'accès à d'autres services Oracle Cloud via une passerelle de service.
Si vous avez besoin d'accéder uniquement au réseau Internet public et aux services OCI, nous vous recommandons d'utiliser cette option. Il n'est pas nécessaire de créer des ressources réseau ni d'écrire des stratégies pour les droits d'accès réseau.
-
Mise en réseau personnalisée : sélectionnez le VCN et le sous-réseau (dans le compartiment indiqué) à utiliser pour la ressource (session de bloc-notes ou travail).
Pour l'accès sortant au réseau Internet public, utilisez un sous-réseau privé doté d'un routage vers une passerelle NAT.
Si vous ne voyez pas le VCN ou le sous-réseau à utiliser, sélectionnez un autre compartiment.
Important
Pour utiliser un montage de stockage de fichiers, vous devez sélectionner un réseau personnalisé. Le VCN et le sous-réseau doivent être identiques à ceux utilisés pour la création de la cible de montage.
Remarque
La configuration réseau d'une session de bloc-notes ne peut pas être modifiée lorsque la session de bloc-notes est réactivée. Si une session de bloc-notes a été configurée pour utiliser un réseau par défaut, vous ne pouvez pas désactiver la session de bloc-notes, puis sélectionner un réseau personnalisé lorsque vous la réactivez. -
- Type d'adresse : sélectionnez l'option appropriée.
- Adresse publique : accès aux données d'une instance gérée en dehors d'un VCN.
- Adresse privée : sélectionnez le VCN, le sous-réseau et l'adresse privée (dans le compartiment indiqué) à utiliser pour la session de bloc-notes.
3. Configuration supplémentaire
Vous pouvez éventuellement ajouter des montages de stockage, une configuration d'exécution et des balises.
Remarque
Pour les montages de stockage, assurez-vous que vous disposez de l'autorisation d'utilisation des montages de stockage.- Montages de stockage de fichiers (facultatif) : sélectionnez Ajouter un montage de stockage de fichiers et entrez les informations suivantes.
- Compartiment : sélectionnez le compartiment qui contient la cible à monter.
- Cible de montage : cible de montage à utiliser.
- Chemin d'export : chemin d'export à utiliser.
- Chemin et répertoire de destination : entrez le chemin à utiliser pour le montage du stockage.
Le chemin doit commencer par un caractère alphanumérique. Le répertoire de destination doit être unique dans les montages de stockage fournis. Les caractères autorisés sont les caractères alphanumériques, le tiret ( - ) et le trait de soulignement ( _ ).
Vous pouvez indiquer le chemin d'accès complet, par exemple
/opc/storage-directory. Si seul un répertoire est spécifié, tel que/storage-directory, il est monté sous le répertoire/mntpar défaut. Vous ne pouvez pas indiquer de répertoires propres au système d'exploitation, tels que/binou/etc.
- Montages de stockage d'objet (facultatif) : sélectionnez Ajouter un montage de stockage d'objet et entrez les informations suivantes.
- Compartiment : sélectionnez le compartiment qui contient le bucket à monter.
- Bucket : sélectionnez le bucket à utiliser.
- Préfixe de nom d'objet (facultatif) : préfixe de nom d'objet. Le préfixe doit commencer par un caractère alphanumérique. Les caractères autorisés sont les caractères alphanumériques, la barre oblique ( / ), le trait d'union ( - ) et le trait de soulignement ( _ ).
- Chemin et répertoire de destination : entrez le chemin à utiliser pour le montage du stockage.
Le chemin doit commencer par un caractère alphanumérique. Le répertoire de destination doit être unique dans les montages de stockage fournis. Les caractères autorisés sont les caractères alphanumériques, le tiret ( - ) et le trait de soulignement ( _ ).
Vous pouvez indiquer le chemin complet, tel que
/opc/storage-directory. Si seul un répertoire est indiqué, tel que/storage-directory, il est monté sous le répertoire/mntpar défaut. Vous ne pouvez pas indiquer de répertoires spécifiques au système d'exploitation, tels que/binou/etc.
Remarque
Si vous utilisez des fonctions de réseau personnalisées :- Créez la passerelle de service dans le VCN.
- Pour les configurations de table de routage dans le sous-réseau privé, ajoutez la passerelle de service.
- Modifiez les règles sortantes de la liste de sécurité du sous-réseau requis pour autoriser le trafic vers tous les services du réseau.
- Configuration d'exécution (facultatif) : définissez des variables d'environnement personnalisées (paires clé-valeur) et des paramètres Git.
- Paires de valeurs de clé : sélectionnez Ajouter une paire de valeurs de clé et entrez une clé et une valeur. Jusqu'à 30 paires clé-valeur peuvent être ajoutées. Pour nommer les clés, reportez-vous à contraintes de paire de valeurs de clé.
- Paramètres Git : sélectionnez Ajouter un paramètre Git et entrez une URL de référentiel Git publique. Vous pouvez ajouter jusqu'à 3 référentiels Git. Vérifiez le nombre et la taille des URL dans les contraintes de référentiel Git.Conseil
Vous pouvez utiliser l'exemple de référentiel ADS pour créer rapidement un référentiel Git pour un bloc-notes que vous pouvez utiliser lorsque vous l'ouvrez dans JupyterLab. Reportez-vous à https://github.com/oracle/accelerated-data-science.git.
- Balises (facultatif) : ajoutez des balises à la session de bloc-notes. Si vous disposez des droits d'accès nécessaires pour créer une ressource, vous disposez également de droits d'accès permettant d'appliquer des balises à format libre à cette ressource. Pour appliquer une balise defined, vous devez disposer des droits d'accès permettant d'utiliser l'espace de noms de balise. Pour plus d'informations sur le balisage, reportez-vous à Balises de ressource. Si vous n'êtes pas certain d'appliquer des balises, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des balises ultérieurement.
4. Vérifier et Créer
Vérifiez la configuration, puis sélectionnez Créer.
La page Sessions de bloc-notes s'ouvre. Une fois que la session du bloc-notes a été créée, son statut devient Actif et vous pouvez ouvrir la session. L'action Créer une session de bloc-notes est asynchrone et lance une demande de travail. Vous pouvez utiliser la demande de travail pour suivre le statut de l'opération.
Pour plus d'informations générales sur l'utilisation des demandes de travail dans OCI, reportez-vous àDemandes de travail.
Utilisez les commandes oci data-science bloc-notes-session create et les paramètres requis pour créer une session de bloc-notes dans un compartiment :
oci data-science notebook-session create --compartment-id <compartment-id>, -c [<name>], -c [<project-id>] ... [OPTIONS]Pour obtenir la liste complète des paramètres et des valeurs des commandes de la CLI, reportez-vous à la référence des commandes de la CLI.
Exécutez l'opération CreateNotebookSession pour créer une session de bloc-notes.