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 gratuito 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

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.

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

Se utilizzi un progetto esistente per questa guida, verifica di disporre delle autorizzazioni necessarie per completare la guida. Se hai creato un nuovo progetto, disponi già delle autorizzazioni necessarie.

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

Se utilizzi un progetto esistente per questa guida, verifica di disporre delle autorizzazioni necessarie per completare la guida. Se hai creato un nuovo progetto, disponi già delle autorizzazioni necessarie.

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 quell'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 inaspettato. Per saperne di più, consulta Fuso orario.

7. Fai clic su Continua.

8. Nell'elenco Tipo 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.

Successivamente, 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 vedere 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. 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ù su Cloud Scheduler
• Scopri come visualizzare i log di Cloud Scheduler