Crea un'istanza di blocchi note gestiti

Crea un'istanza di blocchi note gestiti

I blocchi note gestiti di Vertex AI Workbench ritirato. 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.

In questa pagina viene illustrato come creare di un'istanza di blocchi note gestiti la console Google Cloud o Google Cloud CLI. Durante la creazione dell'istanza, puoi e 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

Crea un'istanza con proprietà predefinite

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

Console

1. Nella console Google Cloud, vai alla pagina Blocchi note 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 possono 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 di blocchi note gestiti:

   • Account di servizio: questa opzione concede l'accesso a tutti gli utenti che hanno l'accesso all'account di servizio Compute Engine colleghi al runtime. Per specificare tuo account di servizio, deseleziona Utilizza Compute Engine predefinito la casella di controllo dell'account di servizio 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 utente. dell'utente che utilizzerà l'istanza di blocchi note gestiti.

   Nota: per concedere l'accesso all'istanza tramite l'account di servizio o un'opzione per un singolo utente, devi utilizzare Indirizzo email dell'account utente. 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 uno qualsiasi dei dati di comando riportati di seguito, effettua le seguenti sostituzioni:

• INSTANCE_NAME: il nome del la tua 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: il 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 la persone che seguo :

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; o 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 creare dalla riga di comando, consulta gcloud CLI documentazione.

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 un blocco note personalizzato.

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 possono 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 di blocchi note gestiti:

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

   • 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 completa la finestra di dialogo seguendo le indicazioni riportate nelle sezioni seguenti.

Utilizzare immagini Docker personalizzate

Per eseguire file blocco note in un container Docker personalizzato, aggiungi il Docker personalizzato dell'immagine container alla tua istanza di blocchi note gestiti.

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

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 in seguito dall'interfaccia utente 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. Controlla disponibilità 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 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 Dimensione 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 JupyterLab sono recuperabili, ma i file eliminati occupano spazio su disco.

Seleziona il tipo di crittografia

Scegli la chiave di crittografia predefinita gestita da Google o una chiave gestita dal cliente chiave di crittografia (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 sul pulsante 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 Creazione di di crittografia simmetriche.

Abilita 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 del giorno l'arresto può essere disattivato o puoi disattivarlo per inattività. Per saperne di più, vedi Arresto per inattività.

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

• Per disattivare l'arresto per inattività, nella sezione Arresto per inattività, cancella Attiva 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 un progetto o una rete condivisa con te. Se specifichi una rete, la rete richiede un servizio privato di accesso. 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 viene specificato non dispone di accesso a Internet oppure, se non attivi indirizzo IP esterno, devi abilitare l'accesso privato Google per 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, attiva la 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 selezionarne uno o più intervalli IP esistenti, crea un nuovo intervallo IP o utilizza nell'intervallo IP allocato.

   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 blocchi note gestiti utilizzando google_notebooks_runtime Risorsa Terraform. Utilizza l'esempio seguente 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 a un'istanza di blocchi note gestiti l'interfaccia utente JupyterLab, devi concedere l'autorizzazione gcloud CLI per accedere ai tuoi dati e autentica la tua 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.

Aprire un nuovo file del blocco note

1. Seleziona File > Nuovo > Notebook.

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

3. Si apre il nuovo file del blocco note.

Passaggi successivi

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