Pianifica ed esegui un cron job utilizzando gcloud CLI

Pianifica ed esegui un cron job utilizzando gcloud CLI

Questa guida rapida mostra come utilizzare gcloud CLI 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. Verifica 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.

Prima di iniziare

Accedi al tuo Google Cloud account. 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.

Installa Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

Crea o seleziona un Google Cloud progetto.

Ruoli richiesti per selezionare o creare un progetto

• Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico: puoi selezionare qualsiasi progetto su cui ti è stato concesso un ruolo.
• Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l' resourcemanager.projects.create autorizzazione. Scopri come concedere i ruoli.

Nota: se non prevedi di conservare le risorse che crei in questa procedura, crea un progetto invece di selezionarne uno già esistente. Una volta completata questa procedura, puoi eliminare il progetto e tutte le relative risorse.

• Crea un Google Cloud progetto:

  gcloud projects create PROJECT_ID

  Sostituisci PROJECT_ID con un nome per il Google Cloud progetto che stai creando.

• Seleziona il Google Cloud progetto che hai creato:

  gcloud config set project PROJECT_ID

  Sostituisci PROJECT_ID con il nome del Google Cloud progetto.

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.

Verifica che la fatturazione sia abilitata per il tuo Google Cloud progetto.

Abilita le API Cloud Scheduler e Pub/Sub:

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo servizi (roles/serviceusage.serviceUsageAdmin), che contiene l' serviceusage.services.enable autorizzazione. Scopri come concedere i ruoli.

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

Installa Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

Crea o seleziona un Google Cloud progetto.

Ruoli richiesti per selezionare o creare un progetto

• Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico: puoi selezionare qualsiasi progetto su cui ti è stato concesso un ruolo.
• Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l' resourcemanager.projects.create autorizzazione. Scopri come concedere i ruoli.

Nota: se non prevedi di conservare le risorse che crei in questa procedura, crea un progetto invece di selezionarne uno già esistente. Una volta completata questa procedura, puoi eliminare il progetto e tutte le relative risorse.

• Crea un Google Cloud progetto:

  gcloud projects create PROJECT_ID

  Sostituisci PROJECT_ID con un nome per il Google Cloud progetto che stai creando.

• Seleziona il Google Cloud progetto che hai creato:

  gcloud config set project PROJECT_ID

  Sostituisci PROJECT_ID con il nome del Google Cloud progetto.

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.

Verifica che la fatturazione sia abilitata per il tuo Google Cloud progetto.

Abilita le API Cloud Scheduler e Pub/Sub:

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo servizi (roles/serviceusage.serviceUsageAdmin), che contiene l' serviceusage.services.enable autorizzazione. Scopri come concedere i ruoli.

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

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per completare questa guida rapida, chiedi all'amministratore di concederti i seguenti ruoli IAM sul tuo progetto:

• Amministratore di Cloud Scheduler (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 gli editori possono inviare messaggi. Puoi ricevere i messaggi pubblicati in un argomento creando una sottoscrizione.

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

2. Per ricevere messaggi e 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

Utilizza il gcloud scheduler jobs create pubsub comando per configurare un'unità di lavoro nota come cron job che viene inviata a un target Pub/Sub con una pianificazione ricorrente. La pianificazione viene specificata utilizzando un formato basato su unix-cron. Per saperne di più, consulta Formato e fuso orario dei cron job.

gcloud scheduler jobs create pubsub my-cron-job \
    --schedule="30 16 * * 7" \
    --topic=cron-topic \
    --location="us-central1" \
    --message-body="Hello world"

Hai creato un job che invia un messaggio "Ciao mondo" all'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:

gcloud scheduler jobs run my-cron-job --location="us-central1"

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

Ora puoi verificare che l'argomento Pub/Sub abbia ricevuto il messaggio.

Verifica i risultati in Pub/Sub

Verifica che l'argomento Pub/Sub riceva i 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[...]
   

Libera spazio

Per evitare che al tuo Google Cloud account vengano addebitati costi relativi alle risorse utilizzate in questa pagina, elimina il Google Cloud progetto con le risorse.

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.

Elimina un Google Cloud progetto:

gcloud projects delete PROJECT_ID

In alternativa, elimina le risorse che hai creato per questa guida rapida:

1. Elimina il cron job. In Cloud Shell o sulla macchina su cui hai installato gcloud CLI, esegui il comando:

   gcloud scheduler jobs delete MY_JOB \
       --location="LOCATION"
   

   Sostituisci quanto segue:

   • MY_JOB: il nome del job da eliminare.
   • LOCATION: la località del job. Per impostazione predefinita, utilizza la località dell'app App Engine del progetto corrente, se esiste un'app associata.

2. Elimina l'argomento Pub/Sub. In Cloud Shell o sulla macchina su cui hai installato gcloud CLI, esegui il comando:

   gcloud pubsub topics delete TOPIC_ID
   

   Sostituisci TOPIC_ID con l'ID dell'argomento Pub/Sub da eliminare.

3. Elimina la sottoscrizione Pub/Sub. In Cloud Shell o sulla macchina su cui hai installato gcloud CLI, esegui il comando:

   gcloud pubsub subscriptions delete SUBSCRIPTION_ID
   

   Sostituisci SUBSCRIPTION_ID con l'ID della sottoscrizione Pub/Sub da eliminare.

Passaggi successivi

• Scopri di più su Cloud Scheduler

• Scopri come visualizzare i log di Cloud Scheduler