Questa pagina è stata tradotta dall'API Cloud Translation.

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

Questa pagina descrive come eseguire la migrazione da un'istanza di Notebook gestiti dall'utente a un'istanza di Vertex AI Workbench. Puoi eseguire la migrazione utilizzando lo strumento di migrazione di Vertex AI Workbench o manualmente.

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 una configurazione simile all'istanza di notebook 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. Successivamente, i file sul disco dati dell'istanza di notebook gestita dall'utente vengono copiati nell'istanza 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 hai più bisogno dell'istanza di notebook gestita dall'utente, eliminala per evitare ulteriori addebiti.

Fatturazione

Se l'istanza di notebook gestita dall'utente utilizza i dischi permanenti Extreme, la migrazione genera addebiti per le operazioni di I/O. Consulta "IOPS sottoposte a provisioning estreme" nella sezione Prezzi dei dischi permanenti 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 eseguire la migrazione dell'istanza di notebook gestita 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 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 di Ubuntu	Debian 11
Sistema operativo	Qualsiasi versione di Debian	Debian 11
Framework	Qualsiasi versione CUDA	CUDA 11.3
	Qualsiasi versione di Python	Python 3.10
	Qualsiasi versione di PyTorch	PyTorch 1.13
	Qualsiasi versione di TensorFlow	TensorFlow 2.11
	Qualsiasi versione di R	Non è stata eseguita la migrazione; consulta Aggiungere un ambiente conda
	Qualsiasi versione 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	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
Tipo di macchina	Un tipo di macchina non supportato	`e2-standard-4`
Acceleratori	Acceleratori supportati	Acceleratori identici
Acceleratori	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 script post-avvio, utilizza Google Cloud CLI o l'API REST specificare il Opzione `PostStartupScriptOption`
	Dataproc Hub	Non è stata eseguita la migrazione; è necessaria la migrazione manuale

Specifica dello script post-avvio

Per le istanze di notebook gestiti dall'utente che utilizzano uno script post-avvio, è obbligatoria la migrazione a un'istanza con l'opzione 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 l'opzione PostStartupScriptOption durante la migrazione dell'istanza di Notebook gestita 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

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 notebook gestita 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) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

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 assegnare al tuo account utente queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Controllo pre-migrazione

Prima di eseguire la migrazione, controlla l'idoneità alla migrazione delle istanze di notebook gestite dall'utente elencando le istanze e controllando se nell'output sono presenti avvisi o errori di migrazione.

Elenca le istanze

Per elencare le istanze di notebook gestite 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 API REST:

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua 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 il seguente 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 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 seguente comando 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 consente di accedere automaticamente all'interfaccia a riga di comando 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

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 avvisi o errori di migrazione, l'output del 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 l'istanza di notebook gestita 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 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 di migrazione, consulta avvisi e errori nella documentazione di InstanceMigrationEligibility.

Esegui la migrazione utilizzando lo strumento di migrazione

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

Console

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

Vai a Blocchi note gestiti dall'utente
Fai clic sul pulsante Esegui migrazione.
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.

Vai a Istanze

gcloud

Prima di utilizzare i dati dei comandi riportati di seguito, effettua le seguenti sostituzioni:

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

Esegui il seguente 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 notebook gestiti dall'utente
INSTANCE_ID: l'ID dell'istanza di notebook 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 a l'interfaccia a riga di comando gcloud con il tuo account utente eseguendo gcloud init o gcloud auth login oppure utilizzando Cloud Shell, che ti consente di accedere automaticamente all'interfaccia a riga di comando gcloud di Google. 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 alla CLI 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, 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

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:

Utilizza Cloud Storage e il terminale: copia i dati e i file su Cloud Storage e poi in 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 disporre dell'accesso al terminale all'istanza di Notebook gestita 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 manualmente utilizzando 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 si trova l'istanza di blocchi note gestiti dall'utente.
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.
Nell'interfaccia JupyterLab dell'istanza dei blocchi note gestiti dall'utente, seleziona File > Nuovo > Terminale per aprire una finestra del terminale.
Utilizza la CLI gcloud 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 tuo Bucket Cloud Storage
- PATH: il percorso della directory dove vuoi copiare i file, ad esempio: /copy/jupyter/
Nell'interfaccia JupyterLab della nuova istanza Vertex AI Workbench, seleziona File > Nuovo > Terminale per aprire una finestra del terminale.
Utilizza gcloud CLI per copiare i dati nella nuova istanza. Il seguente comando di esempio 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 di notebook gestiti dall'utente 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 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.

Vai a 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.