Création d'une session de carnet
Créez une session de carnet du service de science des données pour accéder à une interface JupyterLab qui utilise une configuration de calcul, de stockage et de réseau 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 à utiliser.
La configuration réseau d'une session de carnet ne peut pas être modifiée lorsque la session de carnet est réactivée. Si une session de carnet a été configurée pour utiliser un réseau par défaut, vous ne pouvez pas désactiver la session de carnet, puis sélectionner un réseau personnalisé lors de sa réactivation.
Configuration du réseau pour l'utilisation des fonctions gérées d'Oracle
Pour utiliser l'une des fonctions gérées par Oracle dans le carnet, les scripts de cycle de vie des carnets, les actions rapides d'intelligence artificielle, l'explorateur d'environnements et les exemples de carnets, le sous-réseau de carnets doit être autorisé à accéder au stockage d'objets OCI.
Si vous sélectionnez Réseau par défaut pour votre carnet, votre sous-réseau de carnets a accès au stockage d'objets. Si vous sélectionnez Réseau personnalisé, 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 à une région particulière d'Object Storage. Pour plus d'informations, voir Création d'une passerelle de service et Aperçu des passerelles de service dans la documentation sur le service de réseau. Ou, vous pouvez configurer la passerelle Nat pour autoriser l'accès à Internet public. Pour plus d'informations, consultez Nat Gateway dans la documentation sur le service de réseau.
Si vous utilisez la passerelle Internet, vous ne pouvez pas vous connecter à l'Internet public avec votre carnet. En effet, la passerelle Internet s'attend à ce que les ressources derrière elle soient un sous-réseau public avec des adresses IP publiques que les carnets du service de science des données n'utilisent pas. Le bloc-notes ne fonctionnera pas non plus avec la connexion aux fonctions gérées par Oracle.
Configuration des montages de stockage
Pour utiliser des montages de stockage, vous devez avoir une cible de montage et un chemin d'exportation pour le seau de stockage d'objets ou le service de stockage de fichiers pour OCI.
Pour utiliser FSS, vous devez d'abord créer le système de fichiers et le point de montage. Utilisez l'option de réseau personnalisé et assurez-vous que la cible de montage et le carnet 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 affectées à file-system-count et mount-target-count.
Vous devez configurer des politiques pour utiliser le service de stockage d'objets ou le service de stockage de fichiers (FSS) pour les montages de stockage dans le carnet.
Utilisation du service de stockage de fichiers pour OCI
Configurer les montages de stockage lors de l'utilisation du service de stockage de fichiers OCI.
Définition des montages de stockage
Utilisation du service de stockage d'objets pour OCI
Configurer les montages de stockage lors de l'utilisation du service de stockage d'objets pour OCI.
Les montages de stockage pour le stockage d'objets utilisent l'autorisation basée sur des principaux de ressource pour communiquer entre le carnet et le seau requis.
Pour utiliser l'option de réseau par défaut pour un carnet, le trafic sortant géré fonctionne sans avoir à configurer des règles de réseau supplémentaires.
Pour utiliser l'option de réseau personnalisé pour un carnet, une configuration réseau supplémentaire est requise.
Définition des 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 de trafic sortant 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.
Utilisation de la console, de l'interface de ligne de commande ou de l'API
Nous vous recommandons de voir Conservation des données et des fichiers sur un volume par blocs de la session de carnet pour vous aider à déterminer la taille du volume par blocs.
1. Informations de base
Modifiez éventuellement les informations d'identification.
- Compartiment : Sélectionnez le compartiment dans lequel créer la session de carnet.
- Nom (facultatif) : Entrez un nom unique pour la session de carnet (255 caractères au maximum). Si vous n'indiquez pas de nom, un nom est automatiquement généré. Par exemple,
datasciencenotebooksession20200108222435. - Marqueurs (Facultatif) : Ajoutez des marqueurs à la session de carnet. Si vous êtes autorisé à créer une ressource, vous pouvez également appliquer des marqueurs à structure libre à cette ressource. Pour appliquer un marqueur défini, vous devez être autorisé à utiliser l'espace de noms de marqueur. Pour plus d'informations sur le marquage, voir Marqueurs de ressource. Si vous ne savez pas si vous devez appliquer des marqueurs, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des marqueurs plus tard.
2. Configuration
Spécifiez la forme de calcul et la configuration de réseau.
- Forme (Facultatif) : Modifiez la forme du service de calcul en sélectionnant Modifier la forme. Suivez ensuite 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 une des formes de calcul prises en charge dans la série. Sélectionnez la forme qui convient le mieux à l'utilisation souhaitée 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 de 1 Go ou une valeur correspondant au nombre d'OCPU, selon la valeur la plus élevée.
- Activer la forme extensible : Sélectionnez cette option si vous utilisez des machines virtuelles extensibles, puis pour Utilisation de référence par OCPU, sélectionnez le pourcentage d'OCPU que vous voulez 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 du stockage par blocs : Entrez la taille du stockage par blocs à utiliser, comprise entre 50 Go et 10, 240 Go (10 To). Vous pouvez modifier la valeur par incréments de 1 Go. La valeur par défaut est 100 Go.
- Type de réseau : Sélectionnez l'option pertinente.
-
Réseau par défaut — La charge de travail est attachée à l'aide d'une carte VNIC secondaire à un VCN et à un sous-réseau préconfigurés gérés par le service. Ce sous-réseau permet le trafic sortant vers l'Internet public au moyen d'une passerelle NAT et l'accès à d'autres services Oracle Cloud au moyen d'une passerelle de service.
Si vous avez besoin d'un accès uniquement à l'Internet public et aux services OCI, nous vous recommandons d'utiliser cette option. Vous n'avez pas besoin de créer des ressources de réseau ni d'écrire des politiques pour les autorisations de réseau.
-
Réseau personnalisé — Sélectionnez le VCN et le sous-réseau (dans le compartiment indiqué) à utiliser pour la ressource (session de carnet ou tâche).
Pour l'accès sortant à l'Internet public, utilisez un sous-réseau privé avec une route 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.
Note
La configuration réseau d'une session de carnet ne peut pas être modifiée lorsque la session de carnet est réactivée. Si une session de carnet a été configurée pour utiliser un réseau par défaut, vous ne pouvez pas désactiver la session de carnet, puis sélectionner un réseau personnalisé lors de sa réactivation. -
- Type de point d'extrémité : Sélectionnez l'option pertinente.
- Point d'extrémité public — Accès aux données dans une instance gérée à partir d'un VCN.
- Point d'extrémité privé — Sélectionnez le VCN, le sous-réseau et le point d'extrémité privé (dans le compartiment indiqué) à utiliser pour la session de carnet.
3. Configuration supplémentaire
Facultativement, ajoutez des montages de stockage, une configuration d'exécution et des marqueurs.
Note
Pour les montages de stockage, assurez-vous d'avoir l'autorisation d'utiliser les 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'exportation : Chemin d'exportation à 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 parmi 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 spécifier le chemin complet, par exemple
/opc/storage-directory. Si seul un répertoire est spécifié, par exemple/storage-directory, il est monté sous le répertoire/mntpar défaut. Vous ne pouvez pas spécifier des répertoires propres au système d'exploitation, tels que/binou/etc.
- Montages de stockage d'objets (Facultatif) : Sélectionnez Ajouter un montage de stockage d'objets et entrez les informations suivantes.
- Compartiment : Sélectionnez le compartiment contenant le seau à monter.
- Seau : Sélectionnez le seau à 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 tiret ( - ) 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 parmi 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 spécifier le chemin complet, par exemple
/opc/storage-directory. Si seul un répertoire est spécifié, par exemple/storage-directory, il est monté sous le répertoire/mntpar défaut. Vous ne pouvez pas spécifier des répertoires propres au système d'exploitation, tels que/binou/etc.
Note
Si vous utilisez un réseau personnalisé :- Créez la passerelle de service dans le réseau VCN.
- Pour les configurations de table de routage dans le sous-réseau privé, ajoutez la passerelle de service.
- Modifiez les règles de trafic sortant de la liste de sécurité du sous-réseau requis pour autoriser le trafic vers tous les services du réseau.
- Configuration de l'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 des clés, voir 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. Jusqu'à 3 référentiels Git peuvent être ajoutés. Consultez les contraintes du référentiel Git pour connaître le nombre et la taille des URL.Conseil
Vous pouvez utiliser l'exemple de référentiel ADS pour créer rapidement un référentiel Git pour un carnet que vous pouvez utiliser lorsque vous l'ouvrez dans JupyterLab. Consultez la page https://github.com/oracle/accelerated-data-science.git.
- Marqueurs (Facultatif) : Ajoutez des marqueurs à la session de carnet. Si vous êtes autorisé à créer une ressource, vous pouvez également appliquer des marqueurs à structure libre à cette ressource. Pour appliquer un marqueur défini, vous devez être autorisé à utiliser l'espace de noms de marqueur. Pour plus d'informations sur le marquage, voir Marqueurs de ressource. Si vous ne savez pas si vous devez appliquer des marqueurs, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des marqueurs plus tard.
4. Vérifier et créer
Vérifiez la configuration, puis sélectionnez Créer.
La page des sessions de carnet s'ouvre. Lorsque la session de carnet est créée, son statut devient Actif et vous pouvez l'ouvrir. L'action Créer une session de carnet est asynchrone et démarre une demande de travail. Vous pouvez utiliser la demande de travail pour effectuer le suivi du statut d'une opération.
Pour des informations générales concernant l'utilisation des demandes de travail dans OCI, voir Demandes de travail.
Utilisez les commandes oci data-science notebook-session create et les paramètres requis pour créer une session de carnet dans un compartiment :
oci data-science notebook-session create --compartment-id <compartment-id>, -c [<name>], -c [<project-id>] ... [OPTIONS]Pour la liste complète des paramètres et des valeurs pour les commandes de l'interface de ligne de commande, voir Informations de référence sur les commandes de l'interface de ligne de commande.
Exécutez l'opération CreateNotebookSession pour créer une session de carnet.