Documentazione dell'infrastruttura Oracle Cloud

Creazione di una sessione notebook

Creare una sessione notebook di Data Science per accedere a un'interfaccia JupyterLab che utilizza una configurazione di computazione, storage e rete personalizzabile.

Prima di iniziare:

Per utilizzare una configurazione runtime, identificare le variabili di ambiente personalizzate e gli eventuali URL del repository Git che si desidera utilizzare.
Nota

La configurazione di rete di una sessione notebook non può essere modificata quando la sessione notebook viene riattivata. Se una sessione notebook è stata configurata per utilizzare una rete predefinita, non è possibile disattivare la sessione notebook, quindi selezionare la rete personalizzata quando viene riattivata.

Impostazione della rete per l'utilizzo delle funzioni gestite da Oracle

Per utilizzare una qualsiasi delle funzioni gestite da Oracle all'interno del notebook, degli script del ciclo di vita del notebook, delle azioni rapide AI, di Environment Explorer e dei notebook di esempio, la subnet del notebook deve disporre delle autorizzazioni per accedere allo storage degli oggetti OCI.

Se si seleziona Rete predefinita per il notebook, la subnet del notebook ha accesso allo storage degli oggetti. Se selezioni Networking personalizzato, devi impostare l'accesso allo storage degli oggetti con Service Gateway o Nat Gateway. Puoi impostare Service Gateway per accedere a tutti i servizi o allo storage degli oggetti specifico dell'area geografica. Per ulteriori informazioni, vedere Creazione di un gateway di servizi e Panoramica dei gateway di servizi nella documentazione di Networking. Oppure, puoi impostare il Nat Gateway per consentire l'accesso a Internet pubblico. Per ulteriori informazioni, vedere Nat Gateway nella documentazione di Networking.

Se si utilizza il gateway Internet, non è possibile connettersi alla rete Internet pubblica con il notebook. Questo perché Internet Gateway si aspetta che le risorse dietro di esso siano una subnet pubblica con IP pubblici che i notebook di Data Science non utilizzano. Il notebook non funzionerà nemmeno con la connessione alle funzioni gestite da Oracle.

Impostazione degli accessi di storage

Per utilizzare gli accessi di storage, è necessario disporre di un bucket di storage degli oggetti o di una destinazione di accesso e di un percorso di esportazione FSS (File Storage Service) OCI.

Per usare FSS, occorre prima creare il file system e il punto di attivazione. Utilizzare l'opzione di rete personalizzata e assicurarsi che la destinazione di accesso e il notebook siano configurati con la stessa subnet. Configurare le regole dell'elenco di sicurezza per la sottorete con porte e protocolli specifici.

Assicurarsi che i limiti del servizio siano allocati a file system-count e mount-target-count.

È necessario impostare i criteri per utilizzare lo storage degli oggetti o il servizio FSS (File Storage Service) per gli accessi di storage nel notebook.

Uso dello storage di file OCI

Impostare gli accessi di storage quando si utilizza OCI File Storage.

Impostazione degli accessi di storage

  1. Passare al compartimento desiderato.
  2. Creare un file system nel servizio Storage di file OCI insieme a un'esportazione.
  3. Selezionare una destinazione di accesso esistente o crearne una nuova.
    È stato creato un file system, un'esportazione e una destinazione di accesso.
  4. Impostare la rete personalizzata.

    È possibile creare una nuova subnet o utilizzarne una esistente. Assicurarsi che la destinazione di accesso e il notebook siano configurati con la stessa subnet.

  5. Configurare le regole della lista di sicurezza della subnet utilizzata come specificato in Configurazione delle regole di sicurezza VCN per lo storage di file.
    Nota

    Prima di eseguire il MOUNT di un file system, è necessario configurare le regole di sicurezza nella subnet VCN per consentire il traffico di rete verso e dalla destinazione di accesso. È possibile impostare le regole di sicurezza nelle liste di sicurezza delle subnet, nei gruppi di sicurezza di rete o utilizzando una combinazione di entrambi. Per ulteriori informazioni, vedere Configurazione delle regole di sicurezza VCN per lo storage di file.
    • Ingresso con conservazione dello stato alle porte TCP 111, 2048, 2049 e 2050, nonché alle porte UDP 111 e 2048.
    • Uscita con conservazione dello stato per le porte di origine TCP 111, 2048, 2049 e 2050, nonché per la porta di origine UDP 111.

Uso dello storage degli oggetti OCI

Impostare gli accessi di storage quando si utilizza OCI Object Storage.

Gli accessi di storage per lo storage degli oggetti utilizzano le principal risorsa in base all'autorizzazione per comunicare tra il notebook e il bucket richiesto.

Per utilizzare l'opzione di rete predefinita per un notebook, l'uscita gestita funziona senza la necessità di configurare regole di rete aggiuntive.

Per utilizzare l'opzione di rete personalizzata per un notebook, è necessaria un'ulteriore configurazione di rete.

Impostazione degli accessi di storage

  1. Nella scelta della VCN, creare il gateway del servizio.
  2. Per la subnet privata richiesta, aggiungere Service Gateway alle configurazioni della tabella di instradamento.
  3. Modificare le regole di uscita della lista di sicurezza della subnet richiesta per consentire il traffico a tutti i servizi nella rete Oracle regionale.

Creazione di un notebook

La procedura per creare un notebook.

  • Si consiglia di rivedere la sezione Persistenza di dati e file in un volume a blocchi di una sessione notebook per determinare la dimensione del volume a blocchi.

    1. Nella pagina dei dettagli del progetto selezionare Crea sessione notebook. Per informazioni su come trovare l'elenco dei progetti, vedere Elenco dei progetti.
    2. (Facoltativo) Immettere un nome univoco per la sessione notebook (limite di 255 caratteri). Se non si specifica un nome, viene generato automaticamente un nome. Ad esempio datasciencenotebooksession20200108222435.
    3. (Facoltativo) Immettere una descrizione.
    4. (Facoltativo) Modificare la forma di computazione selezionando Modifica forma. Attenersi quindi alla procedura descritta di seguito nel pannello Select compute.
      1. Selezionare un tipo di istanza.
      2. Selezionare una serie di forme.
      3. Selezionare una delle forme di computazione supportate nella serie.
      4. Selezionare la forma più adatta a come si desidera utilizzare la risorsa.

        Per ciascuna OCPU, selezionare fino a 64 GB di memoria e un totale massimo di 512 GB. La quantità minima di memoria consentita è 1 GB o un valore corrispondente al numero di OCPU, a seconda di quale delle due è maggiore.

      5. Selezionare Seleziona forma.
    5. Immettere la dimensione di storage a blocchi da utilizzare, compresa tra 50 GB e 10, 240 GB (10 TB). È possibile modificare il valore con incrementi di 1 GB. Il valore predefinito è 100 GB.
    6. Selezionare una delle seguenti opzioni per configurare il tipo di rete:

      • Networking predefinito: il carico di lavoro viene collegato utilizzando una VNIC secondaria a una rete VCN e una subnet preconfigurata gestita dal servizio. Questa subnet fornita consente l'uscita alla rete Internet pubblica tramite un gateway NAT e l'accesso ad altri servizi Oracle Cloud tramite un gateway di servizi.

        Se hai bisogno di accedere solo alla rete Internet pubblica e ai servizi OCI, ti consigliamo di utilizzare questa opzione. Non richiede la creazione di risorse di rete o la scrittura di criteri per le autorizzazioni di rete.

      • Networking personalizzato: selezionare la VCN e la subnet che si desidera utilizzare per la risorsa (sessione o job del registro note).

        Per l'accesso in uscita alla rete Internet pubblica, utilizzare una subnet privata con un instradamento a un gateway NAT.

        Se non viene visualizzata la VCN o la subnet che si desidera utilizzare, selezionare Modifica compartimento, quindi selezionare il compartimento contenente la VCN o la subnet.

        Importante

        Per utilizzare un accesso di memorizzazione file, è necessario selezionare una rete personalizzata. La VCN e la subnet devono essere uguali a quelle utilizzate per la creazione della destinazione di accesso.

      Nota

      La configurazione di rete di una sessione notebook non può essere modificata quando la sessione notebook viene riattivata. Se una sessione notebook è stata configurata per utilizzare una rete predefinita, non è possibile disattivare la sessione notebook, quindi selezionare la rete personalizzata quando viene riattivata.

    7. Selezionare una delle opzioni riportate di seguito per configurare il tipo di endpoint.

      • Endpoint pubblico: accesso ai dati in un'istanza gestita dall'esterno di una VCN.

      • Endpoint privato: selezionare la VCN, la subnet e l'endpoint privato che si desidera utilizzare per la sessione notebook.

        Selezionare Modifica compartimento per selezionare il compartimento che contiene la VCN, la subnet o l'endpoint privato.

    8. (Opzionale) Per utilizzare le attivazioni dello storage, selezionare +Add mount dello storage.
      Assicurarsi di disporre dell'autorizzazione per utilizzare gli accessi di storage.
      1. Selezionare un tipo di accesso allo storage, OCI Object Storage o OCI File Storage.
      2. Selezionare un compartimento contenente la risorsa di storage di cui si desidera eseguire il MOUNT.
      3. Selezionare una delle seguenti opzioni:
        Storage degli oggetti
        Se si utilizza una rete personalizzata:
        1. Crea il gateway di servizi nella VCN.
        2. Per le configurazioni della tabella di instradamento nella subnet privata, aggiungere il gateway del servizio.
        3. Modificare le regole di uscita della lista di sicurezza della subnet richiesta per consentire il traffico a tutti i servizi della rete.

        Il bucket che si desidera usare.

        È possibile aggiungere un prefisso di nome oggetto. Il prefisso deve iniziare con un carattere alfanumerico. I caratteri consentiti sono alfanumerici, barra ( / ), trattino ( - ) e carattere di sottolineatura ( _ ).

        Storage file

        La destinazione di accesso e il percorso di esportazione che si desidera utilizzare. È necessario aver creato il file system. Specificare una destinazione di MOUNT esistente o crearne una nuova.

        Per utilizzare lo storage dei file è necessario utilizzare una rete personalizzata.

        Seguire le regole della lista di sicurezza della sottorete.
        Nota

        Prima di eseguire il MOUNT di un file system, è necessario configurare le regole di sicurezza nella subnet VCN in modo da consentire al traffico di rete da e verso la destinazione di accesso. È possibile impostare le regole di sicurezza nelle liste di sicurezza delle subnet, nei gruppi di sicurezza di rete o utilizzando una combinazione di entrambi. Per ulteriori informazioni, vedere Configurazione delle regole di sicurezza VCN per lo storage di file.
        • ingresso con conservazione dello stato alle porte TCP 111, 2048, 2049 e 2050, nonché le porte UDP 111 e 2048.
        • Uscita con conservazione dello stato per le porte di origine TCP 111, 2048, 2049 e 2050, nonché la porta di origine UDP 111.
      4. Immettere il percorso in cui eseguire il MOUNT dello storage.

        Lo storage viene attivato nel percorso di accesso specificato. Il percorso deve iniziare con un carattere alfanumerico. La directory di destinazione deve essere univoca negli accessi di storage forniti. I caratteri consentiti sono alfanumerici, trattino ( - ) e carattere di sottolineatura ( _ ).

        È possibile specificare il percorso completo, ad esempio /opc/storage-directory. Se viene specificata solo una directory, ad esempio /storage-directory, viene attivata nella directory /mnt predefinita. Non è possibile specificare directory specifiche del sistema operativo, ad esempio /bin o /etc.

      5. Selezionare Sottometti.

        Ripetere questi passi per aggiungere fino a due installazioni di storage per le sessioni notebook.

    9. (Facoltativo) Espandere la sezione Configurazione runtime per definire le variabili di ambiente personalizzate e le impostazioni Git, come indicato di seguito.
    10. (Facoltativo) Nella sezione Tag aggiungere una o più tag a <resourceType>. Se si dispone delle autorizzazioni per creare una risorsa, si dispone anche delle autorizzazioni per applicare le tag in formato libero a tale risorsa. Per applicare una tag definita, è necessario disporre delle autorizzazioni per utilizzare la tag namespace. Per ulteriori informazioni sull'applicazione di tag, vedere Tag risorsa. Se non si è certi di applicare le tag, saltare questa opzione o chiedere a un amministratore. È possibile applicare le tag in un secondo momento.
    11. (Facoltativo) Per visualizzare i dettagli della sessione notebook immediatamente dopo la creazione, selezionare Visualizza pagina dettagli quando si fa clic su Crea.
    12. Selezionare Crea.
    Viene visualizzata la pagina Sessioni notebook. Quando la sessione notebook viene creata correttamente, lo stato diventa Attivo ed è possibile aprire la sessione notebook. L'azione Crea sessione notebook è asincrona e avvia una richiesta di lavoro. È possibile utilizzare la richiesta di lavoro per tenere traccia dello stato di un'operazione. Per informazioni generali sull'uso delle richieste di lavoro in OCI, vedere API Richieste di lavoro e richieste di lavoro.

  • Per creare una sessione notebook in un compartimento, utilizzare i comandi oci data-science notebook-session create e i parametri necessari:

    oci data-science notebook-session create --compartment-id <compartment-id>, -c [<name>], -c [<project-id>]  ... [OPTIONS]

    Per un elenco completo dei flag e delle opzioni variabili per i comandi CLI, consultare il manuale CLI Command Reference.

  • Eseguire l'operazione CreateNotebookSession per creare una sessione notebook.