Documentation Oracle Cloud Infrastructure

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.
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.

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 assurez-vous que la cible de montage et le bloc-notes sont configurés avec le même sous-réseau. Configurez des 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

  1. Accédez au compartiment de votre choix.
  2. Créez un système de fichiers sous le service OCI File Storage avec un export.
  3. Sélectionnez une cible de montage existante ou en créez une.
    Un système de fichiers, une cible d'export et de montage ont été créés.
  4. Configurer des fonctions de réseau personnalisées.

    Vous pouvez créer un sous-réseau ou en utiliser un existant. Assurez-vous que la cible de montage et le bloc-notes sont configurés avec le même sous-réseau.

  5. Configurez les règles de liste de sécurité du sous-réseau utilisé comme indiqué dans Configuration des règles de sécurité VCN pour File Storage.
    Remarque

    Avant de monter un système de fichiers, vous devez configurer des règles de sécurité dans le sous-réseau VCN pour autoriser le trafic réseau vers et depuis la cible de montage. Vous pouvez configurer des règles de sécurité dans des listes de sécurité de sous-réseau, des groupes de sécurité réseau ou en utilisant une combinaison des deux. Pour plus d'informations, reportez-vous à Configuration des règles de sécurité de réseaux cloud virtuels pour File Storage.
    • Entrée avec conservation de statut vers les ports TCP 111, 2048, 2049 et 2050, et les ports UDP 111 et 2048.
    • Sortie avec conservation de statut pour les ports source TCP 111, 2048, 2049 et 2050, et le port source UDP 111.

Utilisation d'OCI Object Storage

Configurez des montages de stockage lors de l'utilisation d'OCI Object Storage.

Les montages de stockage pour le stockage d'objets utilisent l'autorisation basée sur les 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

  1. Dans le choix de votre VCN, créez la passerelle de service.
  2. Pour le sous-réseau privé requis, ajoutez Service Gateway aux configurations de table de routage.
  3. 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.

Création d'un bloc-notes

Procédure de création d'un bloc-notes.

  • Nous vous recommandons de consulter Persistance des données et des fichiers dans un volume de blocs de session de bloc-notes afin de déterminer la taille du volume de blocs.

    1. Sur la page de détails du projet, sélectionnez Créer une session de bloc-notes. Si vous avez besoin d'aide pour trouver la liste des projets, reportez-vous à la rubrique Liste des projets.
    2. (Facultatif) Entrez un nom unique pour la session de bloc-notes (limite de 255 caractères). Si vous n'indiquez aucun nom, un nom est automatiquement généré. Par exemple : datasciencenotebooksession20200108222435.
    3. (Facultatif) Saisissez une description.
    4. (Facultatif) Modifiez la forme de calcul en sélectionnant Modifier la forme. Suivez les étapes ci-dessous dans le panneau Sélectionner un calcul.
      1. Sélectionner un type d'instance.
      2. Sélectionnez une série de formes.
      3. Sélectionnez l'une des formes de calcul prises en charge dans la série.
      4. Sélectionnez la forme qui convient le mieux à l'utilisation de la ressource.

        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.

      5. Sélectionnez Sélectionner une forme.
    5. Entrez la taille de stockage de blocs à utiliser, comprise entre 50 Go et 10, 240 Go (10 To). Vous pouvez modifier cette valeur par incrément de 1 Go. La valeur par défaut est 100 Go.
    6. Sélectionnez l'une des options suivantes pour configurer le type de réseau :

      • 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 que vous souhaitez 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 Modifier le compartiment, puis sélectionnez le compartiment qui contient le VCN ou le sous-réseau.

        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.

    7. Sélectionnez l'une des options suivantes pour configurer le type d'adresse :

      • 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 à utiliser pour la session de bloc-notes.

        Sélectionnez Modifier le compartiment pour sélectionner le compartiment qui contient le VCN, le sous-réseau ou l'adresse privée.

    8. (Facultatif) Pour utiliser des montages de stockage, sélectionnez Montage de stockage +Add.
      Assurez-vous que vous disposez de l'autorisation d'utilisation des montages de stockage.
      1. Sélectionnez un type de montage de stockage, OCI Object Storage ou OCI File Storage.
      2. Sélectionnez le compartiment qui contient la ressource de stockage à monter.
      3. Sélectionnez l'un des éléments suivants :
        Object Storage
        Si vous utilisez des fonctions de réseau personnalisées :
        1. Créez la passerelle de service dans le VCN.
        2. Pour les configurations de table de routage dans le sous-réseau privé, ajoutez la passerelle de service.
        3. 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.

        Bucket à utiliser.

        Vous pouvez ajouter un 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 ( _ ).

        File Storage

        Cible de montage et chemin d'export à utiliser. Vous devez avoir créé le système de fichiers. Spécifiez une cible de montage existante ou créez-en une nouvelle.

        Vous devez utiliser un réseau personnalisé pour utiliser le stockage de fichiers.

        Suivez les règles de liste de sécurité du sous-réseau.
        Remarque

        Avant de monter un système de fichiers, vous devez configurer des règles de sécurité dans le sous-réseau VCN pour autoriser le trafic réseau vers et depuis la cible de montage. Vous pouvez configurer des règles de sécurité dans des listes de sécurité de sous-réseau, des groupes de sécurité réseau ou en utilisant une combinaison des deux. Pour plus d'informations, reportez-vous à Configuration des règles de sécurité de réseaux cloud virtuels pour File Storage.
        • Entrée avec protection de l'état sur les ports TCP 111, 2048, 2049 et 2050, et les ports UDP de 111 et 2048.
        • Sortie avec conservation de statut pour les ports source TCP 111, 2048, 2049 et 2050, et UDP 111.
      4. Entrez le chemin sous lequel le stockage doit être monté.

        Le stockage est monté sous le chemin de montage spécifié. 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 trait d'union ( - ) 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 /mnt par défaut. Vous ne pouvez pas indiquer de répertoires propres au système d'exploitation, tels que /bin ou /etc.

      5. Sélectionnez Soumettre.

        Répétez ces étapes pour ajouter jusqu'à deux montages de stockage pour les sessions de bloc-notes.

    9. (Facultatif) Développez la section Configuration d'exécution pour définir des variables d'environnement personnalisées et des paramètres Git, comme suit :

      • Paires clé-valeur : sélectionnez l'onglet et entrez des variables d'environnement avec une clé et une valeur. Pour nommer les clés, reportez-vous à contraintes de paire de valeurs de clé.

      • Paramètres Git : sélectionnez l'onglet et entrez jusqu'à trois URL de référentiel Git publiques. Consultez les contraintes de 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 bloc-notes que vous pouvez utiliser lorsque vous l'ouvrez dans JupyterLab. Reportez-vous à https://github.com/oracle/accelerated-data-science.git.

    10. (Facultatif) Dans la section Balises, ajoutez des balises au <resourceType>. Si vous êtes autorisé à créer une ressource, vous disposez également des droits d'accès nécessaires pour lui appliquer des balises à forme libre. Pour appliquer une balise defined, vous devez être autorisé à utiliser la balise namespace. Pour plus d'informations sur le balisage, reportez-vous à Balises de ressource. Si vous n'êtes pas sûr d'appliquer des balises, ignorez cette option ou demandez à un administrateur. Vous pouvez appliquer des balises ultérieurement.
    11. (Facultatif) Pour afficher les détails de la session de bloc-notes juste après sa création, sélectionnez Afficher la page de détails en cliquant sur Créer.
    12. Sélectionnez Créer.
    La page Sessions de bloc-notes s'ouvre. Une fois la session de bloc-notes créée, son statut devient Actif et vous pouvez l'ouvrir. L'action de création de session de bloc-notes est asynchrone et démarre une demande de travail. Vous pouvez utiliser la demande de travail pour suivre le statut de l'opération. Pour obtenir des informations générales sur l'utilisation des demandes de travail dans OCI, reportez-vous à Demandes de travail et API de 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]

    Afin d'obtenir la liste complète des indicateurs et des options de variable pour les commandes d'interface de ligne de commande, reportez-vous à Référence de commande d'interface de ligne de commande.

  • Exécutez l'opération CreateNotebookSession pour créer une session de bloc-notes.