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

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.

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 per il quale ti è stato concesso un ruolo.
• Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l'autorizzazione resourcemanager.projects.create. 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.

• Creare un progetto Google Cloud :

  gcloud projects create PROJECT_ID

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

• Seleziona il progetto Google Cloud che hai creato:

  gcloud config set project PROJECT_ID

  Sostituisci PROJECT_ID con il nome del progetto Google Cloud .

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 progetto Google Cloud .

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 dei servizi (roles/serviceusage.serviceUsageAdmin), che include l'autorizzazione serviceusage.services.enable. 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 per il quale ti è stato concesso un ruolo.
• Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l'autorizzazione resourcemanager.projects.create. 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.

• Creare un progetto Google Cloud :

  gcloud projects create PROJECT_ID

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

• Seleziona il progetto Google Cloud che hai creato:

  gcloud config set project PROJECT_ID

  Sostituisci PROJECT_ID con il nome del progetto Google Cloud .

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 progetto Google Cloud .

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 dei servizi (roles/serviceusage.serviceUsageAdmin), che include l'autorizzazione serviceusage.services.enable. 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 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 messaggi pubblicati in un argomento, devi creare una sottoscrizione all'argomento.

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 i 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 con Cloud Scheduler

Utilizza il comando gcloud scheduler jobs create pubsub per configurare un'unità di lavoro nota come cron job che viene inviata a una destinazione 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 del cron job.

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

Hai creato un job che invia un messaggio "Hello world " 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-east1"

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

Successivamente, puoi verificare che l'argomento 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, elimina il progetto Google Cloud 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 progetto Google Cloud :

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 in 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 sede di lavoro. Per impostazione predefinita, utilizza la posizione dell'app App Engine del progetto attuale, se esiste un'app associata.

2. Elimina l'argomento Pub/Sub. In Cloud Shell o sulla macchina in 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 in cui hai installato gcloud CLI, esegui il comando:

   gcloud pubsub subscriptions delete SUBSCRIPTION_ID
   

   Sostituisci SUBSCRIPTION_ID con l'ID dell'abbonamento Pub/Sub da eliminare.

Passaggi successivi

• Scopri di più su Cloud Scheduler

• Scopri come visualizzare i log di Cloud Scheduler