Registrazione di un'istanza legacy con l'API Notebooks

Questa pagina mostra come eseguire la migrazione e registrare un'istanza di notebook gestiti dall'utente legacy con l'API Notebooks. Le istanze create utilizzando l'API Compute Engine sono chiamate "istanze legacy". Le istanze legacy non dispongono degli aggiornamenti più recenti alle funzionalità.

Per utilizzare le nuove funzionalità disponibili con l'API Notebooks, devi registrare le tue istanze legacy con l'API Notebooks. Prima di registrare le istanze legacy, verifica se soddisfano i requisiti. Puoi migrate le istanze che non soddisfano i requisiti.

Se attivi l'API Notebooks prima di registrare le tue istanze legacy, il processo di attivazione dell'API Notebooks tenta di registrare automaticamente le istanze legacy esistenti.

Requisiti e limitazioni

Prima di registrare le istanze legacy con l'API Notebooks, tieni presente i seguenti requisiti e limitazioni.

  • Le zone di origine e di destinazione devono corrispondere ed essere una zona valida per l'API Notebooks.

    Ad esempio, un'istanza di notebook gestiti dall'utente legacy in us-west1-a rimane in us-west1-a quando viene registrata con l'API Notebooks. Tuttavia, un'istanza di notebook gestiti dall'utente legacy in us-central1-f non verrà registrata con l'API Notebooks perché us-central1-f non è una zona valida per l'API Notebooks.

    Per ottenere un elenco delle zone valide per le istanze di notebook dell'API Notebooks, esegui il comando seguente utilizzando Google Cloud CLI nel terminale che preferisci o in Cloud Shell:

    gcloud notebooks locations list

    Se la zona dell'istanza legacy non è una zona valida per l'API Notebooks, puoi contattare l'assistenza o il tuo account manager oppure puoi migrare l'istanza legacy a una nuova istanza di notebook gestiti dall'utente.

  • Solo le istanze con due dischi possono utilizzare tutte le funzionalità dei notebook gestiti dall'utente.

    Le istanze legacy a disco singolo non possono utilizzare alcune funzionalità dei notebook gestiti dall'utente, come l'upgrade automatico, anche dopo la registrazione con l'API Notebooks. Per consentire all'istanza legacy con un solo disco di utilizzare tutte le funzionalità disponibili, devi migrare l'istanza con un solo disco a un'istanza con due dischi.

    Puoi eseguire la migrazione dell'istanza a un solo disco a un'istanza a due dischi nell'ambito della migrazione da un'istanza legacy a un'istanza registrata con l'API Notebooks. Se hai già registrato l'istanza legacy con l'API Notebooks, puoi comunque eseguire la migrazione dell'istanza a una nuova istanza dual-disk per risolvere il problema.

    Per verificare il numero di dischi, completa i seguenti passaggi.

    Console

    1. Nella console Google Cloud , vai alla pagina Istanze VM.

      Vai a Istanze VM

    2. Trova l'istanza attuale di blocchi note gestiti dall'utente legacy.

    3. Fai clic sul nome dell'istanza per aprire la pagina Dettagli istanza VM.

    4. Nelle sezioni Disco di avvio e Dischi aggiuntivi, verifica il numero di dischi collegati alla VM.

    gcloud

    1. In Cloud Shell o in qualsiasi ambiente in cui è installata Google Cloud CLI, inserisci il seguente comando Google Cloud CLI:

      gcloud compute instances describe MY_INSTANCE_NAME \
    --zone=MY_ZONE

      Sostituisci quanto segue:

      • MY_INSTANCE_NAME: il nome dell'istanza
      • MY_ZONE: la zona dell'istanza

    2. Esamina le informazioni che seguono dischi: e verifica quanti dischi sono collegati alla VM.

Esegui la migrazione di un'istanza legacy a una nuova istanza di blocchi note gestiti dall'utente

Se la tua istanza legacy di blocchi note gestiti dall'utente si trova in una zona che non è valida per l'API Notebooks o se vuoi eseguire la migrazione da un'istanza a disco singolo a un'istanza a doppio disco, devi creare un'istanza di blocchi note gestiti dall'utente e copiare i dati utente dall'istanza legacy alla nuova istanza.

Per creare un'istanza di blocchi note gestiti dall'utente e copiare i dati utente dall'istanza legacy alla nuova istanza, completa i seguenti passaggi:

  1. Per utilizzare ssh per connetterti all'istanza legacy, in Cloud Shell o in qualsiasi ambiente in cui è installata Google Cloud CLI, inserisci il seguente comando Google Cloud CLI:

    export PROJECT_ID="MY_PROJECT_ID"
export ZONE="MY_ZONE"
export INSTANCE_NAME="MY_INSTANCE"
gcloud compute ssh \
    --project $PROJECT_ID \
    --zone $ZONE $INSTANCE_NAME \
    -- -L 8080:localhost:8080

    Sostituisci quanto segue:

    • MY_PROJECT_ID: l'ID del tuo progetto Google Cloud
    • MY_ZONE: la zona dell'istanza
    • MY_INSTANCE: il nome dell'istanza con le informazioni pertinenti.

  2. Per copiare i contenuti dell'istanza legacy in un bucket Cloud Storage, utilizza gcloud storage. Il seguente comando di esempio copia tutti i file del notebook (.ipynb) dalla directory predefinita /home/jupyter/ a una directory Cloud Storage denominata my-bucket/legacy-notebooks.

    gcloud storage cp /home/jupyter/*.ipynb gs://my-bucket/legacy-notebooks/ --recursive

  3. Crea un'istanza di notebook gestiti dall'utente con le stesse specifiche hardware dell'istanza legacy. Puoi creare l'istanza utilizzando la Google Cloud console o Google Cloud CLI.

    In questo esempio, Vertex AI Workbench crea un'istanza di notebook gestiti dall'utente denominata new-notebook nel progetto example utilizzando l'ultima immagine TensorFlow 2, con un tipo di macchina n1-standard-1, nella zona us-west1-a.

    In Cloud Shell o in qualsiasi ambiente in cui è installata Google Cloud CLI, inserisci il seguente comando Google Cloud CLI:

    gcloud notebooks instances create new-notebook \
    --vm-image-project=example \
    --vm-image-family=tf-latest-cpu \
    --machine-type=n1-standard-1 \
    --location=us-west1-a

    La nuova istanza di blocchi note gestiti dall'utente è dual-disk. Ha un disco di avvio e un disco di dati.

  4. Utilizza ssh per connetterti all'istanza di blocchi note gestiti dall'utente che hai appena creato.

  5. Per copiare i contenuti dell'istanza legacy dal bucket Cloud Storage alla nuova istanza, utilizza gcloud storage. Il seguente comando di esempio copia tutti i file del notebook (.ipynb) dalla directory Cloud Storage alla directory /home/jupyter/ della nuova istanza.

    gcloud storage cp gs://my-bucket/legacy-notebooks/*.ipynb  /home/jupyter/ --recursive

  6. Nella nuova istanza di blocchi note gestiti dall'utente, apri JupyterLab e verifica che i dati e gli asset dell'utente siano stati copiati correttamente.

  7. (Facoltativo) Elimina l'istanza legacy.

Registrazione di un'istanza legacy con l'API Notebooks

Per utilizzare l'API Notebooks per gestire le tue istanze legacy, devi registrarle con l'API Notebooks.

Se abiliti l'API Notebooks prima di registrare le tue istanze legacy, il processo di attivazione dell'API Notebooks tenta di registrare automaticamente le tue istanze legacy esistenti. Se crei istanze legacy dopo l'attivazione dell'API Notebooks, devi registrarle manualmente utilizzando uno dei seguenti metodi.

Per registrare la tua istanza legacy con l'API Notebooks, puoi utilizzare la console Google Cloud o l'API Notebooks.

Console

Per utilizzare l'opzione Registra tutto nella console Google Cloud , completa i seguenti passaggi:

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

    Vai a Notebook gestiti dall'utente

  2. Se hai una o più istanze notebook legacy gestite dall'utente, viene visualizzato un messaggio che indica che devi registrarle con l'API Notebooks. Accanto a questo messaggio, fai clic su Registra tutto.

  3. Se non hai istanze legacy di notebook gestiti dall'utente, ma non hai ancora abilitato l'API Notebooks, fai clic su Abilita API Notebooks per assicurarti che le nuove istanze di notebook gestiti dall'utente vengano create utilizzando l'API Notebooks.

API Notebooks

Per utilizzare il metodo register fornito dall'API Notebooks, in Cloud Shell o in qualsiasi ambiente in cui è installata Google Cloud CLI, inserisci il seguente comando Google Cloud CLI:

gcloud notebooks instances register MY_INSTANCE_NAME \
    --location=MY_ZONE

Sostituisci quanto segue:

  • MY_INSTANCE_NAME: il nome dell'istanza
  • MY_ZONE: la zona dell'istanza

Passaggi successivi