Pianificare un'esecuzione del notebook
Questa pagina mostra come utilizzare l'executor di Vertex AI Workbench per eseguire un file di notebook Python con una pianificazione oraria.
Prima di iniziare
- 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.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Notebooks and Vertex AI APIs.
-
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
-
Make sure that billing is enabled for your Google Cloud project.
-
Enable the Notebooks and Vertex AI APIs.
Ruoli obbligatori
Per assicurarti che l'account di servizio della tua istanza disponga delle autorizzazioni necessarie per interagire con l'executor di Vertex AI Workbench,
chiedi all'amministratore di concedere all'account di servizio della tua istanza il ruolo IAM visualizzatore di notebook (roles/notebooks.viewer
)
nel progetto.
Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.
Questo ruolo predefinito contiene le autorizzazioni necessarie per interagire con l'eseguitore di Vertex AI Workbench. Per visualizzare le autorizzazioni esatte richieste, espandi la sezione Autorizzazioni richieste:
Autorizzazioni obbligatorie
Per interagire con l'eseguitore di Vertex AI Workbench sono necessarie le seguenti autorizzazioni:
-
Per elencare le esecuzioni:
notebooks.executions.list
L'amministratore potrebbe anche essere in grado di concedere all'account di servizio della tua istanza queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.
Crea un'istanza e un file di notebook di esempio
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())
Per assicurarti che il file del notebook venga salvato, seleziona File > Salva notebook.
Pianificare un'esecuzione
Nella console Google Cloud, vai alla pagina Istanze.
Fai clic su Apri JupyterLab accanto al nome dell'istanza.
L'istanza di Vertex AI Workbench apre JupyterLab.
Nel
Browser di file, fai doppio clic sul file del notebook di esempio per aprirlo.Fai clic sul pulsante Esegui.
Nella finestra di dialogo Invia i notebook a Executor, nel campo Tipo, selezionare Esecuzioni ricorrenti basate su pianificazione.
Per impostazione predefinita, l'eseguitore esegue il file del blocco note ogni ora al minuto
00
.In Opzioni avanzate, inserisci un nome per il bucket nel campo Bucket Cloud Storage, quindi fai clic su Crea e seleziona. L'executor archivia l'output del blocco note nel bucket Cloud Storage.
Fai clic su Invia.
Il file del blocco note viene eseguito automaticamente in base alla pianificazione impostata.
Al termine delle attività descritte in questo documento, puoi evitare la fatturazione continua eliminando le risorse che hai creato. Per ulteriori informazioni, consulta la sezione Pulizia.
Visualizzare, condividere e importare un file del notebook eseguito
Utilizzando l'interfaccia JupyterLab dell'istanza, puoi visualizzare l'output del notebook, condividere i risultati con altri utenti e importare il file del notebook eseguito in JupyterLab.
Visualizza i risultati dell'esecuzione
Nel menu di navigazione di JupyterLab, fai clic sul pulsante Executor di notebook.
Fai clic sulla scheda Esecuzioni.
Fai clic su Visualizza risultato sotto l'esecuzione che vuoi visualizzare.
L'eseguibile apre il risultato in una nuova scheda del browser.
Condividere i risultati dell'esecuzione
Nell'interfaccia utente di JupyterLab della tua istanza, fai clic sul pulsante Executor di notebook nel menu di navigazione.
Fai clic sulla scheda Esecuzioni.
Accanto all'esecuzione che vuoi condividere, fai clic sul menu di opzioni
e seleziona Condividi risultato esecuzione.Segui le istruzioni nella finestra di dialogo per concedere agli utenti l'accesso al risultato dell'esecuzione.
Importa il blocco note eseguito in JupyterLab
Nell'interfaccia utente di JupyterLab della tua istanza, fai clic sul pulsante Executor di notebook nel menu di navigazione.
Fai clic sulla scheda Esecuzioni.
Accanto all'esecuzione da importare, fai clic sul menu di opzioni
e seleziona Importa blocco note eseguito.Se viene visualizzata la finestra di dialogo Seleziona kernel, seleziona il kernel con cui vuoi aprire il notebook.
L'eseguitore apre il file del blocco note eseguito in JupyterLab e lo memorizza nel browser dei file 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 della tua istanza.
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
Nella console Google Cloud, vai alla pagina Pianificazioni.
Fai clic sul nome della pianificazione che vuoi visualizzare.
Nella pagina Dettagli pianificazione, puoi visualizzare le ultime cinque esecuzioni della pianificazione.
Accanto al nome di un'esecuzione, fai clic su Visualizza risultato per aprire il file del notebook eseguito.
L'eseguibile apre il risultato in una nuova scheda del browser.
JupyterLab
Nell'interfaccia utente di JupyterLab della tua istanza, fai clic sul pulsante Executor di notebook nel menu di navigazione.
Fai clic sulla scheda Pianificazioni.
Sotto l'esecuzione che vuoi visualizzare, fai clic su Visualizza risultato dell'ultima esecuzione.
L'eseguibile 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
Nella console Google Cloud, vai alla pagina Pianificazioni.
Seleziona la pianificazione da eliminare.
Fai clic su
Elimina
JupyterLab
Nell'interfaccia utente di JupyterLab della tua istanza, fai clic sul pulsante Executor di notebook nel menu di navigazione.
Fai clic sulla scheda Pianificazioni.
Fai clic sul nome della pianificazione. Nella console Google Cloud si apre la pagina Dettagli pianificazione per la pianificazione in questione.
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
Nella console Google Cloud, vai alla pagina Istanze.
Seleziona l'istanza che vuoi eliminare.
Fai clic su
Elimina
Elimina il progetto
Se hai utilizzato risorse esterne alla tua istanza Vertex AI Workbench, come il bucket Cloud Storage necessario per creare una pianificazione, ti consigliamo di eliminare il progetto per evitare addebiti aggiuntivi.
- In the Google Cloud console, go to the Manage resources page.
- In the project list, select the project that you want to delete, and then click Delete.
- In the dialog, type the project ID, and then click Shut down to delete the project.