Pianifica l'esecuzione di un notebook

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

Prima di iniziare

  1. 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.
  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Make sure that billing is enabled for your Google Cloud project.

  4. Enable the Notebooks and Vertex AI APIs.

    Enable the APIs

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

    Go to project selector

  6. Make sure that billing is enabled for your Google Cloud project.

  7. Enable the Notebooks and Vertex AI APIs.

    Enable the APIs

  8. Ruoli obbligatori

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

    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 all'account di servizio della tua istanza le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Crea un'istanza e un file di notebook di esempio

  1. Crea un'istanza.

  2. Apri JupyterLab.

  3. Apri un nuovo file 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 un'esecuzione

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

    Vai a Istanze

  2. Fai clic su Apri JupyterLab accanto al nome dell'istanza.

    L'istanza di Vertex AI Workbench apre JupyterLab.

  3. Nel  browser di 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, inserisci un nome per il bucket nel campo Bucket Cloud Storage, quindi fai clic su Crea e seleziona. L'executor archivia l'output del notebook nel bucket Cloud Storage.

  7. Fai clic su Invia.

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

Al termine delle attività descritte in questo documento, puoi evitare l'addebito di ulteriori costi eliminando le risorse che hai creato. Per ulteriori informazioni, vedi Pulizia.

Visualizzare, condividere e importare un file notebook eseguito

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

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.

    L'esecutore apre il risultato in una nuova scheda del browser.

Condividere i risultati dell'esecuzione

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

  2. Fai clic sulla scheda Esecuzioni.

  3. Accanto all'esecuzione che vuoi condividere, fai clic sul menu delle 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, fai clic sul pulsante  Esecutore di blocchi note nel menu di navigazione.

  2. Fai clic sulla scheda Esecuzioni.

  3. Accanto all'esecuzione da importare, fai clic sul menu delle 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 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

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

    Vai a Pianificazioni

  2. Per la pianificazione che vuoi visualizzare, fai clic sul nome della pianificazione.

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

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

    L'esecutore apre il risultato in una nuova scheda del browser.

JupyterLab

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

  2. Fai clic sulla scheda Pianificazioni.

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

    L'esecutore 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 programmazione che vuoi eliminare.

  3. Fai clic su  Elimina

JupyterLab

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

  2. Fai clic sulla scheda Pianificazioni.

  3. Fai clic sul nome della programmazione. La pagina Dettagli pianificazione per quella pianificazione si apre 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 Istanze.

    Vai a Istanze

  2. Seleziona l'istanza che vuoi eliminare.

  3. Fai clic su  Elimina

Elimina il progetto

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

  1. In the Google Cloud console, go to the Manage resources page.

    Go to Manage resources

  2. In the project list, select the project that you want to delete, and then click Delete.
  3. In the dialog, type the project ID, and then click Shut down to delete the project.

Passaggi successivi