Guida rapida: pianifica ed esegui un cron job

Pianifica ed esegui un cron job

Questa guida rapida mostra come eseguire alcune operazioni di base utilizzando Cloud Scheduler.

In questa guida rapida:

Creare un job Cloud Scheduler.
Impostare una programmazione ricorrente per un job.
Specificare un argomento Pub/Sub come target del job.
Eseguire un job.
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

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.

Nella console di Google Cloud Console, nella pagina del selettore dei progetti, seleziona o crea un progetto Google Cloud.

Vai al selettore progetti

Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud. Scopri come verificare se la fatturazione è abilitata per un progetto.

Installa Google Cloud CLI.

Per inizializzare l'interfaccia a riga di comando gcloud, esegui il comando seguente:

gcloud init

Nella console di Google Cloud Console, nella pagina del selettore dei progetti, seleziona o crea un progetto Google Cloud.

Vai al selettore progetti

Verifica che la fatturazione sia attivata per il tuo progetto Google Cloud. Scopri come verificare se la fatturazione è abilitata per un progetto.

Installa Google Cloud CLI.

Per inizializzare l'interfaccia a riga di comando gcloud, esegui il comando seguente:

gcloud init

Se non utilizzi Cloud Shell, aggiorna i componenti Google Cloud CLI:
```
gcloud components update
```
Accedi utilizzando il tuo account:
```
gcloud auth login
```

Abilita le API Cloud Scheduler e Pub/Sub:

gcloud services enable cloudscheduler.googleapis.com pubsub.googleapis.com

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 a quell'argomento.

Configura un argomento Pub/Sub da utilizzare come target per il tuo cron job:
```
gcloud pubsub topics create cron-topic
```
Viene creato un argomento denominato cron-topic.
Per visualizzare i risultati del job, crea una sottoscrizione Pub/Sub:
```
gcloud pubsub subscriptions create cron-sub --topic cron-topic
```

Crea un job Cloud Scheduler

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

Nella console Google Cloud, vai alla pagina Cloud Scheduler.

Vai a Cloud Scheduler
Fai clic su Crea job.
Assegna un nome al job.
Nell'elenco Regione, seleziona una regione per il job.
Specifica una frequenza per il job, utilizzando un formato basato su unix-cron. Ad esempio:
```
30 16 * * 7
```
Per ulteriori informazioni, consulta la pagina Configurare le pianificazioni dei cron job.
Nell'elenco Fuso orario, seleziona un fuso orario.

Per alcuni fusi orari, l'ora legale può causare l'esecuzione o l'esecuzione non riuscita dei job. Per ulteriori informazioni, consulta Fuso orario.
Fai clic su Continua.
Nell'elenco Tipo target, seleziona Pub/Sub.
Seleziona l'argomento creato in precedenza: cron-topic.
Nel campo Corpo del messaggio, inserisci una stringa da inviare all'argomento Pub/Sub target. Ad esempio: "Hello world!".
Fai clic su Crea.

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

Esegui il job

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

Nella console Google Cloud, vai alla pagina Cloud Scheduler.

Vai a Cloud Scheduler

Il job dovrebbe comparire nell'elenco.
Nella riga del job, fai clic su Azioni > Forza esecuzione di un job.

Tieni presente che, a causa della configurazione iniziale, l'esecuzione del primo job creato in un progetto può richiedere alcuni minuti.
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 stia ricevendo messaggi dal tuo job Cloud Scheduler.

Esegui il pull dei messaggi Pub/Sub da una sottoscrizione:
```
gcloud pubsub subscriptions pull cron-sub --limit 5
```
Se inizialmente non vengono estratti messaggi, esegui di nuovo il comando.

Visualizza i risultati dell'esecuzione del job. L'output dovrebbe essere simile al seguente:

DATA: Hello world!
MESSAGE_ID: 5028933846601543
ORDERING_KEY:
ATTRIBUTES:
DELIVERY_ATTEMPT:
ACK_ID: RFAGFixdRkhRNxkIaFEOT14jPzUgKEUQAgVPAihdeTFXLkFacGhRDRlyfWB9[...]

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 il job Cloud Scheduler che hai creato:
1. Nella console Google Cloud, 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.
Elimina l'argomento Pub/Sub:
1. Nella console Google Cloud, 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.
Elimina il progetto:
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

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