Crea un'istanza di blocchi note gestiti dall'utente

Console

Per creare un'istanza di blocchi note gestita dall'utente utilizzando la console Google Cloud:

1. Nella console Google Cloud, vai alla pagina Notebook gestiti dall'utente. In alternativa, vai all'indirizzo notebook.new (https://notebook.new) e salta il passaggio successivo.

   Vai a Blocchi note gestiti dall'utente

2. Fai clic su add_box Crea nuova.

   Viene visualizzata la finestra Nuova istanza.

3. Nella finestra Nuova istanza, fai clic su Opzioni avanzate.

4. Nella sezione Dettagli, fornisci le seguenti informazioni per la nuova istanza:

   • Nome: fornisci un nome per la nuova 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.
   • Regione e Zona: seleziona una regione e una zona per la nuova istanza. Per ottenere le migliori prestazioni della rete, seleziona la regione geograficamente più vicina a te. Consulta le località dei blocchi note gestiti dall'utente disponibili.
   • Etichette: facoltative. Fornisci etichette chiave-valore personalizzate per l'istanza.
   • Tag: facoltativo. Fornisci tag per l'istanza.

5. Nella sezione Ambiente, fornisci quanto segue:

   • Sistema operativo: seleziona il sistema operativo che vuoi utilizzare.
   • Ambiente: seleziona l'ambiente che vuoi utilizzare.
   • Versione: utilizza la versione più recente o una precedente delle istanze di blocchi note gestiti dall'utente.
   • Script post-avvio: facoltativo. Fai clic su Sfoglia per selezionare uno script da eseguire una volta dopo la creazione dell'istanza. Il percorso deve essere un URL o un percorso Cloud Storage, ad esempio: gs://PATH_TO_FILE/FILE_NAME.
   • Metadati: facoltativo. Fornisci chiavi dei metadati personalizzati per l'istanza.

6. Nella sezione Tipo di macchina, fornisci quanto segue:

   • Tipo di macchina: seleziona il numero di CPU e la quantità di RAM per la nuova istanza. Vertex AI Workbench fornisce stime del costo mensile per ogni tipo di macchina selezionato.

   • GPU: facoltativo. Se vuoi GPU, seleziona il tipo di GPU e il numero di GPU per la nuova istanza. Per informazioni sulle diverse GPU, consulta GPU su Compute Engine.

     Seleziona Installa automaticamente il driver GPU NVIDIA.

   • VM protetta: facoltativo. Seleziona o deseleziona quanto segue:

     • Avvio protetto
     • Virtual Trusted Platform Module (vTPM)
     • Monitoraggio dell'integrità

   • Arresto per inattività: facoltativo.

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

     • Per disattivare l'arresto per inattività, deseleziona Attiva arresto per inattività.

7. Nella sezione Dischi, fornisci quanto segue:

   • Dischi: facoltativo. Per modificare le impostazioni predefinite del disco di avvio o di dati, seleziona un Tipo di disco di avvio, Dimensione del disco di avvio in GB, Tipo di disco dati e Dimensione del disco dati in GB. Per saperne di più sui tipi di disco, consulta Opzioni di archiviazione.

   • Elimina nel cestino: facoltativo. Seleziona questa casella di controllo per utilizzare il comportamento predefinito del cestino del sistema operativo. Se utilizzi il comportamento predefinito del cestino, i file eliminati utilizzando l'interfaccia utente di JupyterLab sono recuperabili, ma occupano spazio su disco.

   • Backup: facoltativo. Per sincronizzare una posizione di Cloud Storage con il disco dati della tua istanza, fai clic su Sfoglia e specifica la posizione di Cloud Storage. Per informazioni sui costi di archiviazione, consulta la pagina Prezzi di Cloud Storage.

   • Crittografia: seleziona Chiave di crittografia gestita da Google o Chiave di crittografia gestita dal cliente (CMEK). Per utilizzare le chiavi CMEK, consulta Chiavi di crittografia gestite dal cliente.

8. Nella sezione Networking, fornisci quanto segue:

   • Networking: modifica le opzioni di rete per utilizzare una rete nel progetto corrente o una rete VPC condivisa da un progetto host, se configurato. Se utilizzi un VPC condiviso nel progetto host, devi anche concedere il ruolo Utente di rete Compute (roles/compute.networkUser) all'agente di servizio Notebooks nel progetto host.

     1. Nel campo Rete, seleziona la rete che ti interessa. Puoi selezionare una rete VPC, a condizione che sia attivato l'accesso privato Google o che la rete possa accedere a internet. Per ulteriori informazioni, consulta le opzioni di configurazione di rete.

     2. Nel campo Subnet, seleziona la subnet che ti interessa.

   • Per disattivare l'indirizzo IP esterno, deseleziona la casella di controllo Assegna indirizzo IP esterno.

   • Per disattivare l'accesso proxy, deseleziona la casella di controllo Consenti accesso proxy.

9. Nella sezione IAM e sicurezza, fornisci quanto segue:

   • IAM e sicurezza: per concedere l'accesso all'interfaccia JupyterLab dell'istanza, completa uno dei seguenti passaggi:

     • Per concedere l'accesso a JupyterLab tramite un account di servizio, seleziona Account di servizio.

       • Per utilizzare l'account di servizio Compute Engine predefinito, seleziona Usa l'account di servizio Compute Engine predefinito.

       • Per utilizzare un account di servizio personalizzato, deseleziona Utilizza account di servizio Compute Engine predefinito e, nel campo Indirizzo email account di servizio, inserisci l'indirizzo email del tuo account di servizio personalizzato.

     • Per concedere a un singolo utente l'accesso all'interfaccia di JupyterLab:

       1. Seleziona Singolo utente e poi, nel campo Email utente, inserisci l'account utente a cui vuoi concedere l'accesso. Se l'utente specificato non è il creatore dell'istanza, devi concedergli il ruolo Utente account di servizio (roles/iam.serviceAccountUser) nell'account di servizio dell'istanza.

       2. L'istanza utilizza un account di servizio per interagire con i servizi e le API Google Cloud.

          • Per utilizzare l'account di servizio Compute Engine predefinito, seleziona Usa l'account di servizio Compute Engine predefinito.

          • Per utilizzare un account di servizio personalizzato, deseleziona Utilizza account di servizio Compute Engine predefinito e, nel campo Indirizzo email account di servizio, inserisci l'indirizzo email del tuo account di servizio personalizzato.

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

   • Opzioni di sicurezza: seleziona o deseleziona le seguenti caselle di controllo:

     • Accesso root all'istanza
     • nbconvert
     • Download dei file
     • Accesso al terminale

10. Nella sezione Stato di salute del sistema, fornisci quanto segue:

    • Upgrade dell'ambiente e integrità del sistema: per eseguire l'upgrade automatico alle versioni dell'ambiente appena rilasciate, seleziona Upgrade automatico dell'ambiente e completa la Pianificazione dell'upgrade.

    • In Report, seleziona o deseleziona le seguenti caselle di controllo:

      • Segnalare lo stato del sistema
      • Segnalare metriche personalizzate a Cloud Monitoring
      • Installa Cloud Monitoring
      • Segnalare lo stato del DNS per i domini Google richiesti

11. Fai clic su Crea.

    Vertex AI Workbench crea e avvia automaticamente la tua istanza di notebook gestiti dall'utente. Quando l'istanza è pronta per l'uso, Vertex AI Workbench attiva un link Apri JupyterLab.

gcloud

Per impostazione predefinita, Google Cloud CLI crea un'istanza di notebook gestita dall'utente con un indirizzo IP esterno. Per creare un'istanza senza un indirizzo IP esterno, devi specificare una subnet in cui è attivato l'accesso privato Google. Per ulteriori informazioni, consulta le opzioni di configurazione di rete.

1. Per creare un'istanza di notebook gestita dall'utente dalla riga di comando, da Cloud Shell o da qualsiasi terminale in cui è installato Google Cloud CLI, utilizza il comando gcloud notebooks instances create:

   gcloud notebooks instances create INSTANCE_NAME \
     --vm-image-project=deeplearning-platform-release \
     --vm-image-family=VM_IMAGE_FAMILY \
     --machine-type=MACHINE_TYPE \
     --location=LOCATION

   Sostituisci quanto segue:

   • INSTANCE_NAME: il nome della nuova istanza; deve iniziare con una lettera seguita da un massimo di 62 lettere minuscole, numeri o trattini (-) e non può terminare con un trattino.
   • VM_IMAGE_FAMILY: il nome della famiglia di immagini che vuoi utilizzare per creare l'istanza
   • MACHINE_TYPE: il tipo di macchina della VM della tua istanza
   • LOCATION: la località di Google Cloud in cui vuoi che si trovi la nuova istanza

2. Accedi all'istanza dalla console Google Cloud.

Per informazioni su tutti i comandi per la creazione di un'istanza dalla riga di comando, consulta la documentazione della riga di comando gcloud.

Terraform

Il seguente esempio utilizza la risorsa Terraform google_notebooks_instance per creare una nuova istanza di notebook gestita dall'utente denominata notebooks-instance-basic.

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

resource "google_notebooks_instance" "basic_instance" {
  name         = "notebooks-instance-basic"
  location     = "us-central1-a"
  machine_type = "e2-medium"

  vm_image {
    project      = "deeplearning-platform-release"
    image_family = "tf-ent-2-9-cu113-notebooks"
  }
}