Crea un'istanza di blocchi note gestiti

Crea un'istanza di blocchi note gestiti

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

Questa pagina mostra come creare un'istanza di blocchi note gestiti utilizzando la console Google Cloud o Google 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. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

2. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   Vai al selettore progetti

3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

4. Attiva l'API Notebooks.

   Abilita l'API

5. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   Vai al selettore progetti

6. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

7. Attiva l'API Notebooks.

   Abilita l'API

Creazione di un'istanza con proprietà predefinite

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

Console

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

   Vai ai blocchi note gestiti

2. Fai clic su  Nuovo blocco note.

3. Nel campo Nome blocco note, 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 blocchi note gestiti:

   • Account di servizio: questa opzione concede l'accesso a tutti gli utenti che hanno accesso all'account di servizio Compute Engine che colleghi 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.

   • Singolo utente: questa opzione consente l'accesso solo a un utente specifico. Nel campo Email dell'utente, inserisci l'indirizzo email dell'account utente dell'utente che utilizzerà l'istanza di blocchi note gestiti.

   Nota: per concedere l'accesso all'istanza tramite l'account di servizio o l'opzione Utente singolo, devi utilizzare l'indirizzo email dell'account utente di un privato. L'accesso al 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 essere utilizzata, Vertex AI Workbench attiva un link Apri JupyterLab.

gcloud

Prima di utilizzare uno qualsiasi dei dati di comando riportati di seguito, effettua le seguenti sostituzioni:

• INSTANCE_NAME: il nome dell'istanza di blocchi note 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 account utente o di servizio che deve accedere all'interfaccia JupyterLab dell'istanza
• MACHINE_TYPE: il tipo di macchina della VM dell'istanza

Esegui questo comando:

Linux, macOS o Cloud Shell

Nota: assicurati di aver inizializzato Google Cloud CLI con 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 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 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 relativa all'interfaccia a riga di comando di gcloud.

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

Crea un'istanza utilizzando le impostazioni avanzate

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

   Vai ai blocchi note gestiti

2. Fai clic su  Nuovo blocco note.

3. Nel campo Nome blocco note, 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 blocchi note gestiti:

   • Account di servizio: questa opzione concede l'accesso a tutti gli utenti che hanno accesso all'account di servizio Compute Engine che colleghi 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.

   • Singolo utente: questa opzione consente l'accesso solo a un utente specifico. Nel campo Email dell'utente, inserisci l'indirizzo email dell'account utente dell'utente che utilizzerà l'istanza di blocchi note gestiti.

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

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

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

Usa immagini Docker personalizzate

Per eseguire i file di blocco note in un container Docker personalizzato, aggiungi l'immagine del container Docker personalizzata alla tua istanza gestita di blocchi note.

L'immagine container Docker personalizzata deve trovarsi in Artifact Registry. Devi avere accesso all'immagine container.

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

2. Inserisci il percorso di un'immagine container 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 modificare questa scelta in un secondo momento dall'interfaccia utente JupyterLab.

Conferma disponibilità delle GPU

La disponibilità dell'acceleratore GPU si basa sulla regione, sul tipo di macchina e sul numero di GPU che vuoi. Ti consigliamo di verificare la disponibilità utilizzando le seguenti risorse:

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

Configurazione dell'hardware

Per configurare l'hardware, completa i seguenti passaggi:

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

2. Se vuoi utilizzare GPU, seleziona un tipo di GPU. Se non trovi il tipo di GPU desiderato, controlla la disponibilità delle GPU per il tipo di macchina e la zona.

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

4. Seleziona un Tipo di disco dati e Dimensioni disco dati in GB.

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

Seleziona il tipo di crittografia

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

1. Nella sezione Crittografia del disco, seleziona la chiave di crittografia gestita da Google predefinita o 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 è presente nell'elenco, inserisci l'ID risorsa della chiave di crittografia.

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

Abilita l'arresto per inattività

L'arresto per inattività è abilitato per impostazione predefinita per arrestare l'istanza dopo 180 minuti di inattività. Puoi modificare il numero di minuti di inattività prima dello arresto oppure disabilita l'arresto per inattività. Per scoprire di più, consulta Chiusura per inattività.

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

• Per disabilitare l'arresto per inattività, nella sezione Arresta per inattività deseleziona Abilita arresto per inattività.

Configurare la rete

Per impostazione predefinita, l'istanza di blocchi note gestiti utilizza una rete VPC gestita da Google, che non richiede alcuna configurazione. Se vuoi, puoi specificare una rete VPC situata all'interno del progetto o una rete condivisa con te. Se specifichi una rete, la rete richiede una connessione di accesso privato ai servizi. Anche la rete deve disporre dell'accesso a internet oppure devi abilitare l'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 abilitare un indirizzo IP esterno, seleziona la casella di controllo Abilita indirizzo IP esterno. Se la rete specificata non ha accesso a internet o se non abiliti 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 privato ai servizi, abilita l'API Service Networking, quindi fai clic su Abilita 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.

Configura le opzioni di sicurezza

Attiva o disattiva le seguenti opzioni:

• nbconvert: nbconvert consente agli utenti di esportare e scaricare un file di blocco note come tipo di file diverso, ad esempio HTML, PDF o LaTeX.
• File di download dall'interfaccia utente di blocco note: questa impostazione consente agli utenti di scaricare file dall'interfaccia utente di JupyterLab.
• Terminale: consente l'accesso del terminale all'istanza di blocchi note gestiti dall'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 essere utilizzata, Vertex AI Workbench attiva un link Apri JupyterLab.

Creare un'istanza con Terraform

Puoi creare un'istanza di blocchi note gestiti utilizzando la risorsa Terraform google_notebooks_runtime. Utilizza l'esempio seguente per creare una 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 JupyterLab di un'istanza di blocchi note gestiti, devi concedere l'autorizzazione dell'interfaccia alla gcloud CLI per accedere ai tuoi dati e autenticare l'istanza di blocchi note gestiti.

   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.

Apri un nuovo file blocco note

1. Seleziona File > Nuovo > Blocco note.

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 gestita di blocchi note. Nel browser file di JupyterLab , apri la cartella tutorials e apri uno dei file del blocco note.