Crea un'istanza di blocchi note gestiti dall'utente

In questa pagina viene illustrato come creare di un'istanza di blocchi note gestiti dall'utente 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

Prima di poter creare un'istanza di blocchi note gestiti dall'utente, devi avere un progetto Google Cloud e abilita l'API Notebooks per quel progetto.
  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. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

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

  4. Attiva l'API Notebooks.

    Abilita l'API

    5.

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

    Go to project selector

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

  7. Attiva l'API Notebooks.

    Abilita l'API

    8.

  8. Se prevedi di utilizzare GPU con di blocchi note gestiti dall'utente, verifica la pagina delle quote nella Console Google Cloud per assicurarti di avere a disposizione un numero sufficiente di GPU nel progetto. Se le GPU non sono elencati nella pagina delle quote o hai bisogno di una quota GPU aggiuntiva, puoi richiedere un aumento della quota. Consulta la sezione Richiesta di un aumento della quota sulla alla pagina Quote delle risorse di Compute Engine.

Ruoli obbligatori

Se hai creato tu il progetto, hai Ruolo IAM del proprietario (roles/owner) nel progetto, che include tutte le autorizzazioni richieste. Salta questa sezione e per iniziare a creare l'istanza di blocchi note gestiti dall'utente. Se non lo hai fatto creare il progetto autonomamente, continua in questa sezione.

Per assicurarti che il tuo account utente disponga degli le autorizzazioni per creare un'istanza di blocchi note gestiti dall'utente di Vertex AI Workbench, chiedi all'amministratore di concedere al tuo account utente la seguenti ruoli IAM sul progetto:

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

L'amministratore potrebbe anche essere in grado di fornire il tuo account utente le autorizzazioni richieste tramite la ruoli o altri ruoli predefiniti ruoli.

Crea un'istanza di blocchi note gestiti dall'utente

Puoi creare un'istanza di blocchi note gestiti dall'utente utilizzando la console Google Cloud, Google Cloud CLI o Terraform.

Console

Per creare un'istanza di blocchi note gestiti dall'utente utilizzando nella console Google Cloud, segui questi passaggi:

  1. Nella console Google Cloud, vai alla pagina Blocchi note gestiti dall'utente. Oppure vai a notebook.new (https://notebook.new) e salta il passaggio successivo.

    Vai a Blocchi note gestiti dall'utente

  2. Fai clic su  Crea nuovo.

    Si apre 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: specifica 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 possono terminare con un trattino.
    • Regione e Zona. Seleziona una regione e una zona per la nuova istanza. Per ottenere le migliori prestazioni di rete, seleziona la regione geograficamente più vicina a te. Vedi i blocchi note gestiti dall'utente disponibili di località.
    • Etichette: facoltative. Fornisci etichette chiave-valore personalizzate per in esecuzione in un'istanza Compute Engine.
    • Tag: facoltativi. Fornire tag per l'istanza.

  5. Nella sezione Ambiente, specifica 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 precedente di istanze di blocchi note gestiti dall'utente.
    • Script post-avvio: facoltativo. Fai clic su Sfoglia per seleziona 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: facoltativi. Fornisci chiavi di metadati personalizzate per in esecuzione in un'istanza Compute Engine.

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

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

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

      Seleziona Installa il driver GPU NVIDIA automaticamente per me.

    • Shielded VM: facoltativa. Seleziona o cancella 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), modificare il valore in un numero intero compreso tra 10 e 1440.

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

  7. Nella sezione Dischi, specifica quanto segue:

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

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

    • Backup: facoltativo. Per sincronizzare un percorso di Cloud Storage con il disco dati dell'istanza, fai clic su Sfoglia e specifica nel percorso di Cloud Storage. Per saperne di più sui costi di archiviazione, consulta i prezzi di Cloud Storage.

    • Crittografia: seleziona Chiave di crittografia gestita da Google oppure Chiave di crittografia gestita dal cliente (CMEK). Per usare CMEK, vedi Chiavi di crittografia gestite dal cliente.

  8. Nella sezione Networking, specifica quanto segue:

    • Networking: modifica le opzioni di rete per utilizzare una rete in nel tuo progetto attuale Rete VPC condivisa da di un progetto host, se ne è configurato uno. Se utilizzi un VPC condiviso nel progetto host, devi inoltre concedere Ruolo Utente di rete Compute (roles/compute.networkUser) al servizio Notebooks Agente nel progetto host.

      1. Nel campo Rete, seleziona la rete che ti interessa. Tu puoi selezionare una rete VPC, purché la rete Dispone dell'accesso privato Google o possono accedere a internet. Per ulteriori informazioni, consulta le opzioni di configurazione di rete.

      2. Nel campo Subnet, seleziona la subnet che preferisci.

    • Per disattivare l'indirizzo IP esterno: Deseleziona la casella di controllo Assegna indirizzo IP esterno.

    • Per disattivare l'accesso proxy, cancella i dati Casella di controllo Consenti accesso proxy.

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

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

      • Per concedere l'accesso a JupyterLab tramite un account di servizio, Seleziona Service account (Account di servizio).

        • Per utilizzare l'account di servizio Compute Engine predefinito, Seleziona Utilizza l'account di servizio Compute Engine predefinito.

        • Per utilizzare un account di servizio personalizzato, deseleziona Utilizza l'account di servizio Compute Engine predefinito, quindi Nel campo Email account di servizio, inserisci l'indirizzo email del tuo account di servizio personalizzato.

      • Per concedere a un singolo utente l'accesso all'interfaccia JupyterLab, procedi nel seguente modo:

        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 è l'autore dell'istanza, devi concedere l'utente specificato come utente account di servizio ruolo (roles/iam.serviceAccountUser) in l'account di servizio dell'istanza.

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

          • Per utilizzare l'account di servizio Compute Engine predefinito, Seleziona Utilizza l'account di servizio Compute Engine predefinito.

          • Per utilizzare un account di servizio personalizzato, deseleziona Utilizza l'account di servizio Compute Engine predefinito, quindi Nel campo 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 del file
      • Accesso terminale

  10. Nella sezione Integrità del sistema, fornisci quanto segue:

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

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

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

  11. Fai clic su Crea.

    Vertex AI Workbench crea e avvia automaticamente dell'istanza di blocchi note gestiti dall'utente. Quando l'istanza è pronto per l'uso, Vertex AI Workbench attiva un link Apri JupyterLab.

gcloud

Per impostazione predefinita, Google Cloud CLI crea di blocchi note gestiti dall'utente con un indirizzo IP esterno. Per creare un'istanza senza un indirizzo IP esterno, devi specificare un in cui è abilitato l'accesso privato Google. Per ulteriori informazioni, vedi opzioni di configurazione della rete.

  1. Per creare un'istanza di blocchi note gestiti dall'utente dalla riga di comando, da Cloud Shell o qualsiasi terminale in cui è installata 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 del nuovo istanza; deve iniziare con una lettera seguita da fino a 62 lettere minuscole, numeri o trattini (-) e non può terminare con un trattino.
    • VM_IMAGE_FAMILY: la famiglia di immagini nome che vuoi utilizzare per creare la tua istanza
    • MACHINE_TYPE: la macchina tipo della VM dell'istanza
    • LOCATION: Google Cloud località dove vuoi che la nuova istanza sia

  2. Accedi all'istanza da nella console Google Cloud.

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

Terraform

L'esempio seguente utilizza la risorsa Terraform google_notebooks_instance per creare una nuova istanza di blocchi note gestiti dall'utente denominato 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"
  }
}

Apri il blocco note

Per aprire un'istanza di blocchi note gestiti dall'utente, completa quanto segue passaggi:

  1. Nella console Google Cloud, accanto ai blocchi note gestiti dall'utente il nome dell'istanza, fai clic su Apri JupyterLab.

  2. L'istanza di blocchi note gestiti dall'utente apre JupyterLab.

Opzioni di configurazione di rete

Un'istanza di blocchi note gestiti dall'utente deve accedere agli endpoint del servizio esterne alla tua rete VPC.

Puoi fornire questo accesso in uno dei seguenti modi:

Se utilizzi il VIP private.googleapis.com o restricted.googleapis.com per che forniscono l'accesso agli endpoint dei servizi, aggiungi voci DNS per ogni servizio richiesto endpoint:

  • notebooks.googleapis.com
  • *.notebooks.cloud.google.com
  • *.notebooks.googleusercontent.com
  • *.kernels.googleusercontent.com

Tag di rete

La nuova istanza di blocchi note gestiti dall'utente include automaticamente deeplearning-vm e notebook-instance tag di rete assegnati.

Questi tag consentono di gestire l'accesso dalla rete da e verso l'istanza di blocchi note gestiti dall'utente fare riferimento ai tag nelle regole firewall di rete VPC. Per ulteriori informazioni sui tag di rete, consulta la sezione Aggiungere tag di rete.

Per visualizzare i tag di rete per un'istanza di blocchi note gestiti dall'utente:

  1. Nella console Google Cloud, vai alla pagina Istanze VM.

    Vai a Istanze VM

  2. Fai clic sul nome dell'istanza.

  3. Nella sezione Networking, individua Tag di rete.

Risoluzione dei problemi

Se si verifica un problema durante la creazione di un blocco note, consulta la sezione Risoluzione dei problemi. Vertex AI Workbench per ricevere assistenza in merito a problemi comuni.

Passaggi successivi