Pianificare un'esecuzione di notebook gestiti

Pianificare un'esecuzione di notebook gestiti

I blocchi note gestiti da Vertex AI Workbench sono ritratti. Il 30 gennaio 2025, i blocchi note gestiti non saranno più disponibili e non sarà più possibile creare istanze di blocchi note gestiti verrà rimosso. Le istanze esistenti continueranno a funzionare, ma patch, aggiornamenti e upgrade non saranno disponibili. Per continuare a utilizzare Vertex AI Workbench, ti consigliamo di eseguire la migrazione delle tue istanze di notebook gestite alle istanze Vertex AI Workbench.

Questa pagina mostra come utilizzare l'eseguitore di blocchi note gestiti da Vertex AI Workbench per eseguire un file di blocco note 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.

   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

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.

   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

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

7. Enable the Notebooks and Vertex AI APIs.

   Enable the APIs

Ruoli obbligatori

Per assicurarti che l'account di servizio della tua istanza abbia i necessari autorizzazioni necessarie per interagire con l'esecutore Vertex AI Workbench, chiedi all'amministratore di concedere all'account di servizio dell'istanza seguenti ruoli IAM sul progetto:

• Notebooks Viewer (roles/notebooks.viewer)
• Utente Vertex AI (roles/aiplatform.user)
• Storage Admin (roles/storage.admin)

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

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

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

1. Crea un blocco note gestito in esecuzione.

2. Apri JupyterLab.

3. Apri un nuovo file del blocco note.

4. Inserisci quanto segue nella prima cella del file blocco note:

   # 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 Blocchi note gestiti.

   Vai a Blocchi note 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 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 blocchi note all'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: seleziona la Regione in cui vuoi eseguire il blocco note.

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

8. Fai clic su Invia.

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

Nota: se l'istanza di notebook gestiti viene arrestata, l'executor esegue comunque il file del notebook in base alla 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 di blocco note eseguito

Utilizzando l'interfaccia JupyterLab della tua istanza di blocchi note gestiti, puoi visualizzare l'output del blocco note, condividere i risultati e importare il file del blocco note 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.

Visualizza i risultati dell'esecuzione

1. Nel menu di navigazione di JupyterLab, fai clic sul pulsante  Esegui blocco note.

2. Fai clic sulla scheda Esecuzioni.

3. Fai clic su Visualizza risultato sotto l'esecuzione che vuoi visualizzare.

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

Condividi i risultati dell'esecuzione

1. Nell'istanza di blocco note gestito l'interfaccia utente JupyterLab, nel menu di navigazione, fai clic sull'  Esecutore blocco note.

2. Fai clic sulla scheda Esecuzioni.

3. Accanto all'esecuzione che vuoi condividere, fai clic sul menu opzioni . e seleziona Condividi risultato 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 di JupyterLab dell'istanza di blocchi note gestiti, nel menu di navigazione, fai clic sul pulsante  Esegui blocco note.

2. Fai clic sulla scheda Esecuzioni.

3. Accanto all'esecuzione da 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 con cui vuoi aprire il blocco note.

   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 oppure l'interfaccia utente JupyterLab dell'istanza di blocchi note gestiti.

Visualizzare un programma

Visualizza una programmazione per vedere le impostazioni di frequenza della programmazione o per visualizzare 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. 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 impostazioni cinque esecuzioni.

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'istanza di blocco note gestito l'interfaccia utente JupyterLab, nel menu di navigazione, fai clic sull'  Esecutore blocco note.

2. Fai clic sulla scheda Pianificazioni.

3. Sotto l'esecuzione che vuoi visualizzare, fai clic su Visualizza più recente. come risultato dell'esecuzione.

   Executor apre il risultato in una nuova scheda del browser.

Elimina una pianificazione

L'eliminazione di una pianificazione non elimina le esecuzioni precedenti generati a partire da quella pianificazione.

Console

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

   Vai a Pianificazioni

2. Seleziona la Regione che contiene la pianificazione da eliminare.

3. Seleziona la pianificazione da eliminare.

4. Fai clic su  Elimina

JupyterLab

1. Nell'istanza di blocco note gestito l'interfaccia utente JupyterLab, nel menu di navigazione, fai clic sull'  Esecutore blocco note.

2. Fai clic sulla scheda Pianificazioni.

3. Alla fine del nome della pianificazione, fai clic sull'icona  Apri in nuova. La pagina Dettagli pianificazione per tale pianificazione si apre nella nella console Google Cloud.

4. Fai clic su  Elimina

Esegui la pulizia

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

Elimina l'istanza

1. Nella console Google Cloud, vai alla pagina Notebook gestiti.

   Vai a Blocchi note gestiti

2. Seleziona la Regione in cui si trova l'istanza.

3. Seleziona l'istanza di blocchi note gestiti che vuoi eliminare.

4. Fai clic su  Elimina

Elimina il progetto

Se hai utilizzato risorse esterne all'istanza di Notebook gestiti, come 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, quando lo elimini elimini anche tutto il 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 appspot.com URL, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se intendi esplorare più architetture, tutorial o guide rapide, il riuso dei progetti può aiutarti a non superare i limiti di quota.

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

• Scopri di più sulla creazione di un'istanza di Notebook gestiti.

Per vedere 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 "Addestramento di un modello di classificazione multiclasse per il targeting degli annunci" in uno dei seguenti ambienti:

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