Uso di una configurazione runtime

Oltre alle variabili fornite dal sistema, è possibile aggiungere chiavi variabili di ambiente personalizzate alle sessioni notebook. Quando si crea una sessione notebook, aggiungere variabili personalizzate come coppie chiave-valore nella sezione Configurazione runtime.

Vincoli coppia di valori chiave

• Per chiavi e valori viene fatta distinzione tra maiuscole e minuscole.

• Le chiavi devono iniziare con una lettera o un carattere di sottolineatura e devono contenere solo numeri alfanumerici e di sottolineatura.

• La lunghezza della chiave è minima di 2 e massima di 32 caratteri.

• La lunghezza del valore è minima di 1 e massima di 256 caratteri.

• Le chiavi non possono iniziare con lo spazio di nomi riservato del servizio di oci_internal_.

• Le chiavi non possono essere variabili gestite dal servizio.

Per una sessione notebook esistente, disattivare le sessioni notebook. Quindi, quando si attiva il notebook, aggiungere le coppie di valori chiave nella sezione Configurazione runtime.

È possibile utilizzare gli script del ciclo di vita della sessione notebook per eseguire uno script personalizzato in stati diversi del ciclo di vita della sessione notebook come indicato di seguito.

• Creare

• Attiva

• Disattiva

• Elimina

Per eseguire uno script del ciclo di vita del notebook, passare una chiave gestita dal servizio nella sezione Configurazione runtime che indica lo stato del ciclo di vita in cui eseguire lo script. Nel campo del valore corrispondente, specificare l'URI del file di storage degli oggetti OCI in cui è stato caricato lo script del ciclo di vita.

Lo stato del blocco note non cambia finché lo script non viene completato per l'eliminazione e la disattivazione degli stati del ciclo di vita. Gli script di creazione e attivazione del ciclo di vita vengono eseguiti in parallelo con la sessione notebook in modo che non si verifichino ritardi di avvio.

Sono stati forniti diversi script del ciclo di vita del notebook di esempio che possono essere modificati in base a vari casi d'uso.

Per utilizzare gli script del ciclo di vita del notebook, è necessario creare un gruppo dinamico e un criterio per l'utilizzo di un principal risorsa della sessione notebook. Le autorizzazioni di lettura devono essere concesse al gruppo dinamico del notebook per il bucket di storage degli oggetti contenente gli script del ciclo di vita.

Di seguito sono riportate le chiavi delle variabili di ambiente degli script del ciclo di vita della sessione del registro note.

NB_ONCREATE_SCRIPT_URL
NB_ONACTIVATE_SCRIPT_URL
NB_ONDEACTIVATE_SCRIPT_URL
NB_ONDELETE_SCRIPT_URL

Queste chiavi devono avere il seguente criterio IAM aggiunto per consentire a Data Science di leggere gli oggetti dal bucket degli script come nell'esempio riportato di seguito.

allow dynamic-group <notebook_dyn_group> to manage objects in tenancy
 where all {target.bucket.name='<scripts_bucket>',
            any {request.permission='OBJECT_INSPECT',
                 request.permission='OBJECT_READ'}}

Per le chiavi gestite dal servizio corrispondenti alle chiavi script del ciclo di vita del notebook precedenti, il valore deve essere un URI file di storage degli oggetti OCI per gli script caricati. Il formato URI è https://objectstorage.region.oraclecloud.com/n/object-storage-namespace/b/bucket/o/filename. È possibile trovare l'URI file nella sezione Dettagli oggetto.

Di seguito sono riportate le chiavi delle variabili di ambiente dello script di output del ciclo di vita della sessione del registro note.

NB_SCRIPT_OUTPUT_LOG_NAMESPACE
NB_SCRIPT_OUTPUT_LOG_BUCKET

Queste chiavi devono avere il seguente criterio IAM aggiunto per consentire a Data Science di creare e caricare i log di output nel bucket dei log come nell'esempio riportato di seguito.

allow dynamic-group <notebook_dyn_group> to manage objects in tenancy
 where all {target.bucket.name='<logs_bucket>',
            any {request.permission='OBJECT_CREATE'}}

I log degli script di creazione e attivazione sono disponibili all'interno della sessione dei notebook nello stesso percorso della configurazione runtime nella directory /opt/log/odsc.log.

Il caricamento del log si verifica con un'operazione di disattivazione o eliminazione della sessione notebook, che consente di controllare lo stato dell'elaborazione dello script perché si perde l'accesso alla sessione notebook. Questa opzione non è supportata per gli script di creazione e attivazione.

I repository Git possono essere duplicati all'interno delle sessioni notebook utilizzando una configurazione runtime. Con questo approccio è possibile duplicare solo i repository Git pubblici. Per clonare repository Git privati, utilizzare le chiavi SSH per l'autenticazione.

Il servizio può clonare un repository Git in una directory locale di una sessione notebook, quindi utilizzare Git.

Vincoli Git

• Il notebook deve disporre dell'accesso a Internet per la copia del repository Git.

• Sono supportati solo i repository Git pubblici.

• Sono consentiti al massimo tre URL dei repository Git.

• La lunghezza massima di un URL è di 256 caratteri.

Directory correlate a Git nelle sessioni notebook

• Trovare le copie dei repository Git nella directory /home/datascience/repos di una sessione notebook.
• Per lo stato della copia, ad esempio Operazione riuscita, Errore o In corso, passare a /opt/log/odsc.log.
• Per i log descrittivi, andare a /var/log/jupyterlab/runtime_config.log.

Accedere ai log da un terminale in una sessione notebook.

Per la sessione notebook esistente, disattivare le sessioni notebook. Quindi, quando si attiva il blocco note, aggiungere l'URL del repository Git nella sezione Configurazione runtime.

Se si attiva una sessione notebook con nuovi URL del repository Git, anche gli URL elencati nella sezione Configurazione runtime, inclusi gli URL precedenti delle sessioni notebook disattivate, vengono clonati nella directory /home/datascience/repos del notebook.

Per rimuovere un repository duplicato da una sessione notebook, è possibile eliminarlo dalla directory /home/datascience/repos della sessione notebook.

Per sostituire una copia precedente da un notebook disattivato con una nuova, eliminare l'URL del repository Git indesiderato elencato nella sezione Configurazione runtime, aggiungere il nuovo URL, quindi attivare la sessione notebook.