Esegui la migrazione da blocchi note gestiti a istanze di Vertex AI Workbench
Questa pagina descrive come eseguire la migrazione da un'istanza di blocchi note gestiti 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 a un'istanza di Vertex AI Workbench.
Lo strumento di migrazione crea un'istanza di Vertex AI Workbench con una configurazione simile all'istanza dei blocchi note gestiti 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 vengono copiati nell'istanza di Vertex AI Workbench.
Vertex AI Workbench non elimina né modifica l'istanza dei blocchi note gestiti, quindi dopo la migrazione puoi continuare a utilizzarla. Se l'istanza di blocchi note gestiti non ti serve più, eliminala per evitare ulteriori addebiti per l'istanza.
Fatturazione
Se l'istanza di blocchi note gestiti 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 dischi permanenti e hyperdisk dei prezzi dei dischi.
Dopo la migrazione, l'istanza di blocchi note gestiti esiste ancora e genera gli addebiti come prima. Se l'istanza di blocchi note gestiti non ti serve più, eliminala per evitare ulteriori addebiti per l'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 a un'istanza di Vertex AI Workbench con specifiche corrispondenti. Quando una specifica nell'istanza di blocchi note gestiti 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 della tua istanza di blocchi note gestiti, non esegue la migrazione dell'istanza.
La tabella seguente elenca alcuni dei principali comportamenti di migrazione predefiniti per lo strumento di migrazione.
Categoria | Specifica dei blocchi note gestiti | 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. Le istanze che utilizzano la modalità di accesso JupyterLab per utente singolo devono
specificare l'opzione serviceAccount
|
|
Rete | Migrazione eseguita; le istanze che utilizzano un Virtual Private Cloud gestito da Google devono
specificare le opzioni network e
subnet
|
|
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 le opzioni
Le sezioni seguenti descrivono i casi in cui è necessario specificare un'opzione per eseguire la migrazione dell'istanza dei blocchi note gestiti a un'istanza di Vertex AI Workbench.
Istanze che utilizzano la modalità di accesso per singolo utente
È necessario eseguire la migrazione delle istanze di blocchi note gestiti che utilizzano la modalità di accesso a un utente singolo a un'istanza con l'opzione serviceAccount
specificata.
L'istanza di Vertex AI Workbench di cui esegui la migrazione per limitare l'accesso a JupyterLab a un singolo utente utilizza un account di servizio per interagire con i servizi e le API di Google Cloud.
Istanze che utilizzano un VPC gestito da Google
È necessario eseguire la migrazione delle istanze di blocchi note gestiti che utilizzano un VPC gestito da Google a un'istanza con le opzioni network
e subnet
specificate.
L'opzione per utilizzare un VPC gestito da Google non è supportata nelle istanze di Vertex AI Workbench, perciò è necessario specificare una rete diversa.
Istanze che utilizzano uno script post-avvio
È necessario eseguire la migrazione delle istanze di blocchi note gestiti che utilizzano uno script post-avvio a un'istanza con l'opzione PostStartupScriptOption
specificata. 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, devi utilizzare Google Cloud CLI o l'API REST.
Prima di iniziare
- 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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Attiva l'API Notebooks.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.
-
Attiva l'API Notebooks.
- Se non l'hai ancora fatto, crea un'istanza di blocchi note gestiti.
Ruoli obbligatori
Per assicurarti che il tuo account utente disponga delle autorizzazioni necessarie per eseguire la migrazione di un'istanza di blocchi note gestiti a un'istanza di Vertex AI Workbench, chiedi all'amministratore di concedere all'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 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 a un'istanza di Vertex AI Workbench sono necessarie le seguenti autorizzazioni:
-
notebooks.runtimes.create
-
notebooks.runtimes.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 elencando le istanze e controllando l'output per verificare la presenza di eventuali avvisi o errori relativi alla migrazione.
Elenca le tue istanze
Per elencare le istanze di blocchi note gestiti di cui non è stata ancora eseguita la migrazione, utilizza il metodo projects.locations.runtimes.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 progettoLOCATION
: la regione in cui si trova l'istanza di blocchi note gestiti oppure utilizza-
per elencare le istanze di tutte le regioni
Esegui questo seguente comando:
Linux, macOS o Cloud Shell
gcloud notebooks runtimes list --project=PROJECT_ID \ --location=LOCATION --filter=migrated:false --format=default
Windows (PowerShell)
gcloud notebooks runtimes list --project=PROJECT_ID ` --location=LOCATION --filter=migrated:false --format=default
Windows (cmd.exe)
gcloud notebooks runtimes 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 progettoLOCATION
: la regione in cui si trova l'istanza di blocchi note gestiti 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/runtimes?filter=migrated:false
Per inviare la richiesta, scegli una delle seguenti 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/runtimes?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/runtimes?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.runtimes.list
include queste informazioni.
Gli avvisi vengono visualizzati quando non è possibile eseguire la migrazione di componenti specifici della configurazione dell'istanza di blocchi note gestiti alla stessa specifica in un'istanza di Vertex AI Workbench. Ad esempio, se la tua istanza di blocchi note gestiti 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 puoi eseguire la migrazione dell'istanza dei blocchi note gestiti 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 RuntimeMigrationEligibility
.
Eseguire la migrazione con lo strumento di migrazione
Puoi eseguire la migrazione dell'istanza dei blocchi note gestiti utilizzando la console Google Cloud, gcloud CLI o l'API REST.
Console
Nella console Google Cloud, vai alla pagina Blocchi note gestiti.
Fai clic sul pulsante Esegui la migrazione. Si apre la pagina Esegui la migrazione di blocchi note gestiti alle istanze.
Per eseguire la migrazione di istanze che non richiedono opzioni specificate, fai clic sulla scheda Pronto, seleziona le istanze di cui desideri eseguire la migrazione e fai clic su Esegui la migrazione.
Per eseguire la migrazione di istanze che richiedono la specifica delle opzioni, fai clic sulla scheda Richiede input, seleziona le istanze di cui vuoi eseguire la migrazione e fai clic su Esegui la migrazione.
Nella finestra di dialogo Fornisci input per la migrazione, specifica un account di rete e di servizio da utilizzare per le nuove istanze di Vertex AI Workbench selezionate.
Fai clic su Invia.
Al termine delle migrazioni, vai alla pagina Istanze per visualizzare le nuove istanze di Vertex AI Workbench.
gcloud
Prima di utilizzare qualsiasi dato di comando riportato di seguito, effettua le seguenti sostituzioni:
PROJECT_ID
: il tuo ID progettoLOCATION
: la regione in cui si trova l'istanza di blocchi note gestitiRUNTIME_ID
: l'ID dell'istanza di blocchi note gestitiNETWORK
(Facoltativo) La rete su cui vuoi eseguire la migrazione dell'istanzaSUBNET
(Facoltativo) La subnet in cui vuoi eseguire la migrazione dell'istanzaSERVICE_ACCOUNT
: (facoltativo) l'indirizzo email dell'account di servizio che vuoi utilizzarePOST_STARTUP_SCRIPT_OPTION
: Facoltativo: una delle opzioni dello script di avvio-avvio
Esegui questo seguente comando:
Linux, macOS o Cloud Shell
gcloud notebooks runtimes migrate RUNTIME_ID \ --project=PROJECT_ID \ --location=LOCATION \ --network=NETWORK \ --subnet=SUBNET \ --service-account=SERVICE_ACCOUNT \ --post-startup-script-option=POST_STARTUP_SCRIPT_OPTION
Windows (PowerShell)
gcloud notebooks runtimes migrate RUNTIME_ID ` --project=PROJECT_ID ` --location=LOCATION ` --network=NETWORK ` --subnet=SUBNET ` --service-account=SERVICE_ACCOUNT ` --post-startup-script-option=POST_STARTUP_SCRIPT_OPTION
Windows (cmd.exe)
gcloud notebooks runtimes migrate RUNTIME_ID ^ --project=PROJECT_ID ^ --location=LOCATION ^ --network=NETWORK ^ --subnet=SUBNET ^ --service-account=SERVICE_ACCOUNT ^ --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 progettoLOCATION
: la regione in cui si trova l'istanza di blocchi note gestitiRUNTIME_ID
: l'ID dell'istanza di blocchi note gestitiNETWORK
(Facoltativo) La rete su cui vuoi eseguire la migrazione dell'istanzaSUBNET
(Facoltativo) La subnet in cui vuoi eseguire la migrazione dell'istanzaSERVICE_ACCOUNT
: (facoltativo) l'indirizzo email dell'account di servizio che vuoi utilizzarePOST_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/runtimes/RUNTIME_ID:migrate
Corpo JSON della richiesta:
{ "network": NETWORK, "subnet": SUBNET, "serviceAccount": SERVICE_ACCOUNT_EMAIL_ADDRESS, "postStartupScriptOption": (POST_STARTUP_SCRIPT_OPTION) }
Per inviare la richiesta, scegli una delle seguenti opzioni:
curl
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/runtimes/RUNTIME_ID:migrate"
PowerShell
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/runtimes/RUNTIME_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 nel terminale alla tua istanza di blocchi note gestiti. 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.
Crea un bucket Cloud Storage nello stesso progetto in cui si trova l'istanza dei blocchi note gestiti.
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.
Nell'interfaccia di JupyterLab della tua istanza di blocchi note gestiti, seleziona File > Nuovo > Terminale per aprire una finestra del terminale.
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 StoragePATH
: il percorso della directory in cui vuoi copiare i file, ad esempio:/copy/jupyter/
Nell'interfaccia di JupyterLab della nuova istanza di Vertex AI Workbench, seleziona File > Nuovo > Terminale per aprire una finestra del terminale.
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 di blocco note gestita originale continuerà 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
Se non hai bisogno dell'istanza di blocchi note gestiti da cui hai eseguito la migrazione, eliminala per evitare ulteriori addebiti per quell'istanza.
Nella console Google Cloud, vai alla pagina Blocchi note gestiti.
Seleziona l'istanza che vuoi eliminare.
Fai clic su
Elimina (a seconda delle dimensioni della finestra, il pulsante Elimina potrebbe essere visualizzato nel menu opzioni ).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.