Pianifica ed esegui un cron job utilizzando la Google Cloud console

Pianifica ed esegui un cron job utilizzando la Google Cloud console

Questa guida rapida mostra come utilizzare la console Google Cloud per eseguire alcune operazioni di base utilizzando Cloud Scheduler.

In questa guida rapida:

1. Crea un argomento Pub/Sub da configurare come target del job Cloud Scheduler.
2. Crea un cron job utilizzando Cloud Scheduler e configura una pianificazione ricorrente per il job.
3. Esegui il job.
4. Verificare che il job sia stato eseguito correttamente.

Cloud Scheduler prevede un Livello senza costi e l'esecuzione di questa guida rapida non dovrebbe comportare alcun costo. Per ulteriori informazioni, vedi Prezzi.

---

Per seguire le indicazioni dettagliate per questa attività direttamente nella console Google Cloud , fai clic su Procedura guidata:

Procedura guidata

---

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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Scheduler and Pub/Sub 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

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

Verify that billing is enabled for your Google Cloud project.

Enable the Cloud Scheduler and Pub/Sub 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 ottenere le autorizzazioni necessarie per completare questa guida rapida, chiedi all'amministratore di concederti i seguenti ruoli IAM nel tuo progetto:

• Cloud Scheduler Admin (roles/cloudscheduler.admin)
• Editor Pub/Sub (roles/pubsub.editor)

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

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Crea un argomento e una sottoscrizione Pub/Sub

Un argomento Pub/Sub è una risorsa a cui i publisher possono inviare messaggi. Per ricevere i messaggi pubblicati in un argomento, devi creare una sottoscrizione all'argomento.

1. Nella console Google Cloud , vai alla pagina Pub/Sub.

   Vai a Pub/Sub.

2. Fai clic su Crea argomento.

3. Nel campo ID argomento, inserisci cron-topic come ID dell'argomento.

4. Mantieni le impostazioni predefinite, inclusa l'opzione Aggiungi una sottoscrizione predefinita.

5. Non selezionare altre opzioni.

6. Fai clic su Crea.

Vengono creati un argomento Pub/Sub denominato cron-topic e una sottoscrizione per questo argomento denominata cron-topic-sub.

Crea un cron job con Cloud Scheduler

Configura un'unità di lavoro pianificata, nota come cron job, che viene inviata a una destinazione in base a una pianificazione ricorrente.

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

   Vai a Cloud Scheduler

2. Fai clic su Crea job.

3. Assegna un nome al job.

4. Nell'elenco Regione, seleziona una regione per il job.

5. Specifica una frequenza per il job, utilizzando un formato basato su unix-cron. Ad esempio:

   30 16 * * 7
   

   Per saperne di più, consulta Configura le pianificazioni cron job.

6. Nell'elenco Fuso orario, seleziona un fuso orario.

   Per alcuni fusi orari, l'ora legale può causare l'esecuzione o la mancata esecuzione dei job in modo imprevisto. Per saperne di più, consulta Fuso orario.

7. Fai clic su Continua.

8. Nell'elenco Tipo di target, seleziona Pub/Sub.

9. Seleziona l'argomento creato in precedenza: cron-topic.

10. Nel campo Corpo del messaggio, inserisci una stringa da inviare all'argomento Pub/Sub target. Ad esempio: "Hello world!"

11. Fai clic su Crea.

Hai creato un job che invia un messaggio a un argomento Pub/Sub alle 16:30 di domenica. Ora puoi eseguire il job.

Esegui il job

Oltre a essere eseguito in base alla pianificazione specificata, puoi forzare l'esecuzione immediata del job.

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

   Vai a Cloud Scheduler

   Il job dovrebbe comparire nell'elenco.

2. Nella riga del job, fai clic su Azioni > Forza esecuzione.

   Tieni presente che, a causa della configurazione iniziale, l'esecuzione del primo job creato in un progetto può richiedere alcuni minuti.

3. Nella colonna Stato dell'ultima esecuzione, lo stato Success indica che il cron job è stato eseguito correttamente.

Dopodiché, puoi verificare che Pub/Sub abbia ricevuto il messaggio.

Verifica i risultati in Pub/Sub

Verifica che l'argomento Pub/Sub riceva messaggi dal tuo job eseguendo il pull dei messaggi Pub/Sub dalla sottoscrizione.

1. Nella console Google Cloud , vai alla pagina Sottoscrizioni Pub/Sub.

   Vai a Pub/Sub.

2. Fai clic sulla sottoscrizione per l'argomento Pub/Sub.

3. Fai clic sulla scheda Messaggi.

4. Fai clic su Pull.

Dovresti visualizzare il messaggio che hai pubblicato, con il corpo del messaggio, Hello world e l'ora in cui è stato pubblicato.

Esegui la pulizia

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

1. Elimina il cron job che hai creato:

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

      Vai a Cloud Scheduler

   2. Seleziona la casella di controllo relativa al job.

   3. Fai clic su Elimina e conferma l'operazione.

2. Elimina l'argomento Pub/Sub:

   1. Nella Google Cloud console, vai alla pagina Pub/Sub.

      Vai a Pub/Sub.

   2. Seleziona la casella di controllo in corrispondenza dell'argomento.

   3. Fai clic su Elimina e conferma l'operazione.

3. Elimina la sottoscrizione Pub/Sub:

   1. Nella Google Cloud console, vai alla pagina Pub/Sub.

      Vai a Pub/Sub.

   2. Seleziona la casella di controllo relativa al tuo abbonamento.

   3. Fai clic su Elimina e conferma l'operazione.

4. In alternativa, se hai creato un nuovo progetto per prendere dimestichezza con Cloud Scheduler e non ne hai più bisogno, elimina il progetto:

   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

• Scopri di più su Cloud Scheduler
• Scopri come visualizzare i log di Cloud Scheduler