Crea un'istanza di blocchi note gestiti

Crea un'istanza di blocchi note gestiti

I blocchi note gestiti da Vertex AI Workbench sono ritratti. Il 30 gennaio 2025 verrà interrotto il supporto per i notebook gestiti e la possibilità di creare istanze di notebook gestiti verrà rimossa. Le istanze esistenti continueranno a funzionare, ma patch, aggiornamenti e upgrade non saranno disponibili. Per continuare a utilizzare Vertex AI Workbench, ti consigliamo di eseguire la migrazione delle tue istanze di notebook gestite alle istanze Vertex AI Workbench.

Questa pagina mostra come creare un'istanza di Notebooks gestita utilizzando la console Google Cloud o lGoogle Cloud CLI. Durante la creazione dell'istanza, puoi configurare l'hardware, il tipo di crittografia, la rete e altri dettagli dell'istanza.

Prima di iniziare

1. 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.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Notebooks API.

   Enable the API

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Notebooks API.

   Enable the API

Creare un'istanza con proprietà predefinite

Puoi creare un'istanza di blocchi note gestiti utilizzando la console Google Cloud o la gcloud CLI:

Console

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

   Vai a Blocchi note gestiti

2. Fai clic su  Nuovo blocco note.

3. Nel campo Nome notebook, inserisci un nome per l'istanza. Il nome deve iniziare con una lettera seguita da un massimo di 62 lettere minuscole, numeri o trattini (-) e non può terminare con un trattino.

4. Fai clic sull'elenco Regione e seleziona una regione per l'istanza.

5. Scegli un'opzione di autorizzazione per definire gli utenti che possono accedere all'istanza di notebook gestita:

   • Account di servizio: questa opzione concede l'accesso a tutti gli utenti che hanno accesso all'account di servizio Compute Engine collegato al runtime. Per specificare il tuo account di servizio, deseleziona la casella di controllo Utilizza l'account di servizio predefinito di Compute Engine e inserisci l'indirizzo email dell'account di servizio che vuoi utilizzare. Per ulteriori informazioni sugli account di servizio, consulta Tipi di account di servizio.

   • Utente singolo: questa opzione concede l'accesso a un solo utente specifico. Nel campo Email utente, inserisci l'indirizzo email dell'account dell'utente che utilizzerà l'istanza di Notebook gestiti.

   Nota: per concedere l'accesso all'istanza tramite l'account di servizio o l'opzione per un singolo utente, devi utilizzare l'indirizzo email dell'account utente di un privato. L'accesso di gruppo non è supportato.

   Per scoprire di più sulla concessione dell'accesso, consulta Gestire l'accesso.

6. Fai clic su Crea.

   Vertex AI Workbench avvia automaticamente l'istanza. Quando l'istanza è pronta per l'uso, Vertex AI Workbench attiva un link Apri JupyterLab.

gcloud

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

• INSTANCE_NAME: il nome della tua istanza di Notebook gestiti. Deve iniziare con una lettera seguita da un massimo di 62 lettere minuscole, numeri o trattini (-) e non può terminare con un trattino
• PROJECT_ID: il tuo ID progetto
• LOCATION: la regione in cui vuoi che si trovi l'istanza
• ACCESS_MODE: la modalità di accesso che vuoi utilizzare; ad esempio, SINGLE_USER o SERVICE_ACCOUNT
• OWNER_EMAIL_ADDRESS: l'indirizzo email del singolo utente o account di servizio che deve accedere all'interfaccia JupyterLab dell'istanza
• MACHINE_TYPE: il tipo di macchina della VM della tua istanza

Esegui il seguente comando:

Linux, macOS o Cloud Shell

Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto eseguendo gcloud init; oppure gcloud auth login e gcloud config set project.

gcloud notebooks runtimes create INSTANCE_NAME --project=PROJECT_ID --location=LOCATION --runtime-access-type=ACCESS_MODE --runtime-owner=OWNER_EMAIL_ADDRESS --machine-type=MACHINE_TYPE

Windows (PowerShell)

Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto eseguendo gcloud init; oppure gcloud auth login e gcloud config set project.

gcloud notebooks runtimes create INSTANCE_NAME --project=PROJECT_ID --location=LOCATION --runtime-access-type=ACCESS_MODE --runtime-owner=OWNER_EMAIL_ADDRESS --machine-type=MACHINE_TYPE

Windows (cmd.exe)

Nota: assicurati di aver inizializzato Google Cloud CLI con l'autenticazione e un progetto eseguendo gcloud init; oppure gcloud auth login e gcloud config set project.

gcloud notebooks runtimes create INSTANCE_NAME --project=PROJECT_ID --location=LOCATION --runtime-access-type=ACCESS_MODE --runtime-owner=OWNER_EMAIL_ADDRESS --machine-type=MACHINE_TYPE

Per ulteriori informazioni sul comando per la creazione di un'istanza dalla riga di comando, consulta la documentazione della riga di comando gcloud.

Vertex AI Workbench avvia automaticamente l'istanza dopo la creazione. Quando l'istanza è pronta per l'uso, puoi accedervi dalla console Google Cloud.

Creare un'istanza utilizzando le impostazioni avanzate

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

   Vai a Blocchi note gestiti

2. Fai clic su  Nuovo blocco note.

3. Nel campo Nome notebook, inserisci un nome per l'istanza. Il nome deve iniziare con una lettera seguita da un massimo di 62 lettere minuscole, numeri o trattini (-) e non può terminare con un trattino.

4. Fai clic sull'elenco Regione e seleziona una regione per l'istanza.

5. Scegli un'opzione di autorizzazione per definire gli utenti che possono accedere all'istanza di notebook gestita:

   • Account di servizio: questa opzione concede l'accesso a tutti gli utenti che hanno accesso all'account di servizio Compute Engine collegato al runtime. Per specificare il tuo account di servizio, deseleziona la casella di controllo Utilizza l'account di servizio predefinito di Compute Engine e inserisci l'indirizzo email dell'account di servizio che vuoi utilizzare. Per ulteriori informazioni sugli account di servizio, consulta Tipi di account di servizio.

   • Utente singolo: questa opzione concede l'accesso a un solo utente specifico. Nel campo Email utente, inserisci l'indirizzo email dell'account dell'utente che utilizzerà l'istanza di Notebook gestiti.

   Nota: per concedere l'accesso all'istanza tramite l'account di servizio o l'opzione per un singolo utente, devi utilizzare l'indirizzo email dell'account utente di un privato. L'accesso di gruppo non è supportato.

   Per scoprire di più sulla concessione dell'accesso, consulta Gestire l'accesso.

6. Fai clic su Impostazioni avanzate e compila la finestra di dialogo seguendo le indicazioni riportate nelle sezioni seguenti.

Utilizzare immagini Docker personalizzate

Per eseguire i file del notebook in un contenitore Docker personalizzato, aggiungi l'immagine del contenitore Docker personalizzato all'istanza di notebook gestita.

L'immagine del contenitore Docker personalizzato deve trovarsi in Artifact Registry. Devi avere accesso all'immagine del contenitore.

1. Nella sezione Ambiente, in Immagini Docker personalizzate, seleziona la casella di controllo Fornisci immagini Docker personalizzate.

2. Inserisci il percorso di un'immagine del contenitore Docker o fai clic su Seleziona per aggiungerne una da Artifact Registry.

3. Per aggiungere un'altra immagine Docker personalizzata, fai clic su  Aggiungi un'altra immagine Docker e ripeti questi passaggi.

Configura hardware

Seleziona una configurazione hardware per il tuo ambiente. Puoi modificarlo in un secondo momento dall'interfaccia utente di JupyterLab.

Conferma la disponibilità della GPU

La disponibilità dell'acceleratore GPU dipende dalla regione, dal tipo di macchina e dal numero di GPU che vuoi. Ti consigliamo di verificare la disponibilità utilizzando le seguenti risorse:

• Disponibilità di regioni e zone GPU. Il tipo di acceleratore che vuoi deve essere disponibile nella zona dell'istanza.
• GPU NVIDIA® A100. Verifica la disponibilità delle GPU per il tuo tipo di macchina.

Configura l'hardware

Per configurare l'hardware:

1. Nella sezione Configurazione hardware, seleziona un Tipo di macchina.

2. Se vuoi utilizzare le GPU, seleziona un tipo di GPU. Se non vedi il tipo di GPU che ti interessa, controlla la disponibilità delle GPU per il tipo di macchina e la zona.

3. Se hai scelto di utilizzare le GPU, seleziona un Numero di GPU, quindi Installa automaticamente il driver GPU NVIDIA.

4. Seleziona un Tipo di disco dati e una Dimensione del disco dati in GB.

5. Per utilizzare il comportamento predefinito del cestino del sistema operativo, seleziona la casella di controllo Elimina nel cestino. Se utilizzi il comportamento predefinito del cestino, i file eliminati utilizzando l'interfaccia utente di JupyterLab sono recuperabili, ma occupano spazio su disco.

Seleziona il tipo di crittografia

Scegli la chiave di crittografia gestita da Google predefinita o una chiave di crittografia gestita dal cliente (CMEK). Per scoprire di più sull'utilizzo di CMEK con i notebook gestiti, consulta Utilizzare le chiavi di crittografia gestite dal cliente.

1. Nella sezione Crittografia dei dischi, seleziona la chiave di crittografia gestita da Google predefinita o la chiave di crittografia gestita dal cliente (CMEK).

2. Se selezioni Chiave di crittografia gestita dal cliente (CMEK), fai clic sull'elenco e seleziona la chiave gestita dal cliente.

   • Se la chiave che vuoi utilizzare non è nell'elenco, inserisci l'ID risorsa della chiave di crittografia.

   • Per creare una chiave di crittografia gestita dal cliente, consulta Creare chiavi di crittografia simmetriche.

Attiva l'arresto per inattività

L'arresto per inattività è attivato per impostazione predefinita per arrestare l'istanza dopo 180 minuti di inattività. Puoi modificare il numero di minuti di inattività prima dell'arresto o disattivare l'arresto in caso di inattività. Per saperne di più, consulta Spegnimento in caso di inattività.

• Per modificare il numero di minuti prima dell'arresto, nella sezione Arrestare in caso di inattività, nel campo Tempo di inattività prima dell'arresto (minuti), imposta il valore su un numero intero compreso tra 10 e 1440.

• Per disattivare lo spegnimento per inattività, nella sezione Spegnimento per inattività, deseleziona Abilita arresto per inattività.

Configurare la rete

Per impostazione predefinita, l'istanza di Notebook gestiti utilizza una rete VPC gestita da Google che non richiede alcuna configurazione. Se vuoi, puoi specificare una rete VPC all'interno del tuo progetto o una rete condivisa con te. Se specifichi una rete, la rete richiede una connessione di accesso privato ai servizi. La rete deve inoltre avere accesso a internet oppure devi abilitare Accesso privato Google per la rete.

1. Nella sezione Networking, seleziona Reti in questo progetto o Reti condivise con me.

2. Nel campo Rete, seleziona la rete che vuoi utilizzare.

3. Nel campo Subnet, seleziona la subnet che vuoi utilizzare.

4. Per attivare un indirizzo IP esterno, seleziona la casella di controllo Attiva indirizzo IP esterno. Se la rete specificata non ha accesso a internet o se non attivi l'indirizzo IP esterno, devi abilitare l'accesso privato Google per la rete per utilizzare questa istanza.

5. Se non hai già configurato una connessione di accesso privato ai servizi per questa rete, fai clic su Configura connessione e completa quanto segue:

   1. Nella finestra di dialogo Crea una connessione di accesso ai servizi privati, attiva l'API Service Networking e poi fai clic su Attiva API. Se l'API Service Networking è già abilitata, fai clic su Continua.

   2. Nella sezione Alloca un intervallo IP, completa la finestra di dialogo per selezionare uno o più intervalli IP esistenti, creare un nuovo intervallo IP o utilizzare un intervallo IP allocato automaticamente.

   3. Al termine, fai clic su Continua.

   4. Nella sezione Crea una connessione, controlla la rete e l'intervallo IP allocato che hai selezionato, quindi fai clic su Crea connessione.

Configurare le opzioni di sicurezza

Attiva o disattiva le seguenti opzioni:

• nbconvert: nbconvert consente agli utenti di esportare e scaricare un file del notebook come un tipo di file diverso, ad esempio HTML, PDF o LaTeX.
• Download di file dall'interfaccia utente di Notebook: questa impostazione consente agli utenti di scaricare file dall'interfaccia utente di JupyterLab.
• Terminale: consente l'accesso tramite terminale all'istanza di blocchi note gestiti dall'interno dell'interfaccia utente di JupyterLab.

Completa la creazione dell'istanza

1. Fai clic su Crea.

   Vertex AI Workbench avvia automaticamente l'istanza. Quando l'istanza è pronta per l'uso, Vertex AI Workbench attiva un link Apri JupyterLab.

Creare un'istanza utilizzando Terraform

Puoi creare un'istanza di Notebooks gestita utilizzando la risorsa Terraform google_notebooks_runtime. Utilizza il seguente esempio per creare un' nuova istanza di blocchi note gestiti denominata notebooks-runtime-basic.

Per scoprire come applicare o rimuovere una configurazione Terraform, consulta Comandi Terraform di base.

resource "google_notebooks_runtime" "basic_runtime" {
  name     = "notebooks-runtime-basic"
  location = "us-central1"

  access_config {
    access_type   = "SINGLE_USER"
    runtime_owner = "[e-mail]"
  }

  virtual_machine {
    virtual_machine_config {
      machine_type = "n1-standard-4"
      data_disk {
        initialize_params {
          disk_size_gb = "100"
          disk_type    = "PD_STANDARD"
        }
      }
    }
  }
}

Apri JupyterLab

Dopo aver creato l'istanza, Vertex AI Workbench la avvia automaticamente. Quando l'istanza è pronta per l'uso, Vertex AI Workbench attiva un link Apri JupyterLab.

1. Fai clic su Apri JupyterLab accanto al nome dell'istanza di blocchi note gestiti.

2. La prima volta che accedi all'interfaccia utente di JupyterLab di un'istanza di notebook gestita, devi concedere all'autorizzazione gcloud CLI l'accesso ai tuoi dati e l'autenticazione dell'istanza di notebook gestita.

   1. Nella finestra di dialogo Autentica il blocco note gestito, fai clic sul pulsante per ricevere un codice di autenticazione.

   2. Scegli un account e fai clic su Consenti. Copia il codice di autenticazione.

   3. Nella finestra di dialogo Autentica il blocco note gestito, incolla il codice di autenticazione e fai clic su Autentica.

L'istanza di blocco note gestita apre JupyterLab.

Aprire un nuovo file del blocco note

1. Seleziona File > Nuovo > Notebook.

2. Nella finestra di dialogo Seleziona kernel, seleziona Python, quindi fai clic su Seleziona.

3. Si apre il nuovo file del blocco note.

Passaggi successivi

• Prova uno dei tutorial inclusi nella nuova istanza di Notebook gestiti. Nel  browser di file di JupyterLab, apri la cartella tutorials e uno dei file del blocco note.