Eseguire l'upgrade dell'ambiente di un'istanza
Le istanze di Vertex AI Workbench sono istanze di Deep Learning VM Image con ambienti di notebook 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
Potresti voler eseguire l'upgrade dell'ambiente della tua istanza Vertex AI Workbench 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 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 specificato, Vertex AI Workbench controlla se è possibile eseguire l'upgrade dell'istanza e, in caso affermativo, esegue l'upgrade.
Upgrade manuale: se un'istanza Vertex AI Workbench esistente soddisfa i requisiti per l'upgrade, puoi eseguire l'upgrade manualmente.
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 Vertex AI Workbench specifica, consulta i seguenti requisiti e limitazioni:
L'API Notebooks deve essere abilitata nel progetto Google Cloud dell'istanza. Per ulteriori informazioni, consulta Elenco dei servizi abilitati e Abilitare 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, ti consigliamo di utilizzare il tag
latestnel 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 Vertex AI Workbench.
Come funziona l'upgrade
Le istanze Vertex AI Workbench 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 vengono conservati?
La tabella seguente mostra i componenti della tua istanza di Vertex AI Workbench di cui viene eseguito l'upgrade e quelli che 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 conservata |
| Pacchetti del sistema operativo preinstallati | Upgrade completato |
| Pacchetti del sistema operativo installati dall'utente | Non conservata |
| Driver GPU | Upgrade completato |
| Notebooks | Conservato |
| Configurazioni utente | Conservato |
Librerie installate dall'utente
Per impostazione predefinita, le istanze di Vertex AI Workbench memorizzano 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
contenuto personalizzato, le librerie rimangono persistenti solo durante l'esecuzione del kernel.
Ogni volta che il kernel viene riavviato, queste librerie dovranno essere reinstallate. Per installare librerie permanenti in un contenitore personalizzato,
includere le installazioni delle librerie nel Dockerfile. Quando installi le librerie pip in un kernel creato da un contenitore personalizzato, puoi includere il flag --user in modo che le librerie rimangano fino al riavvio dell'istanza.
Versioni dell'ambiente
L'istanza di Vertex AI Workbench ha un numero di versione dell'ambiente che puoi verificare:
Nella console Google Cloud, vai alla pagina Istanze.
Nell'elenco delle istanze, trova 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 con ogni versione rilasciata non tutti gli ambienti vengono aggiornati. Vertex AI Workbench esegue l'upgrade di un'istanza solo se esiste 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 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 l'upgrade automatico delle istanze in esecuzione. Se l'istanza è interrotta, non viene eseguito automaticamente l'upgrade dell'istanza, 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 archiviato come notebook-upgrade-schedule
voce di metadati, in 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
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 l'upgrade automatico abilitato
Per creare un'istanza di Vertex AI Workbench con l'upgrade automatico attivato, seleziona la casella di controllo Attiva l'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.
Fai clic su Crea nuova.
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: inserisci 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à di Vertex AI Workbench disponibili.
Nella sezione Integrità del sistema, seleziona Upgrade automatico dell'ambiente.
Scegli se eseguire l'upgrade del tuo notebook settimanalmente o mensilmente.
Nel campo Giorno della settimana, seleziona l'opzione che preferisci.
Nel campo Ora, scegli un'ora del giorno.
Completa la parte rimanente della finestra di dialogo di creazione dell'istanza e poi fai clic su Crea.
Modificare la pianificazione dell'upgrade automatico
Per modificare la pianificazione dell'upgrade automatico dopo aver creato l'istanza Vertex AI Workbench:
Nella console Google Cloud, vai alla pagina Istanze.
Fai clic sul nome dell'istanza di cui è necessaria la modifica della pianificazione.
Nella pagina Dettagli istanza, nella sezione Upgrade automatico dell'ambiente, modifica la pianificazione.
Fai clic su Invia per salvare le modifiche.
Upgrade manuale
Puoi eseguire manualmente l'upgrade delle istanze Vertex AI Workbench che soddisfano i requisiti.
Verificare 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.
Nella console Google Cloud, vai alla pagina Istanze.
Fai clic sul nome dell'istanza per la quale 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 dell'istanza a una versione più recente
Puoi eseguire manualmente l'upgrade di un'istanza Vertex AI Workbench nella console Google Cloud.
Nella console Google Cloud, vai alla pagina Istanze.
Se l'istanza non è in esecuzione, avviala. Vertex AI Workbench può eseguire l'upgrade delle istanze solo quando sono in esecuzione.
Fai clic sul nome dell'istanza di cui vuoi eseguire l'upgrade.
Nella pagina Dettagli istanza, fai clic su Esegui upgrade.
Assicurati di aver creato una copia dei dati nell'istanza prima di continuare.
Dopo aver eseguito il backup dei dati, fai clic su Esegui l'upgrade. Vertex AI Workbench esegue l'upgrade e avvia l'istanza.
Esegui upgrade.Esegui il rollback di un upgrade
Per eseguire il rollback di un upgrade:
Nella console Google Cloud, vai alla pagina Istanze.
Fai clic sul nome dell'istanza di cui vuoi eseguire il rollback.
Nella pagina Dettagli istanza, fai clic su Esegui rollback in Cronologia upgrade.
Vertex AI Workbench ripristina la versione precedente dell'istanza.