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

Le istanze di blocchi note gestite dall'utente di Vertex AI Workbench sono istanze di Deep Learning VM Images con ambienti di blocchi note 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 eseguire l'upgrade

Ti consigliamo di eseguire l'upgrade dell'ambiente dell'istanza di blocchi note gestiti dall'utente 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 blocchi note gestiti dall'utente:

  • Upgrade automatico: abilita l'upgrade automatico quando crei un'istanza di blocchi note gestiti dall'utente. 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 di blocchi note gestiti dall'utente esistente soddisfa i requisiti per l'upgrade, puoi eseguire manualmente l'upgrade dell'istanza.

Requisiti e limitazioni

La compatibilità con le versioni precedenti dei blocchi note 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 una specifica istanza di blocchi note gestiti dall'utente, 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.

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

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

  • Se l'istanza di blocchi note 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 nel Dockerfile.

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

Come funziona l'upgrade

Le istanze dei blocchi note gestiti dall'utente 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 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 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
Blocchi note 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 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

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 blocchi note gestiti dall'utente, consulta 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 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 isUpgradeable. 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 blocchi note gestiti dall'utente con upgrade automatico abilitato

Per creare un'istanza di blocchi note gestiti dall'utente con l'upgrade automatico abilitato, seleziona la casella di controllo Abilita l'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 Notebooks gestiti dall'utente, devi avere un progetto Google Cloud e abilitare l'API Notebooks per quel progetto.
  1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

  2. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

    Vai al selettore progetti

  3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

  4. Attiva l'API Notebooks.

    Abilita l'API

    5.

  5. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

    Vai al selettore progetti

  6. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

  7. Attiva l'API Notebooks.

    Abilita l'API

    8.

  8. Se prevedi di utilizzare GPU con la tua istanza di blocchi note gestiti dall'utente, controlla la pagina delle 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 delle quote o se hai bisogno di una quota GPU aggiuntiva, puoi richiedere un aumento della quota. Consulta Richiesta di un aumento della quota nella pagina Quote delle risorse di Compute Engine.

Ruoli obbligatori

Se hai creato tu 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 la tua istanza di blocchi note gestiti dall'utente. Se non hai creato tu il progetto, continua in questa sezione.

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

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

L'amministratore potrebbe anche essere in grado di concedere al tuo account utente le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Crea l'istanza

Console

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

    Vai ai blocchi note gestiti dall'utente

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

  3. Nella sezione Dettagli della pagina Crea un blocco note gestito dall'utente, 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 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 il resto della finestra di dialogo di creazione dell'istanza, quindi fai clic su Crea.

gcloud

  1. Da Cloud Shell o da 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 della nuova istanza
    • SCHEDULE: la pianificazione settimanale o mensile impostata, in formato unix-cron; ad esempio, "00 19 * * MON" indica ogni settimana il lunedì alle 1900 ore ora di Greenwich (GMT)
    • VM_IMAGE_FAMILY: il nome della famiglia di immagini da utilizzare per creare l'istanza.
    • MACHINE_TYPE: il tipo di macchina della VM dell'istanza
    • LOCATION: la località Google Cloud in cui vuoi che si trovi la nuova istanza

  2. Accedi all'istanza dalla console Google Cloud.

Modifica la pianificazione dell'upgrade automatico

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

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

    Vai ai blocchi note gestiti dall'utente

  2. Fai clic sul nome dell'istanza per cui è necessaria la modifica della pianificazione.

  3. Nella sezione Upgrade automatico dell'ambiente della pagina Dettagli blocco note, 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.

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.

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

    Vai ai blocchi note gestiti dall'utente

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

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

  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, 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 blocchi note gestiti dall'utente nella console Google Cloud o utilizzando Google Cloud CLI.

Console

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

    Vai ai blocchi note gestiti dall'utente

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

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

  4. Nella pagina Dettagli blocco note, fai clic su  Esegui l'upgrade.

  5. Assicurati di aver creato una copia dei dati dell'istanza prima di continuare.

  6. Al termine del 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 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 località Google Cloud in cui si trova l'istanza

    Se è possibile aggiornare l'istanza, 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, avviala. Vertex AI Workbench può eseguire l'upgrade delle istanze solo se sono in esecuzione.

  3. Assicurati di aver creato una copia dei dati dell'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, segui questi passaggi:

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

    Vai ai blocchi note gestiti dall'utente

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

  3. Nella pagina Dettagli blocco note, in Cronologia degli upgrade, fai clic su Rollback.

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