Pianifica ed esegui un cron job

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

In questa guida rapida scoprirai:

  1. Creare un cron job utilizzando Cloud Scheduler.
  2. Impostare una programmazione ricorrente per un job.
  3. Specificare un argomento Pub/Sub come target del job.
  4. Eseguire un job.
  5. 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 Aiuto:

Aiuto


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

    Vai al selettore progetti

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

  4. Installa Google Cloud CLI.
  5. Per initialize gcloud CLI, esegui questo comando:

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

    Vai al selettore progetti

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

  8. Installa Google Cloud CLI.
  9. Per initialize gcloud CLI, esegui questo comando:

    gcloud init
  10. Se non utilizzi Cloud Shell, aggiorna i componenti dellGoogle Cloud CLI:
    gcloud components update
  11. Accedi utilizzando il tuo account:
    gcloud auth login
  12. 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.

  1. Configura un argomento Pub/Sub da utilizzare come destinazione per il cron job:

    gcloud pubsub topics create cron-topic
    

    Viene creato un argomento denominato cron-topic.

  2. Per visualizzare i risultati del job, crea una sottoscrizione Pub/Sub:

    gcloud pubsub subscriptions create cron-sub --topic cron-topic
    

Crea un cron job utilizzando Cloud Scheduler

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

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

    Vai a Cloud Scheduler

  2. Fai clic su Crea job.

  3. Assegna un nome al lavoro.

  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 maggiori informazioni, consulta Configurare pianificazioni cron job.

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

    Per alcuni fusi orari, l'ora legale può causare l'esecuzione inaspettata o la mancata esecuzione dei job. Per ulteriori informazioni, consulta la sezione Fuso orario.

  7. Fai clic su Continua.

  8. Nell'elenco Tipo di destinazione, 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 di destinazione Pub/Sub. 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 eseguire l'esecuzione secondo la pianificazione specificata, puoi forzare l'esecuzione immediata del job.

  1. Nella console Google Cloud, 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 di un job.

    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.

A questo punto puoi verificare che Pub/Sub abbia ricevuto il messaggio.

Verifica i risultati in Pub/Sub

Verifica che l'argomento Pub/Sub riceva messaggi dal job.

  1. 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.

  2. 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.

  1. Elimina il cron job 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.

  2. 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.

  3. 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