Pianificare l'esecuzione di notebook gestiti

Pianificare l'esecuzione di notebook gestiti

I notebook gestiti da Vertex AI Workbench sono deprecati. Il 14 aprile 2025, il supporto per i notebook gestiti è terminato e la possibilità di creare istanze di notebook gestiti è stata rimossa. Le istanze esistenti continueranno a funzionare fino al 30 marzo 2026, ma non saranno disponibili patch, aggiornamenti e upgrade. Per continuare a utilizzare Vertex AI Workbench, ti consigliamo di eseguire la migrazione delle istanze di notebook gestiti alle istanze Vertex AI Workbench.

Questa pagina mostra come utilizzare l'executor di notebook gestiti di Vertex AI Workbench per eseguire un file notebook Python con una pianificazione oraria.

Prima di iniziare

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 senza costi per l'esecuzione, il test e il deployment dei workload.

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

Enable the Notebooks and Vertex AI APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

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

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

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

Verify that billing is enabled for your Google Cloud project.

Enable the Notebooks and Vertex AI APIs.

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

Enable the APIs

Ruoli obbligatori

Per assicurarti che il account di servizio della tua istanza disponga delle autorizzazioni necessarie per interagire con l'executor di Vertex AI Workbench, chiedi all'amministratore di concedere i seguenti ruoli IAM al account di servizio della tua istanza nel progetto:

Importante: devi concedere questi ruoli al account di servizio della tua istanza, non al tuo account utente. La mancata concessione dei ruoli all'entità corretta potrebbe comportare errori di autorizzazione.

• Notebooks Viewer (roles/notebooks.viewer)
• Vertex AI User (roles/aiplatform.user)
• Amministratore spazio di archiviazione (roles/storage.admin)

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

L'amministratore potrebbe anche essere in grado di concedere al account di servizio della tua istanza le autorizzazioni richieste tramite ruoli personalizzati o altri ruoli predefiniti.

Crea un'istanza di notebook gestiti e un file notebook di esempio

1. Crea un'istanza di blocchi note gestiti.

2. Apri JupyterLab.

3. Apri un nuovo file del notebook.

4. Nella prima cella del file del blocco note, inserisci quanto segue:

   # Import datetime
   import datetime
   
   # Get the time and print it
   datetime.datetime.now()
   print(datetime.datetime.now())

5. Per assicurarti che il file del blocco note venga salvato, seleziona File > Salva blocco note.

Pianificare una corsa

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

   Vai a Notebook gestiti

2. Accanto all'istanza di blocchi note gestiti che vuoi utilizzare, fai clic su Apri JupyterLab.

   L'istanza di blocco note gestita apre JupyterLab.

3. Nel browser dei file , fai doppio clic sul file del blocco note di esempio per aprirlo.

4. Fai clic sul pulsante  Esegui.

5. Nella finestra di dialogo Invia notebook a Executor, nel campo Tipo, seleziona Esecuzioni ricorrenti basate sulla pianificazione.

   Per impostazione predefinita, l'executor esegue il file del blocco note ogni ora al minuto 00 dell'ora.

6. In Opzioni avanzate, seleziona la Regione in cui vuoi eseguire il notebook.

7. Nel campo Bucket Cloud Storage, inserisci un nome per il bucket, quindi fai clic su Crea e seleziona. L'executor archivia l'output del notebook nel bucket Cloud Storage.

8. Fai clic su Invia.

   Il file del notebook viene eseguito automaticamente in base alla pianificazione impostata.

Nota: se l'istanza dei notebook gestiti viene arrestata, l'executor continua a eseguire il file del notebook in base alla pianificazione.

Al termine delle attività descritte in questo documento, puoi evitare l'addebito di ulteriori costi eliminando le risorse che hai creato. Per saperne di più, consulta Esegui la pulizia.

Visualizzare, condividere e importare un file notebook eseguito

Utilizzando l'interfaccia JupyterLab dell'istanza di blocchi note gestiti, puoi visualizzare l'output del notebook, condividere i risultati con altri e importare il file del notebook eseguito in JupyterLab.

Nota: per utilizzare la console Google Cloud per visualizzare e condividere i risultati dell'esecuzione, nella pagina Esecuzioni, fai clic su Esecuzioni.

Visualizzare i risultati dell'esecuzione

1. Nel menu di navigazione di JupyterLab, fai clic sul pulsante  Esecutore di notebook.

2. Fai clic sulla scheda Esecuzioni.

3. Fai clic su Visualizza risultato in corrispondenza dell'esecuzione che vuoi visualizzare.

   Executor apre il risultato in una nuova scheda del browser.

Condividere i risultati dell'esecuzione

1. Nell'interfaccia utente di JupyterLab dell'istanza di blocchi note gestiti, nel menu di navigazione, fai clic sul pulsante  Esecutore di blocchi note.

2. Fai clic sulla scheda Esecuzioni.

3. Accanto all'esecuzione che vuoi condividere, fai clic sul menu opzioni e seleziona Condividi risultato dell'esecuzione.

4. Segui le istruzioni nella finestra di dialogo per concedere agli utenti l'accesso al risultato dell'esecuzione.

Importa il notebook eseguito in JupyterLab

1. Nell'interfaccia utente di JupyterLab dell'istanza di blocchi note gestiti, nel menu di navigazione, fai clic sul pulsante  Esecutore di blocchi note.

2. Fai clic sulla scheda Esecuzioni.

3. Accanto all'esecuzione che vuoi importare, fai clic sul menu opzioni e seleziona Importa notebook eseguito.

4. Se viene visualizzata la finestra di dialogo Seleziona kernel, seleziona il kernel con cui vuoi aprire il notebook.

   L'executor apre il file del blocco note eseguito in JupyterLab e lo archivia nel browser di file di JupyterLab in una cartella denominata imported_notebook_jobs.

Visualizzare o eliminare una pianificazione

Puoi visualizzare ed eliminare le pianificazioni utilizzando la console Google Cloud o l'interfaccia utente JupyterLab dell'istanza di blocchi note gestiti.

Visualizzare una pianificazione

Visualizza una pianificazione per vedere le impostazioni di frequenza della pianificazione o per visualizzare i cinque risultati più recenti dell'esecuzione del file del notebook.

Console

1. Nella console Google Cloud , vai alla pagina Pianificazioni.

   Vai a Pianificazioni

2. Seleziona la regione in cui vuoi visualizzare le programmazioni.

3. Per la pagina Dettagli pianificazione che vuoi aprire, fai clic sul nome della pianificazione.

   Nella pagina Dettagli pianificazione, puoi visualizzare le ultime cinque esecuzioni della pianificazione.

4. Accanto al nome di un'esecuzione, fai clic su Visualizza risultato per aprire il file del notebook eseguito.

   Executor apre il risultato in una nuova scheda del browser.

JupyterLab

1. Nell'interfaccia utente di JupyterLab dell'istanza di Notebooks gestiti, nel menu di navigazione, fai clic sul pulsante  Esecutore di blocchi note.

2. Fai clic sulla scheda Pianificazioni.

3. Sotto l'esecuzione che vuoi visualizzare, fai clic su Visualizza l'ultimo risultato dell'esecuzione.

   Executor apre il risultato in una nuova scheda del browser.

Elimina una pianificazione

L'eliminazione di una pianificazione non comporta l'eliminazione delle esecuzioni generate da quella pianificazione.

Console

1. Nella console Google Cloud , vai alla pagina Pianificazioni.

   Vai a Pianificazioni

2. Seleziona la regione che contiene la pianificazione che vuoi eliminare.

3. Seleziona la programmazione che vuoi eliminare.

4. Fai clic su  Elimina

JupyterLab

1. Nell'interfaccia utente di JupyterLab dell'istanza di Notebooks gestiti, nel menu di navigazione, fai clic sul pulsante  Esecutore di blocchi note.

2. Fai clic sulla scheda Pianificazioni.

3. Alla fine del nome della pianificazione, fai clic sull'icona  Apri in una nuova finestra. Viene visualizzata la pagina Dettagli pianificazione per la pianificazione in questione nella console Google Cloud .

4. Fai clic su  Elimina

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.

Elimina l'istanza

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

   Vai a Notebook gestiti

2. Seleziona la regione che contiene l'istanza.

3. Seleziona l'istanza di notebook gestiti che vuoi eliminare.

4. Fai clic su  Elimina

Elimina il progetto

Se hai utilizzato risorse al di fuori dell'istanza di notebook gestiti, ad esempio il bucket Cloud Storage necessario per creare una pianificazione, ti consigliamo di eliminare il progetto per evitare addebiti aggiuntivi.

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:

• L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per, le attività descritte in questo documento, eliminerai anche tutto il lavoro che hai svolto nel progetto.
• Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un URL appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se intendi esplorare più architetture, tutorial o guide rapide, puoi riutilizzare i progetti ed evitare così di superare i limiti di quota.

1. Nella console Google Cloud , vai alla pagina Gestisci risorse.

   Vai a Gestisci risorse

2. Nell'elenco dei progetti, seleziona quello che vuoi eliminare, quindi fai clic su Elimina.
3. Nella finestra di dialogo, digita l'ID del progetto e fai clic su Chiudi per eliminare il progetto.

Passaggi successivi

• Le istanze di notebook gestiti da Vertex AI Workbench sono deprecate. Per pianificare l'esecuzione di un notebook in un'istanza di Vertex AI Workbench, vedi Pianificare l'esecuzione di un notebook.