Esegui la migrazione da blocchi note gestiti dall'utente a istanze di Vertex AI Workbench

Esegui la migrazione da blocchi note gestiti dall'utente a istanze di Vertex AI Workbench

I blocchi note gestiti dall'utente di Vertex AI Workbench sono stati ritirati. Il 30 gennaio 2025, non sarà più possibile creare istanze di blocchi note gestiti dall'utente e non sarà più possibile creare istanze di blocchi note gestiti dall'utente. Le istanze esistenti continueranno a funzionare, ma non saranno disponibili patch, aggiornamenti e upgrade. Per continuare a utilizzare Vertex AI Workbench, completa i passaggi in questa pagina per eseguire la migrazione delle istanze di blocchi note gestiti dall'utente alle istanze di Vertex AI Workbench.

Questa pagina descrive come eseguire la migrazione da un'istanza di blocchi note gestiti dall'utente a un'istanza di Vertex AI Workbench. Puoi eseguire la migrazione utilizzando lo strumento di migrazione Vertex AI Workbench o eseguire la migrazione manuale dei dati e dei file dell'istanza.

Panoramica dello strumento di migrazione

Vertex AI Workbench offre uno strumento per eseguire la migrazione da un'istanza di blocchi note gestiti dall'utente a un'istanza di Vertex AI Workbench.

Lo strumento di migrazione crea un'istanza di Vertex AI Workbench con una configurazione simile a quella dei blocchi note gestiti dall'utente di cui vuoi eseguire la migrazione. Ad esempio, lo strumento di migrazione crea un'istanza con tipo di macchina, configurazione di rete, impostazioni di arresto per inattività e altre specifiche uguali o simili. I file nel disco dati della tua istanza di blocchi note gestiti dall'utente vengono copiati nell'istanza di Vertex AI Workbench.

Vertex AI Workbench non elimina né modifica l'istanza dei blocchi note gestiti dall'utente, quindi dopo la migrazione puoi continuare a utilizzarla. Se l'istanza di blocchi note gestiti dall'utente non è più necessaria, eliminala per evitare ulteriori addebiti per quell'istanza.

Fatturazione

Se l'istanza di blocchi note gestiti dall'utente utilizza dischi permanenti con carico estremo, la migrazione genera addebiti per le operazioni di I/O. Consulta la sezione "IOPS con provisioning estremo" nella sezione dei prezzi di Persistent Disk e Hyperdisk dei prezzi del disco.

Dopo la migrazione, l'istanza di blocchi note gestiti dall'utente esiste ancora e genera gli addebiti come prima. Se l'istanza di blocchi note gestiti dall'utente non è più necessaria, eliminala per evitare ulteriori addebiti per quell'istanza.

Comportamenti predefiniti dello strumento di migrazione

Lo strumento di migrazione di Vertex AI Workbench tenta di eseguire la migrazione dell'istanza dei blocchi note gestiti dall'utente a un'istanza di Vertex AI Workbench con specifiche corrispondenti. Quando una specifica nell'istanza di blocchi note gestiti dall'utente non è disponibile nelle istanze di Vertex AI Workbench, Vertex AI Workbench utilizza una specifica predefinita, se possibile. Se lo strumento di migrazione non riesce a eseguire la migrazione di una specifica dell'istanza di blocchi note gestiti dall'utente, non esegue la migrazione dell'istanza.

La tabella seguente elenca alcuni dei principali comportamenti di migrazione predefiniti per lo strumento di migrazione.

Categoria	specifica per i blocchi note gestiti dall'utente	Risultato della migrazione
Sistema operativo	Qualsiasi versione Ubuntu	Debian 11
	Qualsiasi versione Debian	Debian 11
Framework	Qualsiasi versione CUDA	CUDA 11.3
	Qualsiasi versione Python	Python 3.10
	Qualsiasi versione di PyTorch	PyTorch 1.13
	Qualsiasi versione di TensorFlow	TensorFlow 2.11
	Qualsiasi versione R	Non è stata eseguita la migrazione; consulta Aggiungere un ambiente conda.
	Qualsiasi versione di PySpark locale	Non è stata eseguita la migrazione; consulta Aggiungere un ambiente conda.
	Qualsiasi versione di XGBoost	Non è stata eseguita la migrazione; consulta Aggiungere un ambiente conda.
	Qualsiasi versione Python di Kaggle	Non è stata eseguita la migrazione; consulta Aggiungere un ambiente conda.
	Qualsiasi versione di Jax	Non è stata eseguita la migrazione; consulta Aggiungere un ambiente conda.
	Qualsiasi versione di Apache Beam	Non è stata eseguita la migrazione; consulta Aggiungere un ambiente conda.
Tipo di macchina	Un tipo di macchina supportato	Tipo di macchina identico
	Un tipo di macchina non supportato	e2-standard-4
Acceleratori	Acceleratori supportati	Acceleratori identici
	Acceleratori non supportati	La migrazione non include acceleratori
Impostazione	Arresto per inattività	Migrazione eseguita
	Elimina nel cestino	Migrazione eseguita
	nbconvert	Migrazione eseguita
	Download del file	Migrazione eseguita
	Accesso al terminale	Migrazione eseguita
Altro	Autorizzazioni di Identity and Access Management	È stata eseguita la migrazione, anche se potrebbero essere necessarie nuove autorizzazioni per utilizzare l'istanza di Vertex AI Workbench.
	Modalità di accesso	Migrazione eseguita
	Rete	Migrazione eseguita
	Script post-avvio	Quando utilizzi la console Google Cloud, la migrazione dell'istanza viene eseguita senza lo script post-avvio. Per eseguire la migrazione dell'istanza con lo script post-avvio, utilizza Google Cloud CLI o l'API REST per specificare l'opzione PostStartupScriptOption
	Dataproc Hub	Non è stata eseguita la migrazione; è necessario eseguire la migrazione manuale

Specificare lo script post-avvio

È necessario eseguire la migrazione delle istanze di blocchi note gestiti dall'utente che utilizzano uno script post-avvio a un'istanza per cui è specificata l'opzione PostStartupScriptOption. Utilizza questa opzione per indicare se vuoi saltare o eseguire nuovamente lo script post-avvio nella nuova istanza di Vertex AI Workbench.

La specifica dell'opzione PostStartupScriptOption non è supportata nella console Google Cloud. Per specificare l'opzione PostStartupScriptOption quando esegui la migrazione dell'istanza di blocchi note gestiti dall'utente, devi utilizzare Google Cloud CLI o l'API REST.

Prima di iniziare

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. 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. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

4. Attiva l'API Notebooks.

   Abilita l'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. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

7. Attiva l'API Notebooks.

   Abilita l'API

8. Se non l'hai ancora fatto, crea un'istanza di blocchi note gestiti dall'utente.

Ruoli obbligatori

Per assicurarti che il tuo account utente disponga delle autorizzazioni necessarie per eseguire la migrazione di un'istanza di blocchi note gestiti dall'utente a un'istanza di Vertex AI Workbench, chiedi all'amministratore di concedere al tuo account utente il ruolo IAM Notebooks Runner (roles/notebooks.runner) per il progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Questo ruolo predefinito contiene le autorizzazioni necessarie per eseguire la migrazione di un'istanza di blocchi note gestiti dall'utente a un'istanza di Vertex AI Workbench. Per visualizzare esattamente le autorizzazioni necessarie, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

Per eseguire la migrazione di un'istanza di blocchi note gestiti dall'utente a un'istanza di Vertex AI Workbench, sono necessarie le seguenti autorizzazioni:

• notebooks.instances.create
• notebooks.instances.get

L'amministratore potrebbe anche essere in grado di assegnare al tuo account utente queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Controllo pre-migrazione

Prima di eseguire la migrazione, verifica l'idoneità alla migrazione dell'istanza di blocchi note gestiti dall'utente elencando le istanze e controllando l'output per verificare la presenza di eventuali avvisi o errori.

Elenca le tue istanze

Per elencare le istanze di blocchi note gestiti dall'utente di cui non è stata ancora eseguita la migrazione, utilizza il metodo projects.locations.instances.list con il filtro migrated:false. Puoi elencarli utilizzando gcloud CLI o l'API REST:

gcloud

Prima di utilizzare qualsiasi dato di comando riportato di seguito, effettua le seguenti sostituzioni:

• PROJECT_ID: il tuo ID progetto
• LOCATION: la regione in cui si trova l'istanza di blocchi note gestiti dall'utente oppure utilizza - per elencare le istanze di tutte le regioni

Esegui questo seguente comando:

Linux, macOS o Cloud Shell

Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto eseguendo gcloud init, oppure gcloud auth login e gcloud config set project.

gcloud notebooks instances list --project=PROJECT_ID \
    --location=LOCATION --filter=migrated:false --format=default

Windows (PowerShell)

Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto eseguendo gcloud init, oppure gcloud auth login e gcloud config set project.

gcloud notebooks instances list --project=PROJECT_ID `
    --location=LOCATION --filter=migrated:false --format=default

Windows (cmd.exe)

Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto eseguendo gcloud init, oppure gcloud auth login e gcloud config set project.

gcloud notebooks instances list --project=PROJECT_ID ^
    --location=LOCATION --filter=migrated:false --format=default

REST

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

• PROJECT_ID: il tuo ID progetto
• LOCATION: la regione in cui si trova l'istanza di blocchi note gestiti dall'utente oppure utilizza - per elencare le istanze di tutte le regioni

Metodo HTTP e URL:

GET https://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances?filter=migrated:false

Per inviare la richiesta, scegli una delle seguenti opzioni:

curl

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti fa accedere automaticamente all'interfaccia a riga di comando di gcloud. . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances?filter=migrated:false"

PowerShell

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando di gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances?filter=migrated:false" | Select-Object -Expand Content

Controllare l'output per verificare la presenza di avvisi o errori

Se vengono rilevati errori o avvisi di migrazione, l'output del metodo projects.locations.instances.list include queste informazioni.

Vengono visualizzati avvisi quando non è possibile eseguire la migrazione di componenti specifici della configurazione dell'istanza di blocchi note gestiti dall'utente alla stessa specifica in un'istanza di Vertex AI Workbench. Ad esempio, se l'istanza di blocchi note gestiti dall'utente utilizza un acceleratore non supportato, nell'output viene visualizzato un avviso. In questo caso, viene eseguita la migrazione dell'istanza senza acceleratori. Puoi collegare gli acceleratori dopo la migrazione. Esamina gli avvisi nell'output, considera i comportamenti predefiniti dello strumento di migrazione e valuta se lo strumento di migrazione è accettabile per la migrazione.

Uno o più errori nell'output indicano che non è possibile eseguire la migrazione dell'istanza dei blocchi note gestiti dall'utente utilizzando lo strumento di migrazione. Devi eseguire la migrazione dell'istanza manualmente.

Per ulteriori informazioni sugli avvisi e sugli errori relativi alla migrazione, consulta avvisi ed errori nella documentazione InstanceMigrationEligibility.

Eseguire la migrazione con lo strumento di migrazione

Puoi eseguire la migrazione dell'istanza dei blocchi note gestiti dall'utente utilizzando la console Google Cloud, gcloud CLI o l'API REST.

Console

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

   Vai a Blocchi note gestiti dall'utente

2. Fai clic sul pulsante Esegui la migrazione.

3. Nella pagina Esegui la migrazione di blocchi note gestiti dall'utente alle istanze, seleziona l'istanza di cui vuoi eseguire la migrazione nella scheda Pronto.

4. Fai clic su Migrate (Esegui migrazione).

5. Al termine della migrazione, vai alla pagina Istanze per visualizzare la nuova istanza di Vertex AI Workbench.

   Vai a Istanze

gcloud

Prima di utilizzare qualsiasi dato di comando riportato di seguito, effettua le seguenti sostituzioni:

• PROJECT_ID: il tuo ID progetto
• LOCATION: la regione in cui si trova l'istanza di blocchi note gestiti dall'utente
• INSTANCE_ID: l'ID dell'istanza di blocchi note gestiti dall'utente
• POST_STARTUP_SCRIPT_OPTION: Facoltativo: una delle opzioni dello script di avvio-avvio

Esegui questo seguente comando:

Linux, macOS o Cloud Shell

Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto eseguendo gcloud init, oppure gcloud auth login e gcloud config set project.

gcloud notebooks instances migrate RUNTIME_ID \
    --project=PROJECT_ID \
    --location=LOCATION \
    --post-startup-script-option=POST_STARTUP_SCRIPT_OPTION

Windows (PowerShell)

Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto eseguendo gcloud init, oppure gcloud auth login e gcloud config set project.

gcloud notebooks instances migrate RUNTIME_ID `
    --project=PROJECT_ID `
    --location=LOCATION `
    --post-startup-script-option=POST_STARTUP_SCRIPT_OPTION

Windows (cmd.exe)

Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto eseguendo gcloud init, oppure gcloud auth login e gcloud config set project.

gcloud notebooks instances migrate RUNTIME_ID ^
    --project=PROJECT_ID ^
    --location=LOCATION ^
    --post-startup-script-option=POST_STARTUP_SCRIPT_OPTION

REST

Prima di utilizzare i dati della richiesta, effettua le seguenti sostituzioni:

• PROJECT_ID: il tuo ID progetto
• LOCATION: la regione in cui si trova l'istanza di blocchi note gestiti dall'utente
• INSTANCE_ID: l'ID dell'istanza di blocchi note gestiti dall'utente
• POST_STARTUP_SCRIPT_OPTION: Facoltativo: una delle opzioni dello script di avvio-avvio

Metodo HTTP e URL:

POST https://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:migrate

Corpo JSON della richiesta:

{
  "postStartupScriptOption": (POST_STARTUP_SCRIPT_OPTION)
}

Per inviare la richiesta, scegli una delle seguenti opzioni:

curl

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti fa accedere automaticamente all'interfaccia a riga di comando di gcloud. . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:migrate"

PowerShell

Nota: il comando seguente presuppone che tu abbia eseguito l'accesso all'interfaccia a riga di comando di gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login . Puoi controllare l'account attualmente attivo eseguendo gcloud auth list.

Salva il corpo della richiesta in un file denominato request.json ed esegui questo comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://notebooks.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:migrate" | Select-Object -Expand Content

Esegui la migrazione manualmente

Per eseguire manualmente la migrazione dell'istanza in un'istanza di Vertex AI Workbench, valuta la possibilità di utilizzare i seguenti metodi:

• Utilizza Cloud Storage e il terminale: copia i dati e i file in Cloud Storage e poi in un'altra istanza utilizzando il terminale.

• Utilizza GitHub: copia i dati e i file in un repository GitHub utilizzando l'estensione Git per JupyterLab.

Questa guida descrive come eseguire la migrazione di dati e file utilizzando Cloud Storage e il terminale.

Requisiti

Devi avere accesso al terminale all'istanza dei blocchi note gestiti dall'utente. L'accesso al terminale viene impostato manualmente quando crei un'istanza. L'impostazione di accesso al terminale non può essere modificata dopo la creazione dell'istanza.

Esegui la migrazione manuale usando Cloud Storage e il terminale

Per eseguire la migrazione di dati e file in una nuova istanza di Vertex AI Workbench utilizzando Cloud Storage e il terminale, segui questi passaggi.

1. Crea un bucket Cloud Storage nello stesso progetto in cui si trova l'istanza dei blocchi note gestiti dall'utente.

2. Nello stesso progetto, devi creare un'istanza di Vertex AI Workbench in cui eseguire la migrazione dei dati. Quando crei questa istanza:

   • Attiva l'accesso al terminale.
   • Specifica il tipo di macchina, la rete e altre caratteristiche in base alle tue esigenze.

3. Nell'interfaccia di JupyterLab della tua istanza di blocchi note gestiti dall'utente, seleziona File > Nuovo > Terminale per aprire una finestra del terminale.

4. Utilizza gsutil tool per copiare i dati utente in un bucket Cloud Storage. Il comando di esempio seguente copia tutti i file dalla directory /home/jupyter/ dell'istanza in una directory in un bucket Cloud Storage.

   gsutil cp -R /home/jupyter/* gs://BUCKET_NAMEPATH
   

   Sostituisci quanto segue:

   • BUCKET_NAME: il nome del tuo bucket Cloud Storage
   • PATH: il percorso della directory in cui vuoi copiare i file, ad esempio: /copy/jupyter/

5. Nell'interfaccia di JupyterLab della nuova istanza di Vertex AI Workbench, seleziona File > Nuovo > Terminale per aprire una finestra del terminale.

6. Utilizza gsutil tool per copiare i dati nella nuova istanza. Il comando di esempio seguente copia tutti i file da una directory Cloud Storage alla directory /home/jupyter/ della nuova istanza.

   gsutil cp gs://BUCKET_NAMEPATH* /home/jupyter/
   

Conferma la migrazione

Dopo la migrazione, l'istanza originale di blocchi note gestiti dall'utente continua a funzionare come prima. Verifica che la migrazione sia andata a buon fine prima di eliminare l'istanza originale.

Elimina l'istanza di blocchi note gestiti dall'utente

Se non hai bisogno dell'istanza di blocchi note gestiti dall'utente da cui hai eseguito la migrazione, eliminala per evitare ulteriori addebiti per quell'istanza.

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

   Vai a Blocchi note gestiti dall'utente

2. Seleziona l'istanza che vuoi eliminare.

3. Fai clic su  Elimina (a seconda delle dimensioni della finestra, il pulsante Elimina potrebbe essere visualizzato nel menu opzioni ).

4. Per confermare, fai clic su Elimina.

Risolvere i problemi

Per trovare i metodi per diagnosticare e risolvere i problemi di migrazione, vedi Risoluzione dei problemi di Vertex AI Workbench.

Passaggi successivi

• Scopri di più sulle istanze di Vertex AI Workbench.