Registrazione di un'istanza legacy con l'API Notebooks

Questa pagina mostra come eseguire la migrazione e registrare 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 tue 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 tenterà di registrare automaticamente le istanze legacy esistenti.

Requisiti e limitazioni

Prima di registrare le tue istanze legacy con l'API Notebooks, considera 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 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 dell'istanza legacy non è valida per l'API Notebooks, puoi contattare l'assistenza o il tuo account manager oppure eseguire la migrazione dell'istanza precedente a una nuova istanza di blocchi note gestiti dall'utente.

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

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

    Puoi eseguire la migrazione dell'istanza a disco singolo a un'istanza a doppio disco come parte 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 a 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 i 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 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 precedente alla nuova istanza, completa questi passaggi:

  1. Per utilizzare ssh per connetterti alla tua 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 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. Crea 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 è 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 è a doppio disco. Ha un disco di avvio e un disco dati.

  4. Utilizza ssh per connetterti all'istanza di blocchi note gestiti dall'utente che hai 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 siano stati copiati correttamente.

  7. (Facoltativo) Elimina l'istanza precedente.

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 tenterà di registrare automaticamente le istanze legacy esistenti. Se crei istanze legacy dopo l'abilitazione dell'API Notebooks, devi registrarle manualmente utilizzando uno dei metodi riportati di seguito.

Per registrare l'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, segui questi passaggi:

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

    Vai ai 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 registrarli con l'API Notebooks. Accanto a questo messaggio, fai clic su Registra tutto.

  3. Se non hai 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 è 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