Registrazione di un'istanza legacy con l'API Notebooks

Questa pagina mostra come eseguire la migrazione e registrare un account legacy di blocchi note gestiti dall'utente con l'API Notebooks. Istanze create mediante l'API Compute Engine sono chiamate "istanze legacy". Precedente di istanze VM non dispongono degli aggiornamenti più recenti alle funzionalità.

Per utilizzare le nuove funzionalità disponibili con API Notebooks, devi registrare le tue istanze legacy con l'API Notebooks. Prima di registrare le istanze legacy, verifica se soddisfano i requisiti. Puoi eseguire la migrazione 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 la versione legacy esistente automaticamente le istanze.

Requisiti e limitazioni

Prima di registrare le tue istanze legacy con l'API Notebooks, valuta la possibilità di i seguenti requisiti e limitazioni.

  • 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 è registrato con l'API Notebooks. Tuttavia, un blocco note legacy gestito dall'utente 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 sul tuo terminale preferito o 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 nuovi blocchi note gestiti dall'utente di Compute Engine.

  • Solo le istanze con doppio disco possono utilizzare tutti i blocchi note gestiti dall'utente le funzionalità di machine learning.

    Le istanze legacy a disco singolo non possono utilizzare alcune funzionalità dei blocchi note gestiti dall'utente, come l'upgrade automatico, dopo la registrazione con l'API Notebooks. Per attivare a disco singolo per utilizzare tutte le funzionalità disponibili, devi eseguire la migrazione dell'istanza con disco singolo a una in esecuzione.

    Puoi eseguire la migrazione di un'istanza con disco singolo a un'istanza con doppio disco della migrazione da un'istanza legacy a un'istanza registrata con l'API Notebooks. Se hai già registrato l'istanza legacy con API Notebooks, puoi comunque eseguire la migrazione dell'istanza su un nuovo 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. Trovare gli attuali blocchi note legacy gestiti dall'utente in esecuzione in un'istanza Compute Engine.

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

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

    gcloud

    1. In Cloud Shell o in qualsiasi ambiente in cui Google Cloud CLI è già installato, inserisci quanto segue 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 e il numero di dischi 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 che non è valida per l'API Notebooks o se vuoi eseguire la migrazione a un'istanza a doppio disco, devi creare un'istanza di blocchi note gestiti dall'utente e copiare i dati utente un'istanza legacy alla nuova istanza.

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

  1. Per utilizzare ssh per connetterti all'istanza legacy, in Cloud Shell o in qualsiasi ambiente in cui Google Cloud CLI inserisci questo 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 Cloud Storage usa gcloud storage. Il comando di esempio seguente copia tutti i file del blocco note (.ipynb) dalla directory predefinita /home/jupyter/ in 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 blocchi note gestiti dall'utente con lo stesso hardware specifiche dell'istanza legacy. Puoi creare l'istanza utilizzando 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'ultima immagine TensorFlow 2, con tipo di macchina n1-standard-1, nella zona us-west1-a.

    In Cloud Shell o in qualsiasi ambiente in cui 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 appena creato.

  5. Per copiare i contenuti dell'istanza legacy dal bucket Cloud Storage alla nuova istanza, usa gcloud storage. Il comando di esempio seguente copia tutti i file del blocco note (.ipynb) dalla directory Cloud Storage nella 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 conferma che i dati utente e gli asset siano stati copiati.

  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 tue 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 la tua versione legacy automaticamente le istanze. Se crei istanze legacy dopo l'API Notebooks è abilitato, devi registrarli manualmente utilizzando uno dei seguenti di machine learning.

Per registrare la tua istanza legacy con l'API Notebooks, puoi 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 Blocchi note gestiti dall'utente.

    Vai a Blocchi note gestiti dall'utente

  2. Se disponi di uno o più account legacy di blocchi note gestiti dall'utente, 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 blocchi note legacy gestiti dall'utente ma non hai ancora abilitato l'API Notebooks, fai clic su Abilita l'API Notebooks per garantire che i nuovi blocchi note gestiti dall'utente vengono create usando l'API Notebooks.

API Notebooks

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