Esegui la migrazione da blocchi note gestiti dall'utente a istanze di Vertex AI Workbench
In questa pagina viene descritto come eseguire la migrazione da da un'istanza di blocchi note gestiti dall'utente a un'istanza di Vertex AI Workbench. Puoi eseguire la migrazione usando lo strumento di migrazione Vertex AI Workbench oppure manualmente i dati e i file dell'istanza.
Panoramica dello strumento di migrazione
Vertex AI Workbench fornisce uno strumento di migrazione 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 simile a quella dei blocchi note gestiti dall'utente di cui vuoi eseguire la migrazione. Ad esempio: Lo strumento di migrazione crea un'istanza uguale o simile tipo di macchina, configurazione di rete, impostazioni di arresto per inattività e altre specifiche. Quindi, i file sul tuo di blocchi note gestiti dall'utente vengono copiati Vertex AI Workbench.
Vertex AI Workbench non elimina né modifica di blocchi note gestiti dall'utente. Dopo la migrazione possa continuare a utilizzarlo. Se non ti occorre istanza di blocchi note gestiti dall'utente eliminala per evitare ulteriori addebiti per l'istanza.
Fatturazione
Se la tua istanza di blocchi note gestiti dall'utente utilizza dischi permanenti con carico estremo, la migrazione genera addebiti per le operazioni di I/O. Vedi "IOPS con provisioning estremo" nel Sezione dei 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 ti serve l'istanza di blocchi note gestiti dall'utente 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 di blocchi note gestiti dall'utente 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. Quando lo strumento di migrazione non può eseguire la migrazione di una specifica della tua istanza di blocchi note gestiti dall'utente, non viene eseguita 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 | Migrazione non eseguita. consulta la sezione Aggiungere un ambiente conda | |
Qualsiasi versione di PySpark locale | Migrazione non eseguita. consulta la sezione Aggiungere un ambiente conda | |
Qualsiasi versione di XGBoost | Migrazione non eseguita. consulta la sezione Aggiungere un ambiente conda | |
Qualsiasi versione Python di Kaggle | Migrazione non eseguita. consulta la sezione Aggiungere un ambiente conda | |
Qualsiasi versione di Jax | Migrazione non eseguita. consulta la sezione Aggiungere un ambiente conda | |
Qualsiasi versione di Apache Beam | Migrazione non eseguita. consulta la sezione 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 per l'utilizzo potrebbero essere necessarie nuove autorizzazioni 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
script post-avvio, utilizza Google Cloud CLI o l'API REST
specificare il
Opzione PostStartupScriptOption
|
|
Dataproc Hub | Migrazione non eseguita. devi eseguire la migrazione manuale |
Specificare lo script post-avvio
Istanze di blocchi note gestiti dall'utente che utilizzano uno script post-avvio
devi eseguire la migrazione a un'istanza con
PostStartupScriptOption
specificata. Utilizza questa opzione per indicare se vuoi
ignora o esegui nuovamente lo script post-avvio nel nuovo
Vertex AI Workbench.
La specifica dell'opzione PostStartupScriptOption
non è supportata
nella console Google Cloud. Per specificare
Opzione PostStartupScriptOption
quando esegui la migrazione
dell'istanza di blocchi note gestiti dall'utente,
usa 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 già fatto, creazione un'istanza di blocchi note gestiti dall'utente.
Ruoli obbligatori
Per assicurarti che il tuo account utente disponga degli
autorizzazioni 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 la
Esecutore blocchi note (roles/notebooks.runner
)
ruolo IAM per il progetto.
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.
Questo ruolo predefinito contiene delle autorizzazioni necessarie per eseguire la migrazione di un'istanza di blocchi note gestiti dall'utente a un'istanza di Vertex AI Workbench. Per vedere le autorizzazioni esatte obbligatorie, 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 fornire il tuo account utente queste autorizzazioni con ruoli personalizzati altri ruoli predefiniti.
Controllo pre-migrazione
Prima di eseguire la migrazione, controlla l'istanza l'idoneità alla migrazione elencando le istanze e controllando l'output per eventuali avvisi o errori relativi alla migrazione.
Elenca le tue istanze
per elencare le istanze di blocchi note gestiti dall'utente che non sono
è già stata eseguita, utilizza
projects.locations.instances.list
con il filtro migrated:false
. Puoi elencarli utilizzando
gcloud CLI o API REST:
gcloud
Prima di utilizzare uno qualsiasi dei dati di comando riportati di seguito, effettua le seguenti sostituzioni:
PROJECT_ID
: il tuo ID progettoLOCATION
: 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 la persone che seguo :
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, effettua le seguenti sostituzioni:
PROJECT_ID
: il tuo ID progettoLOCATION
: 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
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
Controllare l'output per verificare la presenza di avvisi o errori
Se vengono rilevati errori o avvisi relativi alla migrazione, l'output
il metodo projects.locations.instances.list
include queste informazioni.
Gli avvisi vengono visualizzati quando componenti specifici della configurazione dell'istanza di blocchi note gestiti dall'utente eseguire la migrazione alla stessa specifica in un'istanza di Vertex AI Workbench. Ad esempio, se la tua istanza di blocchi note gestiti dall'utente utilizza un acceleratore non supportato, viene visualizzato un avviso nell'output. In questo caso, la migrazione dell'istanza viene eseguita senza acceleratori. Puoi allegare degli acceleratori dopo la migrazione. Rivedi gli avvisi in l'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 è possibile eseguire la migrazione dell'istanza di blocchi note gestiti dall'utente mediante lo strumento di migrazione. Devi eseguire la migrazione dell'istanza manualmente.
Per ulteriori informazioni su avvisi ed errori relativi alla migrazione, vedi
avvisi
ed errori
nella documentazione InstanceMigrationEligibility
.
Eseguire la migrazione con lo strumento di migrazione
Puoi eseguire la migrazione della tua istanza di blocchi note gestiti dall'utente utilizzando la console Google Cloud, gcloud CLI o l'API REST.
Console
Nella console Google Cloud, vai alla pagina Blocchi note gestiti dall'utente.
Fai clic sul pulsante Migrate.
Nella pagina Esegui la migrazione di blocchi note gestiti dall'utente alle istanze, Nella scheda Pronto, seleziona l'istanza di cui vuoi eseguire la migrazione.
Fai clic su Migrate (Esegui migrazione).
Al termine della migrazione, vai alla pagina Istanze per visualizzare la nuova istanza di Vertex AI Workbench.
gcloud
Prima di utilizzare uno qualsiasi dei dati di comando riportati di seguito, effettua le seguenti sostituzioni:
PROJECT_ID
: il tuo ID progettoLOCATION
: la regione in cui si trova l'istanza di blocchi note gestiti dall'utenteINSTANCE_ID
: l'ID dell'istanza di blocchi note gestiti dall'utentePOST_STARTUP_SCRIPT_OPTION
: Facoltativo: una delle opzioni dello script di avvio-avvio
Esegui la persone che seguo :
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, effettua le seguenti sostituzioni:
PROJECT_ID
: il tuo ID progettoLOCATION
: la regione in cui si trova l'istanza di blocchi note gestiti dall'utenteINSTANCE_ID
: l'ID dell'istanza di blocchi note gestiti dall'utentePOST_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
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
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 a un'istanza di Vertex AI Workbench, prendi in considerazione l'utilizzo dei seguenti metodi:
Utilizzare Cloud Storage e il terminale: copia dati e file in Cloud Storage e poi a un'altra istanza utilizzando il terminale.
Utilizza GitHub. Copia dati e 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 per di blocchi note gestiti dall'utente. L'accesso al terminale viene impostato manualmente quando crei un'istanza. La 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
Eseguire la migrazione di dati e file a una nuova istanza di Vertex AI Workbench. utilizzando Cloud Storage e il terminale, procedi nel seguente modo.
Crea un bucket Cloud Storage nello stesso progetto in cui è presente l'istanza dei blocchi note gestiti dall'utente in cui viene localizzato.
Nello stesso progetto, Crea 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'istanza di blocco note gestito dall'utente Interfaccia JupyterLab, seleziona File > Nuovo > Terminale per aprire una finestra del terminale.
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 in un bucket Cloud Storage.gcloud storage cp /home/jupyter/* gs://BUCKET_NAMEPATH --recursive
Sostituisci quanto segue:
BUCKET_NAME
: il nome del tuo Bucket Cloud StoragePATH
: il percorso della directory dove vuoi copiare i file, ad esempio:/copy/jupyter/
Nel codice della nuova istanza di Vertex AI Workbench Interfaccia JupyterLab, seleziona File > Nuovo > Terminale per aprire una finestra del terminale.
Utilizza gcloud CLI 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.gcloud storage 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. Conferma l'esito della migrazione 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, eliminalo per evitare ulteriori addebiti per l'istanza.
Nella console Google Cloud, vai alla pagina Blocchi note gestiti dall'utente.
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.
Risoluzione dei problemi
Per trovare i metodi per diagnosticare e risolvere i problemi di migrazione, vedi Risoluzione dei problemi Vertex AI Workbench.
Passaggi successivi
- Scopri di più sulle istanze di Vertex AI Workbench.