Esegui la migrazione dai notebook gestiti dall'utente alle istanze Vertex AI Workbench

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

Panoramica dello strumento di migrazione

Vertex AI Workbench fornisce uno strumento di migrazione per eseguire la migrazione da un'istanza di notebook 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 all'istanza di notebook gestiti dall'utente che vuoi migrare. Ad esempio, lo strumento di migrazione crea un'istanza con tipo di macchina, configurazione di rete, impostazioni di arresto inattivo e altre specifiche uguali o simili. Poi, i file sul disco dati dell'istanza di blocchi note gestiti dall'utente vengono copiati nell'istanza Vertex AI Workbench.

Vertex AI Workbench non elimina né modifica l'istanza di notebook gestiti dall'utente, quindi dopo la migrazione puoi continuare a utilizzarla. Se non hai più bisogno dell'istanza di notebook gestiti dall'utente, eliminala per evitare ulteriori addebiti per quell'istanza.

Fatturazione

Se l'istanza di notebook gestiti dall'utente utilizza dischi permanenti Extreme, la migrazione genera addebiti per le operazioni di I/O. Consulta "IOPS di cui è stato eseguito il provisioning estreme" nella sezione Prezzi di Persistent Disk e Hyperdisk di Prezzi dei dischi.

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

Comportamenti predefiniti dello strumento di migrazione

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

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

Specifica dello script post-avvio

Le istanze di notebook gestiti dall'utente che utilizzano uno script post-avvio devono essere migrate a un'istanza con l'opzione PostStartupScriptOption specificata. Utilizza questa opzione per indicare se vuoi ignorare o eseguire di nuovo lo script post-avvio nella nuova istanza 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 notebook gestiti dall'utente, devi utilizzare Google Cloud CLI o l'API REST.

Prima di iniziare

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.

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

Go to project selector

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

Enable the Notebooks API.

Enable the API

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

Go to project selector

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

Enable the Notebooks API.

Enable the API

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

Ruoli obbligatori

Per ottenere le 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 concederti il ruolo IAM Notebooks Runner (roles/notebooks.runner) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Questo ruolo predefinito contiene le autorizzazioni necessarie per eseguire la migrazione di un'istanza di notebook gestiti dall'utente a un'istanza di Vertex AI Workbench. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:

Autorizzazioni obbligatorie

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

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

Potresti anche ottenere queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Controllo pre-migrazione

Prima di eseguire la migrazione, controlla l'idoneità alla migrazione dell'istanza dei notebook gestiti dall'utente elencando le istanze e controllando l'output per eventuali avvisi o errori di migrazione.

Elenca le istanze

Per elencare le istanze di blocchi note gestite dall'utente che non sono ancora state migrate, 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 i dati dei comandi riportati di seguito, apporta le seguenti sostituzioni:

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

Esegui questo comando:

Linux, macOS o Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

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

REST

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

• PROJECT_ID: il tuo ID progetto
• LOCATION: la regione in cui si trova l'istanza di notebook 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 di queste opzioni:

curl

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

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

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

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

Gli avvisi vengono visualizzati quando componenti specifici nella configurazione dell'istanza di notebook gestiti dall'utente non verranno migrati 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, la migrazione dell'istanza viene eseguita 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 tua migrazione.

Uno o più errori nell'output indicano che non puoi eseguire la migrazione dell'istanza di notebook gestiti dall'utente utilizzando lo strumento di migrazione. Devi eseguire manualmente la migrazione dell'istanza.

Per ulteriori informazioni su avvisi ed errori di migrazione, consulta le sezioni relative ad avvisi ed errori nella documentazione di InstanceMigrationEligibility.

Eseguire la migrazione utilizzando lo strumento di migrazione

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

Console

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

   Vai a Blocchi note gestiti dall'utente

2. Fai clic sul pulsante Esegui migrazione.

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

4. Fai clic su Migrate (Esegui migrazione).

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

   Vai a Istanze

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, apporta 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 di script di avvio-avvio

Esegui questo comando:

Linux, macOS o Cloud Shell

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

Windows (PowerShell)

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

Windows (cmd.exe)

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, apporta 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 di 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 di queste opzioni:

curl

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

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

Salva il corpo della richiesta in un file denominato request.json, quindi esegui il comando seguente:

$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

Eseguire la migrazione manualmente

Per eseguire manualmente la migrazione dell'istanza a un'istanza 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 disporre dell'accesso al terminale all'istanza di notebook 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 manualmente utilizzando Cloud Storage e il terminale

Per eseguire la migrazione di dati e file a una nuova istanza Vertex AI Workbench utilizzando Cloud Storage e il terminale, svolgi i seguenti passaggi.

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

2. Nello stesso progetto, crea un'istanza di Vertex AI Workbench a 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 JupyterLab dell'istanza di blocchi note gestiti dall'utente, seleziona File > Nuovo > Terminale per aprire una finestra del terminale.

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

   gcloud storage cp /home/jupyter/* gs://BUCKET_NAMEPATH --recursive

   Sostituisci quanto segue:

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

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

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

   gcloud storage cp gs://BUCKET_NAMEPATH* /home/jupyter/ --recursive

Confermare la migrazione

Dopo la migrazione, l'istanza originale dei notebook gestiti dall'utente continua a funzionare come prima. Prima di eliminare l'istanza originale, verifica che la migrazione sia stata eseguita correttamente.

Elimina l'istanza di blocchi note gestiti dall'utente

Se non hai bisogno dell'istanza di notebook 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 Notebook gestiti dall'utente.

   Vai a Blocchi note gestiti dall'utente

2. Seleziona l'istanza che vuoi eliminare.

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

4. Per confermare, fai clic su Elimina.

Risoluzione dei problemi

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

Passaggi successivi

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