Registrazione di un'istanza legacy con l'API Notebooks

Questa pagina mostra come eseguire la migrazione e la registrazione di un'istanza legacy di blocchi note gestiti dall'utente 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 register le tue istanze legacy con l'API Notebooks. Prima di registrare le istanze legacy, controlla se soddisfano i requisiti. Puoi migrate di istanze che non soddisfano i requisiti.

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

Requisiti e limitazioni

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

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

    Ad esempio, un'istanza legacy di blocchi note gestiti dall'utente in us-west1-a rimane in us-west1-a quando viene registrata con l'API Notebooks. Tuttavia, un'istanza di blocchi note 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 blocchi note dell'API Notebooks, esegui questo comando utilizzando Google Cloud CLI nel tuo terminale preferito o in Cloud Shell:

    gcloud notebooks locations list

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

  • Solo le istanze con doppio disco possono utilizzare tutte le funzionalità dei blocchi note gestiti dall'utente.

    Le istanze legacy con disco singolo non possono utilizzare alcune funzionalità dei blocchi note gestiti dall'utente, ad esempio l'upgrade automatico, anche dopo essere state registrate con l'API Notebooks. Per consentire all'istanza legacy con disco singolo di utilizzare tutte le funzionalità disponibili, devi eseguire la migrazione dell'istanza con disco singolo a un'istanza con doppio disco.

    Puoi eseguire la migrazione di un'istanza con disco singolo a un'istanza con doppio disco 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 eseguirne la migrazione a una nuova istanza con doppio disco 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. Individua 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 quanti dischi sono 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 l'istanza di blocchi note gestiti dall'utente legacy si trova in una zona non valida per l'API Notebooks o se vuoi eseguire la migrazione da un'istanza con disco singolo a un'istanza con 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 passaggi seguenti:

  1. Per utilizzare ssh per connetterti all'istanza legacy, in Cloud Shell o in qualsiasi ambiente in cui è installato 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 gsutil. Il comando di esempio seguente copia tutti i file del blocco note (.ipynb) dalla directory predefinita /home/jupyter/ a una directory di Cloud Storage denominata my-bucket/legacy-notebooks.

    gsutil cp -R /home/jupyter/*.ipynb gs://my-bucket/legacy-notebooks/

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

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

    In Cloud Shell o in qualsiasi ambiente in cui è installato 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 è a doppio disco. Ha un disco di avvio e un disco dati.

  4. Utilizza ssh per connetterti all'istanza dei 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 gsutil. Il comando di esempio seguente copia tutti i file del blocco note (.ipynb) dalla directory Cloud Storage alla directory /home/jupyter/ della nuova istanza.

    gsutil cp -R gs://my-bucket/legacy-notebooks/*.ipynb  /home/jupyter/

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

  7. (Facoltativo) Elimina l'istanza legacy.

Registra un'istanza legacy con l'API Notebooks

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

Se abiliti l'API Notebooks prima di registrare le istanze legacy, il processo di attivazione dell'API Notebooks tenta di registrare automaticamente le istanze legacy esistenti. Se crei istanze legacy dopo aver abilitato l'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 questi passaggi:

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

    Vai a Blocchi note gestiti dall'utente

  2. Se hai una o più istanze di blocchi note gestiti dall'utente legacy, 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 disponi di istanze di blocchi note gestiti dall'utente legacy, ma non hai ancora abilitato l'API Notebooks, fai clic su Abilita API Notebooks per assicurarti che vengano create nuove istanze di blocchi note gestiti dall'utente utilizzando l'API Notebooks.

API Notebooks

Per utilizzare il metodo register fornito dall'API Notebooks, in Cloud Shell o in qualsiasi ambiente in cui è installato 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