Esegui l'upgrade dell'ambiente di un'istanza

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

Motivi per eseguire l'upgrade

Ti consigliamo di eseguire l'upgrade dell'ambiente dell'istanza di Vertex AI Workbench per uno dei seguenti motivi:

Per utilizzare le nuove funzionalità disponibili solo in una versione più recente del tuo ambiente.
Per trarre vantaggio dagli aggiornamenti del framework, dei pacchetti e delle correzioni di bug implementati in una versione più recente del tuo ambiente.

Metodi di upgrade

Esistono due modi per eseguire l'upgrade di un'istanza di Vertex AI Workbench:

Upgrade automatico: abilita l'upgrade automatico quando crei un'istanza di Vertex AI Workbench. Durante un periodo di tempo ricorrente da te specificato, Vertex AI Workbench controlla se è possibile eseguire l'upgrade dell'istanza e, in tal caso, esegue l'upgrade dell'istanza.
Upgrade manuale: se un'istanza Vertex AI Workbench esistente soddisfa i requisiti per l'upgrade, puoi eseguire manualmente l'upgrade dell'istanza.

Requisiti e limitazioni

La compatibilità con le versioni precedenti di Vertex AI Workbench non è garantita. Crea una copia dei tuoi dati prima di eseguire l'upgrade di un'istanza di Vertex AI Workbench.

Per determinare se puoi eseguire l'upgrade di un'istanza specifica di Vertex AI Workbench, consulta i seguenti requisiti e limitazioni:

L'API Notebooks deve essere abilitata nel progetto Google Cloud dell'istanza. Per maggiori informazioni, consulta Elenco dei servizi abilitati e Abilitazione di un'API.
Se l'istanza di Vertex AI Workbench è 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 nel Dockerfile.

Se non puoi eseguire l'upgrade dell'istanza, valuta la possibilità di eseguire la migrazione dei dati a una nuova istanza di Vertex AI Workbench.

Come funziona l'upgrade

Le istanze di Vertex AI Workbench di cui è possibile eseguire l'upgrade sono a doppio disco, con un disco di avvio e un disco dati. Il processo di upgrade esegue l'upgrade del disco di avvio a una nuova immagine, mantenendo i dati sul disco dati.

Quali componenti vengono sottoposti a upgrade o conservati?

La tabella seguente mostra quali componenti dell'istanza di Vertex AI Workbench vengono sottoposti a 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 conservato
Driver GPU	Upgrade completato
Notebooks	Conservato
Configurazioni utente	Conservato

Librerie installate dall'utente

Per impostazione predefinita, le istanze Vertex AI Workbench 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 le librerie pip o Conda in un kernel creato da un container personalizzato, le librerie vengono mantenute solo quando il kernel è in esecuzione. Ogni volta che il kernel viene riavviato, queste librerie dovranno essere reinstallate. Per installare librerie permanenti in un container personalizzato, includi le installazioni di librerie nel tuo Dockerfile. Quando installi librerie pip in un kernel creato da un container personalizzato, puoi includere il flag --user in modo che le librerie rimangano disponibili fino al riavvio dell'istanza.

Versioni ambiente

L'istanza di Vertex AI Workbench ha un numero di versione di ambiente che puoi verificare:

Nella console Google Cloud, vai alla pagina Istanze.

Vai a Istanze
Nell'elenco delle istanze, individua il numero di versione dell'ambiente dell'istanza nella colonna Versione.

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

Per informazioni su come utilizzare una versione specifica per creare un'istanza di Vertex AI Workbench, consulta Creare una versione specifica di un'istanza di Vertex AI Workbench.

Prima di iniziare

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

Consulta le note di rilascio per informazioni sugli aggiornamenti alle versioni più recenti.
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 ne viene eseguito automaticamente l'upgrade, anche se hai abilitato l'upgrade automatico al momento della creazione.

Quando abiliti gli upgrade automatici dell'ambiente, specifichi un periodo di tempo ricorrente durante il quale Vertex AI Workbench verifica se è possibile eseguire l'upgrade dell'istanza e, se possibile, eseguendo l'upgrade dell'istanza.

Il periodo di tempo specificato è memorizzato come voce di metadati notebook-upgrade-schedule in formato unix-cron, fuso orario di Greenwich (GMT).

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

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 Vertex AI Workbench con upgrade automatico abilitato

Per creare un'istanza Vertex AI Workbench con upgrade automatico abilitato, 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.

Nella console Google Cloud, vai alla pagina Istanze.

Vai a Istanze
Fai clic su Crea nuovo.
Nella finestra di dialogo Nuova istanza, fai clic su Opzioni avanzate.
Nella finestra di dialogo Crea istanza, nella sezione Dettagli, fornisci le seguenti informazioni per la nuova istanza:
- Nome: specifica 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. Consulta le località di Vertex AI Workbench disponibili.
Nella sezione Integrità del sistema, seleziona Upgrade automatico dell'ambiente.
Scegli se eseguire l'upgrade del blocco note settimanale o mensile.
Nel campo Giorno della settimana, seleziona l'opzione che preferisci.
Nel campo Ora, scegli un'ora del giorno.
Completa il resto della finestra di dialogo di creazione dell'istanza, quindi fai clic su Crea.

Modifica la pianificazione dell'upgrade automatico

Per modificare la pianificazione dell'upgrade automatico dopo aver creato l'istanza di Vertex AI Workbench, completa questi passaggi:

Nella console Google Cloud, vai alla pagina Istanze.

Vai a Istanze
Fai clic sul nome dell'istanza per cui è necessaria la modifica della pianificazione.
Nella sezione Upgrade automatico dell'ambiente della pagina Dettagli istanza, modifica la pianificazione.
Fai clic su Invia per salvare le modifiche.

Upgrade manuale

Puoi eseguire manualmente l'upgrade delle istanze di Vertex AI Workbench che soddisfano i requisiti.

Verifica la presenza di 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.

Nella console Google Cloud, vai alla pagina Istanze.

Vai a Istanze
Fai clic sul nome dell'istanza di cui vuoi verificare la disponibilità di una versione dell'ambiente più recente.
Nella pagina Dettagli istanza, 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 della tua istanza a una versione più recente

Puoi eseguire manualmente l'upgrade di un'istanza di Vertex AI Workbench nella console Google Cloud.

Nella console Google Cloud, vai alla pagina Istanze.

Vai a Istanze
Se l'istanza non è in esecuzione, avviala. Vertex AI Workbench può eseguire l'upgrade delle istanze solo se sono in esecuzione.
Fai clic sul nome dell'istanza di cui vuoi eseguire l'upgrade.
Nella pagina Dettagli istanza, fai clic su Esegui l'upgrade.
Assicurati di aver creato una copia dei dati dell'istanza prima di continuare.
Al termine del backup dei dati, fai clic su Esegui l'upgrade. Vertex AI Workbench esegue l'upgrade e avvia l'istanza.

Esegui il rollback di un upgrade

Per eseguire il rollback di un upgrade, segui questi passaggi:

Nella console Google Cloud, vai alla pagina Istanze.

Vai a Istanze
Fai clic sul nome dell'istanza di cui vuoi eseguire il rollback.
Nella pagina Dettagli istanza, in Cronologia degli upgrade, fai clic su Rollback.
Vertex AI Workbench esegue il rollback dell'istanza alla versione precedente.