Personalizzazione dei modelli di ambiente

Come Admin o Editor di un progetto, è possibile modificare il nome, la descrizione e la configurazione hardware di un modello di ambiente creato. È inoltre possibile personalizzare la configurazione software dei modelli di ambiente Jupyter Notebook aggiungendo pip dei pacchetti.

È possibile personalizzare la configurazione software dei modelli di ambiente Jupyter Notebook utilizzando pip. Puoi farlo fornendo un elenco di pip pacchetti.

Nota:
  • Se hai personalizzato la configurazione software di un ambiente o prevedi di installare librerie aggiuntive all'interno di un notebook, ma non modifichi la configurazione di pip, i runtime avviati con una personalizzazione devono disporre di accesso alla rete pubblica.
  • I modelli di ambiente predefiniti utilizzano il fuso orario in cui sono stati creati, ovvero l'ora UTC. Se desideri utilizzare l'ora locale nel tuo codice, chiedi all'amministratore di modificare il file di definizione dell'ambiente di esecuzione in modo che utilizzi il tuo fuso orario.

Guarda il video qui sotto per scoprire come creare un modello di ambiente personalizzato per un notebook Jupyter.

Questo video fornisce un metodo visivo per apprendere i concetti e le attività in questa documentazione.

Per personalizzare un modello di ambiente creato:

  1. In Runtime strumento sulla pagina Ambienti nella scheda Gestisci del progetto, verificare che nessun runtime sia attivo per il modello di ambiente che si desidera modificare. Se un tempo di esecuzione è attivo, è necessario arrestarlo prima di poter modificare il template.
  2. In Template nella pagina Ambienti , selezionare il modello che si desidera personalizzare e aggiungere le proprie modifiche. Non è possibile modificare la lingua di un template ambiente esistente.
  3. Se il modello è un modello di ambiente notebook Juypter, è possibile creare una personalizzazione software e specificare le librerie da aggiungere ai pacchetti standard disponibili per impostazione predefinita. È inoltre possibile utilizzare la personalizzazione per aggiornare o downgrade pacchetti che fanno parte della configurazione software standard.
  4. Applica le modifiche.

Le librerie che vengono aggiunte a un template di ambiente tramite la personalizzazione non sono persistenti. Vengono installati automaticamente ogni volta che viene avviato il runtime. Da notare che se si aggiunge una libreria utilizzando pip install tramite una cella del notebook e non attraverso la personalizzazione, solo sarà possibile utilizzare questa libreria. La libreria non è disponibile per qualcun altro utilizzando lo stesso modello di ambiente.

È possibile utilizzare i modelli forniti per aggiungere librerie personalizzate. Esistono diversi modelli per Python e per R. Il seguente esempio mostra il template Python :

# Modify the following content to add a software customization to an environment.
# To remove an existing customization, delete the entire content and click Apply.

# To add packages through pip, remove the comment on the following line.
# dependencies:

# Add pip packages here, indented by four spaces and a hyphen.
# Remove the comments on the following lines and replace sample package name with your package name.
#  - pip:
#    - a_pip_package==1.0

Importante quando si personalizza:

  • Prima di personalizzare un package, verificare che le modifiche pianificate abbiano l'effetto desiderato.
    • pip installa il pacchetto. Tuttavia, il riavvio dell'ambiente dopo la verifica rimuoverà il pacchetto. Puoi verificare le modifiche dal tuo notebook. Ad esempio, per la libreria Plotly :
      • In un notebook Python , inserire: !pip install plotly
      • In un notebook R, inserire: print(system2("pip", args="install plotly", stdout=TRUE))
  • Se si aggiungono pacchetti tramite pip al modello di personalizzazione, è necessario assicurarsi che la dependencies chiave non sia commentata nel modello. Una personalizzazione con un pip pacchetto il cui nome non inizia con la dependencies chiave genererà un errore.
  • Laddove possibile, fornire un numero di versione del package, anche se la versione che si desidera utilizzare è la più recente e si prevede che il gestore del package la selezioni. Fornire un numero di versione riduce significativamente il tempo e il consumo di memoria durante l'installazione del pacchetto.
  • Quando si specifica la versione di un pacchetto, utilizzare le virgolette pip doppie == . Se la versione specificata causa un conflitto di dipendenza che il gestore package può risolvere, potrebbe essere installata una versione diversa o più recente. Se non si specifica una versione, il gestore del pacchetto potrebbe scegliere l'ultima versione disponibile oppure mantenere la versione che si trova nel pacchetto.
  • Non è possibile aggiungere estensioni di notebook arbitrarie come personalizzazione perché le estensioni del notebook devono essere pre - installate.

Ulteriori informazioni