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

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

I notebook gestiti dall'utente di Vertex AI Workbench sono ritratti. Il 30 gennaio 2025 verrà interrotto il supporto per i blocchi note gestiti dall'utente e la possibilità di creare istanze di blocchi note gestiti dall'utente verrà rimossa. Le istanze esistenti continueranno a funzionare, ma patch, aggiornamenti e upgrade non saranno disponibili. Per continuare a utilizzare Vertex AI Workbench, ti consigliamo di eseguire la migrazione delle tue istanze di blocchi note gestiti dall'utente alle istanze di Vertex AI Workbench.

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

Motivi per eseguire l'upgrade

Potresti voler eseguire l'upgrade dell'ambiente la tua 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 trarre vantaggio dagli aggiornamenti del framework, dagli aggiornamenti dei pacchetti e dalle correzioni di bug che sono state implementate in una versione più recente dell'ambiente.

Metodi di upgrade

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

• Upgrade automatico: attiva l'upgrade automatico quando crei per un'istanza di blocchi note gestiti dall'utente. Durante un periodo specificato, Vertex AI Workbench controlla se eseguire l'upgrade dell'istanza e, in questo caso, Vertex AI Workbench esegue l'upgrade dell'istanza.

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

Requisiti e limitazioni

La compatibilità con le versioni precedenti dei blocchi note gestiti dall'utente garantito. Crea una copia di i 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 gestita dall'utente specifica, consulta i seguenti requisiti e limitazioni:

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

• L'istanza di blocco note gestiti dall'utente La versione dell'ambiente deve essere M54 o successiva.

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

• Se l'istanza di notebook gestita 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 del tuo Dockerfile.

Se non è possibile eseguire l'upgrade dell'istanza, valuta la possibilità di eseguire la migrazione dei dati una nuova istanza di blocchi note gestiti dall'utente.

Come funziona l'upgrade

Le istanze di notebook gestite dall'utente di cui è possibile eseguire l'upgrade 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, preservando i dati sul disco di dati.

Per quali componenti viene eseguito l'upgrade o la conservazione?

La tabella seguente mostra quali componenti dell'istanza dei blocchi note gestiti dall'utente vengono sottoposti ad upgrade 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 reinstallato (vedi Librerie installate dall'utente).
File locali nella directory /home/jupyter	Conservato
File locali in qualsiasi altra directory /home/	Non conservato
Pacchetti di sistemi operativi preinstallati	Upgrade completato
Pacchetti di sistemi operativi installati dall'utente	Non conservata
Driver GPU	Upgrade completato
Notebooks	Conservato
Configurazioni utente	Conservato

Librerie installate dall'utente

Per impostazione predefinita, le istanze di notebook gestite 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/, in cui vengono conservati durante un upgrade.

Per impostazione predefinita, se installi librerie pip o Conda in un kernel creato da un contenuto personalizzato, le librerie rimangono persistenti solo durante l'esecuzione del kernel. A ogni riavvio del kernel, le librerie devono essere reinstallato. Per installare le librerie permanenti in un container personalizzato, includi le installazioni delle librerie nel tuo Dockerfile. Durante l'installazione 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 ambiente

Vertex AI Workbench aggiorna gli ambienti con regolarità (vedi il Rilascio Deep Learning VM note), ma con ogni una nuova versione, non tutte gli ambienti vengono aggiornati. Vertex AI Workbench esegue l'upgrade di un'istanza solo se esiste una dell'immagine VM su cui si basa la tua istanza.

Per informazioni su come utilizzare una versione specifica per creare un'istanza di notebook gestiti dall'utente, consulta Creare una versione specifica di un'istanza di notebook 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 automaticamente l'upgrade delle istanze in esecuzione. Se l'istanza viene arrestata, non esegue automaticamente l'upgrade anche se hai abilitato 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, esegue l'upgrade.

Il periodo di tempo specificato viene archiviato come notebook-upgrade-schedule voce di metadati, nel formato unix-cron, nel fuso orario di Greenwich (GMT).

Per verificare se è possibile eseguire l'upgrade di un'istanza, Vertex AI Workbench utilizza il metodo API isUpgradeable. Questo metodo controlla se è disponibile una versione più recente dell'immagine nel campo disco di avvio.

Se è possibile eseguire l'upgrade dell'istanza, Vertex AI Workbench utilizza un metodo di upgrade interno per eseguire l'upgrade dell'istanza.

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 upgrade automatico abilitata, seleziona la casella di controllo Abilita l'upgrade automatico dell'ambiente e imposta e pianificare la creazione dell'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 notebook gestita dall'utente, devi avere un progetto Google Cloud e abilitare l'API Notebooks per quel progetto.

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

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

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

4. Enable the Notebooks API.

   Enable the API

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

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

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

7. Enable the Notebooks API.

   Enable the API

8. Se prevedi di utilizzare GPU con la tua istanza di notebook gestita dall'utente, controlla la pagina Quote in Google Cloud Console per assicurarti di disporre di un numero sufficiente di GPU nel progetto. Se le GPU non sono elencati nella pagina delle quote o hai bisogno di una quota GPU aggiuntiva, puoi richiedere un aumento della quota. Consulta la sezione Richiedere un 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) nel progetto, che include tutte le autorizzazioni richieste. Salta questa sezione e inizia a creare l'istanza di blocchi note gestiti dall'utente. Se non lo hai fatto creare il progetto autonomamente, continua in questa sezione.

Per assicurarti che il tuo account utente disponga degli le autorizzazioni per creare un'istanza di blocchi note gestiti dall'utente di Vertex AI Workbench, chiedi all'amministratore di concedere al tuo account utente la seguenti ruoli IAM sul progetto:

• Amministratore Notebooks (roles/notebooks.admin)
• Utente dell'account di servizio (roles/iam.serviceAccountUser)

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

L'amministratore potrebbe anche essere in grado di fornire il tuo account utente le autorizzazioni richieste tramite la ruoli o altri ruoli predefiniti ruoli.

Crea l'istanza

Console

1. Nella console Google Cloud, vai alla pagina Blocchi note 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  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 della rete, seleziona la regione geograficamente più vicina a te. Consulta le località 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 blocco note Settimanale o Mensile.

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

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

8. Completa la parte rimanente della finestra di dialogo di creazione dell'istanza e poi fai clic su Crea.

gcloud

1. Da Cloud Shell o in qualsiasi ambiente in cui è installata Google Cloud CLI, inserisci questo 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 del nuovo istanza
   • SCHEDULE: programmazione settimanale o mensile che hai impostato, in unix-cron formato; Ad esempio, "00 19 * * MON" significa ogni settimana di lunedì, alle 19.00 Fuso orario GMT (Greenwich Mean Time)
   • VM_IMAGE_FAMILY: il nome della famiglia di immagini che vuoi utilizzare per creare l'istanza
   • MACHINE_TYPE: la macchina tipo della VM dell'istanza
   • LOCATION: la località Google Cloud in cui vuoi che si trovi la nuova istanza

2. Accedi all'istanza da nella console Google Cloud.

Modifica la pianificazione dell'upgrade automatico

Per modificare la pianificazione dell'upgrade automatico dopo aver creato l'istanza di notebook gestita dall'utente:

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 è necessaria la modifica della pianificazione.

3. Nella pagina Dettagli del notebook, nella sezione Upgrade 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.

Cerca 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 Blocchi note 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 vuoi verificare la disponibilità di una versione più recente dell'ambiente.

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

   Se è disponibile una versione più recente dell'ambiente, il comando "Questa istanza richiede eseguire l'upgrade" .

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

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

Nota: gli upgrade possono influire sulle operazioni utente in esecuzione.

Console

1. Nella console Google Cloud, vai alla pagina Blocchi note 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 in esecuzione.

3. Fai clic sul nome dell'istanza di cui vuoi eseguire l'upgrade.

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

5. Assicurati di aver creato una copia dei dati sul tuo o istanza precedente continua.

6. Dopo aver eseguito il backup dei dati, fai clic su Esegui l'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 controlla se è disponibile una versione più recente dell'immagine nel campo disco di avvio.

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

   Sostituisci quanto segue:

   • INSTANCE_NAME: il nome del tuo istanza
   • LOCATION: la località di Google Cloud in cui l'istanza si trova

   Se l'istanza è eseguibile in un upgrade, la risposta è true. Se la risposta è false, non è possibile eseguire l'upgrade dell'istanza, ma puoi comunque provare a eseguire la migrazione dei dati a una nuova istanza.

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

3. Assicurati di aver creato una copia dei dati nell'istanza prima di continuare.

4. Se è possibile eseguire l'upgrade dell'istanza, 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 blocco note, fai clic su Esegui il rollback in Cronologia upgrade.

4. Vertex AI Workbench ripristina la versione precedente dell'istanza.