Pianifica l'esecuzione di un blocco note

Pianifica l'esecuzione di un blocco note

Questa pagina mostra come utilizzare l'esecutore di Vertex AI Workbench per eseguire un file blocco note Python con una pianificazione oraria.

Prima di iniziare

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. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   Vai al selettore progetti

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

4. Abilita le API Notebooks and Vertex AI.

   Abilita le API

5. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   Vai al selettore progetti

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

7. Abilita le API Notebooks and Vertex AI.

   Abilita le API

Ruoli obbligatori

Per assicurarti che l'account di servizio dell'istanza disponga delle autorizzazioni necessarie per interagire con l'esecutore di Vertex AI Workbench, chiedi all'amministratore di concedere all'account di servizio dell'istanza il ruolo IAM Visualizzatore blocchi note (roles/notebooks.viewer) per il progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Questo ruolo predefinito contiene le autorizzazioni necessarie per interagire con l'esecutore di Vertex AI Workbench. Per visualizzare le autorizzazioni esatte necessarie, espandi la sezione Autorizzazioni richieste:

Autorizzazioni obbligatorie

Per interagire con l'esecutore 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 dell'istanza queste autorizzazioni con ruoli personalizzati o altri ruoli predefiniti.

Crea un'istanza e un file di blocco note di esempio

1. Crea un'istanza.

2. Apri JupyterLab.

3. Apri un nuovo file blocco note.

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 di aver salvato il file del blocco note, seleziona File > Salva blocco note.

Pianifica una corsa

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

   Vai a Istanze

2. Accanto al nome dell'istanza, fai clic su Apri JupyterLab.

   L'istanza di Vertex AI Workbench apre JupyterLab.

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

4. Fai clic sul pulsante  Esegui.

5. Nella finestra di dialogo Invia blocchi note a esecutore, nel campo Tipo, seleziona Esecuzioni ricorrenti basate su pianificazione.

   Per impostazione predefinita, l'esecutore esegue il file del blocco note ogni ora al 00 minuto 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'esecutore archivia l'output del blocco note nel bucket Cloud Storage.

7. Fai clic su Invia.

   Il file blocco note viene eseguito automaticamente in base alla pianificazione impostata.

Nota: se l'istanza viene arrestata, l'esecutore esegue comunque il file del blocco note secondo la pianificazione.

Una volta completate le attività descritte in questo documento, puoi evitare la fatturazione continua eliminando le risorse che hai creato. Per ulteriori informazioni, consulta la pagina Pulizia.

Visualizza, condividi e importa un file blocco note eseguito

Utilizzando l'interfaccia JupyterLab della tua istanza, puoi visualizzare l'output del blocco note, condividere i risultati con altri utenti e importare il file blocco note eseguito in JupyterLab.

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

Visualizza i risultati dell'esecuzione

1. Nel menu di navigazione di JupyterLab, fai clic sul pulsante  Notebook Executor (esecutore blocco note).

2. Fai clic sulla scheda Esecuzioni.

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

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

Condividi i risultati dell'esecuzione

1. Nell'interfaccia utente JupyterLab della tua istanza, nel menu di navigazione, fai clic sul pulsante  Notebook Executor.

2. Fai clic sulla scheda Esecuzioni.

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

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

Importa il blocco note eseguito in JupyterLab

1. Nell'interfaccia utente JupyterLab della tua istanza, nel menu di navigazione, fai clic sul pulsante  Notebook Executor.

2. Fai clic sulla scheda Esecuzioni.

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

4. Se viene visualizzata la finestra di dialogo Seleziona kernel, seleziona il kernel che vuoi aprire il blocco note.

   L'esecutore apre il file del blocco note eseguito in JupyterLab e lo archivia nel browser di 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 sue impostazioni di frequenza o i cinque risultati più recenti dell'esecuzione del file blocco note.

Console

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

   Vai a Pianificazioni

2. Fai clic sul nome della pianificazione che vuoi visualizzare.

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

3. Accanto a un nome di esecuzione, fai clic su Visualizza risultato per aprire il file del blocco note eseguito.

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

JupyterLab

1. Nell'interfaccia utente JupyterLab della tua istanza, nel menu di navigazione, fai clic sul pulsante  Notebook Executor.

2. Fai clic sulla scheda Pianificazioni.

3. Sotto l'esecuzione che vuoi visualizzare, fai clic su Visualizza il risultato dell'ultima 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 pianificazione che vuoi eliminare.

3. Fai clic su  Elimina

JupyterLab

1. Nell'interfaccia utente JupyterLab della tua istanza, nel menu di navigazione, fai clic sul pulsante  Notebook Executor.

2. Fai clic sulla scheda Pianificazioni.

3. Fai clic sul nome della pianificazione. 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 di Vertex AI Workbench, ad esempio il bucket Cloud Storage necessario per creare una pianificazione, ti consigliamo di eliminare il progetto per evitare costi 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à in questo documento, quando lo elimini elimini anche qualsiasi altro lavoro 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 il progetto 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

Per visualizzare un esempio di come pianificare l'esecuzione di un blocco note nell'ambito di un flusso di lavoro più completo, esegui il blocco note Jupyter "Addestra un modello di classificazione multiclasse per il targeting degli annunci" in uno dei seguenti ambienti:

Apri in Colab | Apri in Colab Enterprise | Apri nei blocchi note gestiti dall'utente di Vertex AI Workbench | Visualizza su GitHub