Upgrade dell'ambiente di un'istanza di blocco note gestita dall'utente

Le istanze di notebook gestiti dall'utente di Vertex AI Workbench sono istanze Deep Learning VM Image con ambienti notebook JupyterLab abilitati e pronti per l'uso. Questa pagina descrive come eseguire l'upgrade dell'ambiente di un'istanza di blocchi note gestiti dall'utente.

Motivi per l'upgrade

Potresti voler eseguire l'upgrade dell'ambiente dell'istanza di blocchi note gestiti dall'utente per uno dei seguenti motivi:

• Per utilizzare nuove funzionalità disponibili solo in una versione più recente del tuo ambiente.

• Per usufruire degli aggiornamenti del framework, dei pacchetti e delle correzioni di bug implementati in una versione più recente dell'ambiente.

Metodi di upgrade

Esistono due modi per eseguire l'upgrade di un'istanza di blocchi note gestita dall'utente:

• Upgrade automatico: abilita l'upgrade automatico quando crei un'istanza di notebook gestiti dall'utente. Durante un periodo di tempo ricorrente che specifichi, Vertex AI Workbench controlla se è possibile eseguire l'upgrade dell'istanza e, in caso affermativo, esegue l'upgrade.

• Upgrade manuale: se un'istanza di blocchi note gestiti dall'utente esistente soddisfa i requisiti per l'upgrade, puoi eseguire l'upgrade dell'istanza manualmente.

Requisiti e limitazioni

La compatibilità con le versioni precedenti dei notebook gestiti dall'utente non è garantita. Crea una copia dei tuoi dati prima di eseguire l'upgrade di un'istanza di blocchi note gestiti dall'utente.

Per determinare se puoi eseguire l'upgrade di un'istanza di notebook gestiti dall'utente specifica, consulta i seguenti requisiti e limitazioni:

• L'API Notebooks deve essere abilitata nel Google Cloud progetto dell'istanza. Per ulteriori informazioni, vedi Elenco dei servizi abilitati e Abilitare un'API.

• La versione dell'ambiente dell'istanza di blocchi note gestiti dall'utente deve essere M54 o successive.

• L'istanza di notebook gestiti dall'utente deve essere stata creata utilizzando l'API Notebooks o deve essere stata registrata con l'API Notebooks.

• Se l'istanza di notebook gestiti dall'utente è basata su container, Vertex AI Workbench esegue l'upgrade del sistema operativo. La versione dell'immagine dipende dall'immagine specifica estratta dal Dockerfile.

  Per assicurarti che l'upgrade utilizzi la versione più recente dell'immagine, valuta la possibilità di utilizzare il tag latest in Dockerfile.

Se l'upgrade dell'istanza non è un'opzione per te, valuta la possibilità di eseguire la migrazione dei dati a una nuova istanza di notebook gestiti dagli utenti.

Come funziona l'upgrade

Le istanze di blocchi note gestiti dall'utente che possono essere aggiornate sono a doppio disco, con un disco di avvio e un disco di dati. Il processo di upgrade esegue l'upgrade del disco di avvio a una nuova immagine mantenendo i dati sul disco di dati.

Quali componenti vengono aggiornati o conservati?

La tabella seguente mostra quali componenti dell'istanza di blocchi note gestiti dall'utente vengono aggiornati e quali vengono conservati.

Componente	Risultato dell'upgrade
Framework di machine learning	Upgrade completato
Dati di machine learning	Conservato
Dipendenze preinstallate	Upgrade completato
Librerie installate dall'utente	Per impostazione predefinita, deve essere reinstallata (vedi Librerie installate dall'utente)
File locali nella directory /home/jupyter	Conservato
File locali in qualsiasi altra directory /home/	Non conservato
Pacchetti del sistema operativo preinstallati	Upgrade completato
Pacchetti del sistema operativo installati dall'utente	Non conservato
Driver GPU	Upgrade completato
Notebook	Conservato
Configurazioni utente	Conservato

Librerie installate dall'utente

Per impostazione predefinita, le istanze di blocchi note gestiti dall'utente archiviano le librerie pip e Conda nel disco di avvio, che viene sostituito durante un upgrade. Quando installi le librerie pip, puoi includere il flag --user per installarle nella directory /home/jupyter/, dove vengono conservate durante un upgrade.

Per impostazione predefinita, se installi librerie pip o Conda in un kernel creato da un contenitore personalizzato, le librerie vengono mantenute solo durante l'esecuzione del kernel. Ogni volta che il kernel viene riavviato, queste librerie dovranno essere reinstallate. Per installare librerie persistenti in un container personalizzato, includi le installazioni delle librerie nel Dockerfile. Quando installi le librerie pip in un kernel creato da un container personalizzato, puoi includere il flag --user in modo che le librerie vengano mantenute fino al riavvio dell'istanza.

Versioni dell'ambiente

Vertex AI Workbench aggiorna regolarmente gli ambienti (consulta le note di rilascio di Deep Learning VM), ma con ogni versione rilasciata, non tutti gli ambienti vengono aggiornati. Vertex AI Workbench esegue l'upgrade di un'istanza solo se è disponibile una versione dell'ambiente più recente per l'immagine VM su cui si basa l'istanza.

Per informazioni su come utilizzare una versione specifica per creare un'istanza di blocchi note gestiti dall'utente, vedi Creare una versione specifica di un'istanza di blocchi note gestiti dall'utente.

Prima di eseguire l'upgrade

Prima di eseguire l'upgrade, completa i seguenti passaggi.

1. Consulta le note di rilascio per informazioni sugli aggiornamenti alle versioni più recenti.

2. Crea una copia dei tuoi dati come backup.

Upgrade automatico

Vertex AI Workbench può eseguire l'upgrade automatico delle istanze in esecuzione. Se l'istanza è arrestata, non viene eseguito automaticamente l'upgrade, anche se hai attivato l'upgrade automatico al momento della creazione.

Quando attivi gli upgrade automatici dell'ambiente, specifichi un periodo di tempo ricorrente in cui Vertex AI Workbench controlla se è possibile eseguire l'upgrade dell'istanza e, in caso affermativo, lo esegue.

Il periodo di tempo specificato viene memorizzato come voce di metadati notebook-upgrade-schedule nel formato unix-cron, Greenwich Mean Time (GMT).

Per verificare se un'istanza può essere aggiornata, Vertex AI Workbench utilizza il metodo API isUpgradeable. Questo metodo verifica la presenza di una versione più recente dell'immagine sul disco di avvio dell'istanza.

Se l'istanza può essere aggiornata, Vertex AI Workbench utilizza un metodo di upgrade interno per aggiornarla.

Crea un'istanza di blocchi note gestiti dall'utente con l'upgrade automatico abilitato

Per creare un'istanza di blocchi note gestiti dall'utente con l'upgrade automatico attivato, seleziona la casella di controllo Abilita upgrade automatico dell'ambiente e imposta una pianificazione quando crei l'istanza.

Puoi specificare l'upgrade automatico utilizzando la console Google Cloud o Google Cloud CLI.

Prima di iniziare

Prima di poter creare un'istanza di blocchi note gestiti dall'utente, devi disporre di un progettoGoogle Cloud e abilitare l'API Notebooks per quel progetto.

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the Notebooks API.

Enable the API

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Go to project selector

Make sure that billing is enabled for your Google Cloud project.

Enable the Notebooks API.

Enable the API

1. Se prevedi di utilizzare le GPU con l'istanza di notebook gestiti dall'utente, controlla la pagina Quote nella console Google Cloud per assicurarti di disporre di un numero sufficiente di GPU nel progetto. Se le GPU non sono elencate nella pagina Quote o se hai bisogno di una quota di GPU aggiuntiva, puoi richiedere un aumento della quota. Consulta la sezione Richiesta di aumento della quota nella pagina Quote delle risorse di Compute Engine.

Ruoli obbligatori

Se hai creato il progetto, disponi del ruolo IAM Proprietario (roles/owner) per il progetto, che include tutte le autorizzazioni richieste. Salta questa sezione e inizia a creare l'istanza di blocchi note gestiti dall'utente. Se non hai creato tu il progetto, continua in questa sezione.

Per ottenere le autorizzazioni necessarie per creare un'istanza di blocchi note gestiti dall'utente di Vertex AI Workbench, chiedi all'amministratore di concederti i seguenti ruoli IAM per il progetto:

• Amministratore Notebooks (roles/notebooks.admin)
• Service Account User (roles/iam.serviceAccountUser)

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Crea l'istanza

Console

1. Nella console Google Cloud , vai alla pagina Notebook gestiti dall'utente. In alternativa, vai all'indirizzo notebook.new (https://notebook.new) e salta il passaggio successivo.

   Vai a Blocchi note gestiti dall'utente

2. Fai clic su add_box Nuovo blocco note, quindi seleziona Personalizza.

3. Nella pagina Crea un blocco note gestito dall'utente, nella sezione Dettagli, fornisci le seguenti informazioni per la nuova istanza:

   • Nome: un nome per la nuova istanza
   • Regione e Zona: seleziona una regione e una zona per la nuova istanza. Per ottenere le migliori prestazioni di rete, seleziona la regione geograficamente più vicina a te. Visualizza le posizioni dei blocchi note gestiti dall'utente disponibili.

4. Nella sezione Integrità del sistema, seleziona Upgrade automatico dell'ambiente.

5. Scegli se eseguire l'upgrade del notebook settimanalmente o mensilmente.

6. Nel campo Giorno della settimana, seleziona l'opzione che preferisci.

7. Nel campo Ora, scegli un'ora del giorno.

8. Completa il resto della finestra di dialogo di creazione dell'istanza e poi fai clic su Crea.

gcloud

1. Da Cloud Shell o da qualsiasi ambiente in cui è installata Google Cloud CLI, inserisci il seguente comando Google Cloud CLI:

   gcloud notebooks instances create INSTANCE_NAME
       --metadata=notebook-upgrade-schedule=SCHEDULE
       --vm-image-project=deeplearning-platform-release
       --vm-image-family=VM_IMAGE_FAMILY
       --machine-type=MACHINE_TYPE
       --location=LOCATION
   

   Sostituisci quanto segue:

   • INSTANCE_NAME: il nome della nuova istanza
   • SCHEDULE: la pianificazione settimanale o mensile che hai impostato, nel formato unix-cron; ad esempio, "00 19 * * MON" significa ogni lunedì alle ore 19:00 Greenwich Mean Time (GMT)
   • VM_IMAGE_FAMILY: il nome della famiglia di immagini che vuoi utilizzare per creare l'istanza
   • MACHINE_TYPE: il tipo di macchina della VM della tua istanza
   • LOCATION: la Google Cloud posizione in cui vuoi che si trovi la nuova istanza

2. Accedi alla tua istanza dalla Google Cloud console.

Modificare la pianificazione dell'upgrade automatico

Per modificare la pianificazione dell'upgrade automatico dopo aver creato l'istanza di blocchi note gestiti dall'utente, completa i seguenti passaggi:

1. Nella console Google Cloud , vai alla pagina Notebook gestiti dall'utente.

   Vai a Blocchi note gestiti dall'utente

2. Fai clic sul nome dell'istanza per cui è necessario modificare la pianificazione.

3. Nella pagina Dettagli notebook, nella sezione Aggiornamento automatico dell'ambiente, modifica la pianificazione.

4. Fai clic su Invia per salvare le modifiche.

Upgrade manuale

Puoi eseguire manualmente l'upgrade delle istanze di blocchi note gestiti dall'utente che soddisfano i requisiti.

Controllare se è disponibile una versione più recente dell'ambiente dell'istanza

Per verificare se è disponibile una versione più recente dell'ambiente dell'istanza, accedi all'istanza dalla console Google Cloud .

1. Nella console Google Cloud , vai alla pagina Notebook gestiti dall'utente.

   Vai a Blocchi note gestiti dall'utente

2. Se l'istanza non è in esecuzione, avviala. Vertex AI Workbench può eseguire l'upgrade delle istanze solo quando sono in esecuzione.

3. Fai clic sul nome dell'istanza per la quale vuoi verificare la disponibilità di una versione più recente dell'ambiente.

4. Nella pagina Dettagli notebook, accanto a Dettagli VM, fai clic su Visualizza in Compute Engine.

   Se è disponibile una versione più recente dell'ambiente, viene visualizzato il messaggio "È necessario eseguire l'upgrade di questa istanza".

Esegui l'upgrade dell'ambiente dell'istanza a una versione più recente

Puoi eseguire l'upgrade manuale di un'istanza di blocchi note gestiti dall'utente nella console Google Cloud o utilizzando Google Cloud CLI.

Console

1. Nella console Google Cloud , vai alla pagina Notebook gestiti dall'utente.

   Vai a Blocchi note gestiti dall'utente

2. Se l'istanza non è in esecuzione, avviala. Vertex AI Workbench può eseguire l'upgrade delle istanze solo quando sono in esecuzione.

3. Fai clic sul nome dell'istanza da aggiornare.

4. Nella pagina Dettagli del notebook, fai clic su  Esegui upgrade.

5. Prima di continuare, assicurati di aver creato una copia dei dati nella tua istanza.

6. Dopo aver eseguito il backup dei dati, fai clic su Esegui upgrade. Vertex AI Workbench esegue l'upgrade e avvia l'istanza.

gcloud

1. Per verificare se è possibile eseguire l'upgrade di un'istanza, utilizza il metodo API isUpgradeable. Questo metodo verifica la presenza di una versione più recente dell'immagine sul disco di avvio dell'istanza.

   gcloud notebooks instances is-upgradeable INSTANCE_NAME \
       --location=LOCATION
   

   Sostituisci quanto segue:

   • INSTANCE_NAME: il nome dell'istanza
   • LOCATION: la Google Cloud posizione in cui si trova l'istanza

   Se l'istanza è aggiornabile, la risposta è true. Se la risposta è false, l'istanza non può essere aggiornata, ma puoi comunque provare a migrare i dati a una nuova istanza.

2. Se l'istanza non è in esecuzione, avviala. Vertex AI Workbench può eseguire l'upgrade delle istanze solo quando sono in esecuzione.

3. Prima di continuare, assicurati di aver creato una copia dei dati nella tua istanza.

4. Se l'istanza è aggiornabile, utilizza il metodo API upgrade per eseguire l'upgrade dell'istanza:

   gcloud notebooks instances upgrade INSTANCE_NAME \
       --location=LOCATION
   

   Vertex AI Workbench esegue l'upgrade dell'istanza.

Esegui il rollback di un upgrade

Per eseguire il rollback di un upgrade:

1. Nella console Google Cloud , vai alla pagina Notebook gestiti dall'utente.

   Vai a Blocchi note gestiti dall'utente

2. Fai clic sul nome dell'istanza di cui vuoi eseguire il rollback.

3. Nella pagina Dettagli del notebook, nella sezione Cronologia degli upgrade, fai clic su Rollback.

4. Vertex AI Workbench esegue il rollback dell'istanza alla versione precedente.