Documentation sur Oracle Cloud Infrastructure

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

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

  1. Naviguez jusqu'au compartiment de votre choix.
  2. Créez un système de fichiers sous le service Stockage de fichiers OCI avec une exportation.
  3. Sélectionnez une cible de montage existante ou créez-en une nouvelle.
    Vous avez un système de fichiers, et une cible de montage a été créée.
  4. Configurer un réseau personnalisé.

    Vous pouvez créer un nouveau sous-réseau ou utiliser un sous-réseau existant. Assurez-vous que la cible de montage et le carnet 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 spécifié dans Configuration de règles de sécurité de réseau VCN pour le service de stockage de fichiers.
    Note

    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 ou des groupes de sécurité de réseau, ou en utilisant une combinaison des deux. Pour plus d'informations, voir Configuration de règles de sécurité de réseau VCN pour le service de stockage de fichiers.
    • Trafic entrant avec état sur les ports TCP 111, 2048, 2049 et 2050, et les ports UDP 111 et 2048.
    • Trafic sortant avec état des ports TCP sources 111, 2048, 2049 et 2050, et du port UDP source 111.

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

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

Création d'un carnet

Étapes de création d'un carnet.

  • 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. Dans la page des détails du projet, sélectionnez Créer une session de carnet. Si vous avez besoin d'aide pour trouver la liste des projets, voir Liste des projets.
    2. (Facultatif) Entrez un nom unique pour la session de carnet (255 caractères au maximum). Si vous ne fournissez pas de nom, un nom est automatiquement généré. Par exemple, datasciencenotebooksession20200108222435.
    3. (Facultatif) Entrez une description.
    4. (Facultatif) Modifiez la forme du service de calcul en sélectionnant Modifier la forme. Suivez ensuite ces étapes dans le panneau Sélectionner le service de calcul.
      1. Sélectionner un type d'instance.
      2. Sélectionnez une série de formes.
      3. Sélectionnez une des formes de calcul prises en charge dans la série.
      4. Sélectionnez la forme qui convient le mieux à l'utilisation souhaitée 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 de 1 Go ou une valeur correspondant au nombre d'OCPU, selon la valeur la plus élevée.

      5. Si vous utilisez des machines virtuelles à capacité extensible, activez/désactivez Burstable.
        Dans 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 %.
      6. Sélectionnez Sélectionner une forme.
    5. Entrez la taille de 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.
    6. Sélectionnez l'une des options suivantes pour configurer le type de réseau :

      • 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 à 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 que vous voulez utiliser, sélectionnez Changer de 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.

      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.

    7. Sélectionnez l'une des options suivantes pour configurer le type de point d'extrémité :

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

        Sélectionnez Changer de compartiment pour sélectionner le compartiment qui contient le VCN, le sous-réseau ou le point d'extrémité privé.

    8. (Facultatif) Pour utiliser des montages de stockage, sélectionnez +Add Montage de stockage.
      Assurez-vous d'avoir l'autorisation d'utiliser des montages de stockage.
      1. Sélectionnez un type de montage de stockage, OCI Object Storage ou OCI File Storage.
      2. Sélectionnez un compartiment contenant la ressource de stockage que vous voulez monter.
      3. Sélectionnez une des options suivantes :
        Stockage d'objets
        Si vous utilisez un réseau personnalisé :
        1. Créez la passerelle de service dans le réseau 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 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.

        Seau à 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 tiret ( - ) et le trait de soulignement ( _ ).

        Stockage de fichiers

        Cible de montage et chemin d'exportation à 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.
        Note

        Avant de monter un système de fichiers, vous devez configurer des règles de sécurité dans le sous-réseau VCN pour permettre 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 ou des groupes de sécurité de réseau, ou en utilisant une combinaison des deux. Pour plus d'informations, voir Configuration de règles de sécurité de réseau VCN pour le service de stockage de fichiers.
        • Trafic entrant avec état vers les ports TCP 111, 2048, 2049 et 2050, et les ports UDP 111 et 2048.
        • Trafic sortant avec état pour les ports TCP sources 111, 2048, 2049 et 2050, et le port UDP source 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 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 /mnt par défaut. Vous ne pouvez pas spécifier des 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 carnet.

    9. (Facultatif) Développez la section Configuration de l'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 par clé et valeur. Pour nommer des clés, voir Contraintes de paire de valeurs de clé.

      • Paramètres Git : Sélectionnez l'onglet et entrez jusqu'à trois URL publiques pour le référentiel Git. 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.

    10. (Facultatif) Dans la section Marqueurs, ajoutez un ou plusieurs marqueurs à <resourceType>. Si vous êtes autorisé à créer une ressource, vous disposez également des autorisations nécessaires pour appliquer des marqueurs de formulaire 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.
    11. (Facultatif) Pour voir les informations détaillées sur la session de carnet immédiatement après sa création, sélectionnez Voir la page des détails en cliquant sur Créer..
    12. 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 et API des 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 indicateurs et des options de variable 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.