Vertex AI Workbench è un singolo ambiente di sviluppo per l'intero flusso di lavoro di data science. Per configurare un ambiente di produzione end-to-end basato su blocchi note, crea istanze JupyterLab con integrazioni integrate. Se non hai familiarità con Vertex AI, scopri di più su Vertex AI Workbench.
Questa pagina descrive la procedura di gestione dei blocchi note JupyterLab in Vertex AI Workbench, inclusa la creazione e la condivisione dei blocchi note e l'utilizzo dei blocchi note per interagire con i servizi Vertex AI. Questa pagina mostra anche come eliminare e aggiornare le istanze JupyterLab che ospitano i blocchi note.
Per informazioni sul backup e sul ripristino dei dati, consulta Creare un backup e ripristinare i dati dei blocchi note.
Prima di iniziare
Prima di utilizzare Vertex AI Workbench per gestire i blocchi note, devi avere un progetto pronto per l'esecuzione dei servizi Vertex AI. Per saperne di più, consulta Configurare un progetto per Vertex AI.
Per ottenere le autorizzazioni necessarie per gestire le risorse dei blocchi note all'interno di uno spazio dei nomi del progetto, chiedi all'amministratore IAM del progetto di concederti uno dei seguenti ruoli:
- Amministratore di Notebooks Workbench (
workbench-notebooks-admin): ottieni l'accesso in lettura e scrittura a tutte le risorse dei blocchi note in un progetto. Questo ruolo è necessario per creare blocchi note JupyterLab. - Visualizzatore di Notebooks Workbench (
workbench-notebooks-viewer): ottieni l'accesso in sola lettura a tutte le risorse dei blocchi note in un progetto. Questo ruolo è necessario per aprire i blocchi note JupyterLab.
Per saperne di più su questi ruoli, consulta Prepara le autorizzazioni IAM.
Creare un blocco note JupyterLab
Questa sezione descrive la configurazione di un'istanza JupyterLab in Vertex AI Workbench e la creazione di un blocco note JupyterLab nell'istanza.
Dopo aver soddisfatto i prerequisiti, segui questi passaggi per configurare un'istanza JupyterLab e creare un blocco note JupyterLab:
- Accedi alla console GDC e seleziona il tuo progetto.
- Nel menu di navigazione, fai clic su Vertex AI > Workbench.
- Fai clic su Nuovo blocco note.
Nella pagina Crea blocco note, inserisci i valori dei seguenti campi:
- Nome blocco note: inserisci il nome che vuoi assegnare al tuo blocco note JupyterLab. Vertex AI Workbench utilizza il nome scelto per creare un URL per accedere al blocco note.
- Ambiente: seleziona un'immagine Docker per l'istanza JupyterLab. Questa immagine fornisce una baseline per il deployment e i pacchetti di machine learning (ML) tipici.
- Cluster: seleziona un cluster Kubernetes per l'istanza JupyterLab che soddisfi i tuoi requisiti di utilizzo. Se non è disponibile un cluster Kubernetes, collabora con l'amministratore per aggiungere uno o più cluster.
- CPU / memoria: inserisci la quantità di CPU e RAM di cui hai bisogno per i tuoi carichi di lavoro. Per i carichi di lavoro che richiedono un utilizzo intensivo della CPU, puoi scegliere più di una CPU.
- GPU: seleziona il numero di GPU di cui hai bisogno per l'istanza JupyterLab. In Distributed Cloud, una GPU è una slice GPU multi-istanza (MIG) NVIDIA di una GPU A100 Tensor Core.
- Volume dello spazio di lavoro: inserisci le dimensioni dello spazio di archiviazione di cui hai bisogno in GB.
Fai clic su Crea.
Vertex AI Workbench configura l'istanza JupyterLab e crea il blocco note JupyterLab. Salva l'URL del blocco note per accedervi in futuro.
Dopo aver creato un blocco note JupyterLab in Vertex AI Workbench, apri l'ambiente di sviluppo integrato (IDE) nell'ambiente JupyterLab. Per saperne di più, consulta Aprire un blocco note JupyterLab.
Aprire un blocco note JupyterLab
Inserisci l'URL di un blocco note JupyterLab in un browser web per aprirlo. Se non conosci l'URL, segui questi passaggi per aprire il blocco note:
- Accedi alla console GDC e seleziona il tuo progetto.
- Nel menu di navigazione, fai clic su Vertex AI > Workbench.
- Trova il blocco note JupyterLab che vuoi aprire e fai clic su Apri JupyterLab per aprire l'IDE dell'istanza JupyterLab.
- Se ti viene chiesto di autenticarti, segui i passaggi di autenticazione per il tuo provider di identità.
- Nell'istanza JupyterLab, apri il blocco note JupyterLab.
Condividi l'URL di un blocco note JupyterLab con altri utenti in modo che possano aprirlo. L'utente previsto deve avere il ruolo Visualizzatore di Notebooks Workbench.
Utilizzare i servizi Vertex AI da un blocco note JupyterLab
Utilizza le librerie client per interagire con un servizio Vertex AI da un blocco note JupyterLab. Le librerie client di Vertex AI ti consentono di effettuare chiamate API a livello di programmazione a qualsiasi servizio Vertex AI su Distributed Cloud.
Segui questi passaggi per utilizzare un servizio Vertex AI da un blocco note JupyterLab:
- Abilita l'API Vertex AI corrispondente.
- Installa la libreria client di Vertex AI corrispondente.
- Crea un blocco note JupyterLab.
- Apri il blocco note JupyterLab e utilizzalo per scrivere codice con le librerie client di Vertex AI. Ad esempio, puoi tradurre il testo utilizzando la libreria client di Vertex AI Translation.
Eliminare un'istanza JupyterLab
Segui questi passaggi per eliminare un'istanza JupyterLab:
- Accedi alla console GDC e seleziona il tuo progetto.
- Nel menu di navigazione, fai clic su Vertex AI > Workbench.
- Trova il blocco note associato all'istanza JupyterLab che vuoi eliminare.
- Seleziona la casella di controllo del blocco note JupyterLab.
- Fai clic su Elimina.
- Nella finestra di dialogo Elimina blocchi note, fai clic su Elimina.
Aggiornare un'istanza JupyterLab
Dopo che l'operatore dell'infrastruttura (IO) ha aggiornato Distributed Cloud, puoi aggiornare le istanze JupyterLab.
Segui questi passaggi per ogni istanza JupyterLab che vuoi aggiornare:
- Salva i file dell'istanza JupyterLab che vuoi conservare in un bucket di archiviazione. Per saperne di più, consulta Caricare e scaricare oggetti di archiviazione nei progetti.
- Dopo l'aggiornamento, accedi alla console GDC e seleziona il tuo progetto.
- Configura una nuova istanza JupyterLab. Vertex AI Workbench crea un'istanza JupyterLab con una nuova versione di JupyterLab. Ad esempio, la nuova istanza JupyterLab contiene gli aggiornamenti delle librerie client di Distributed Cloud.
- Copia i file dal bucket di archiviazione dell'istanza JupyterLab obsoleta alla nuova istanza JupyterLab.
Puoi eliminare la versione precedente dell'istanza JupyterLab. Per saperne di più, consulta Eliminare un'istanza JupyterLab.