Creare trigger con Eventarc

Console

1. Esegui il deployment del servizio Cloud Run utilizzando container o da origine.

2. Nella console Google Cloud , vai a Cloud Run:

   Vai a Cloud Run

3. Dall'elenco dei servizi, fai clic su un servizio esistente.

4. Nella pagina Dettagli servizio, vai alla scheda Trigger.

5. Fai clic su Aggiungi trigger e seleziona un'opzione.

6. Nel riquadro Trigger Eventarc, modifica i dettagli del trigger come segue:

   1. Nel campo Nome trigger, inserisci un nome per il trigger oppure utilizza il nome predefinito.

   2. Seleziona un tipo di trigger dall'elenco per specificare uno dei seguenti tipi di trigger:

      • Origini Google per specificare i trigger per Pub/Sub, Cloud Storage, Firestore e altri fornitori di eventi Google.

      • Terze parti per l'integrazione con provider non Google che offrono un'origine Eventarc. Per saperne di più, vedi Eventi di terze parti in Eventarc.

   3. Seleziona un fornitore di eventi dall'elenco Fornitore di eventi per selezionare un prodotto che fornisca il tipo di evento per attivare il servizio. Per l'elenco dei fornitori di eventi, consulta Provider e destinazioni di eventi.

   4. Seleziona un tipo di evento dall'elenco Tipo di evento. La configurazione del trigger varia a seconda del tipo di evento supportato. Per saperne di più, vedi Tipi di eventi.

   5. Se il campo Regione è attivato, seleziona una posizione per il trigger Eventarc. In generale, la località di un trigger Eventarc deve corrispondere a quella della risorsa che vuoi monitorare per gli eventi. Google Cloud Nella maggior parte degli scenari, devi anche deployare il servizio nella stessa regione. Consulta la sezione Informazioni sulle località Eventarc per ulteriori dettagli sulle località dei trigger Eventarc.

   6. Nel campo Service account, seleziona un account di servizio. I trigger Eventarc sono collegati agli account di servizio da utilizzare come identità quando richiamano il servizio. Il account di servizio del trigger Eventarc deve disporre dell'autorizzazione per richiamare il servizio. Per impostazione predefinita, Cloud Run utilizza l'account di servizio predefinito di Compute Engine.

   7. (Facoltativo) Specifica il percorso dell'URL del servizio a cui inviare la richiesta in entrata. Questo è il percorso relativo nel servizio di destinazione a cui devono essere inviati gli eventi per il trigger. Ad esempio: /, /route, route e route/subroute.

   8. Una volta compilati i campi obbligatori, fai clic su Salva attivatore.

7. Dopo aver creato il trigger, verifica il suo stato assicurandoti che sia presente un segno di spunta check_circle nella scheda Trigger.

gcloud

1. Esegui il deployment del servizio Cloud Run utilizzando container o da origine.

2. Esegui questo comando per creare un trigger che filtri gli eventi:

   gcloud eventarc triggers create TRIGGER_NAME  \
       --location=REGION \
       --destination-run-service=SERVICE  \
       --destination-run-region=REGION \
       --event-filters="EVENT_FILTER" \
       --service-account=PROJECT_NUMBER-compute@developer.gserviceaccount.com
   

   Sostituisci:

   • TRIGGER_NAME con il nome dell'attivatore.

   • EVENTARC_TRIGGER_LOCATION con la località del trigger Eventarc. In generale, la località di un trigger Eventarc deve corrispondere a quella della risorsa Google Cloud che vuoi monitorare per gli eventi. Nella maggior parte degli scenari, devi anche eseguire il deployment del servizio nella stessa regione. Per saperne di più, consulta Località Eventarc.

   • SERVICE con il nome del servizio che stai implementando.

   • REGION con la regione Cloud Run del servizio.

   • PROJECT_NUMBER con il numero del tuo progetto Google Cloud . I trigger Eventarc sono collegati agli account di servizio da utilizzare come identità quando richiami il servizio. Il account di servizio del trigger Eventarc deve disporre dell'autorizzazione per richiamare il servizio. Per impostazione predefinita, Cloud Run utilizza l'account di servizio Compute predefinito.

   • Il flag event-filters specifica i filtri eventi monitorati dal trigger. Un evento che corrisponde a tutti i event-filters, i filtri attiva le chiamate al tuo servizio. Ogni attivatore deve avere un tipo di evento supportato. Non puoi modificare il tipo di filtro eventi dopo la creazione. Per modificare il tipo di filtro eventi, devi creare un nuovo trigger ed eliminare quello precedente. (Facoltativo) Puoi ripetere il flag --event-filters con un filtro supportato nel formato ATTRIBUTE=VALUE per aggiungere altri filtri.

Terraform

Per creare un trigger Eventarc per un servizio Cloud Run, consulta Creare un trigger utilizzando Terraform.

Console

Quando utilizzi la console Google Cloud per creare una funzione, puoi anche aggiungere un trigger alla funzione. Per creare un trigger per la tua funzione:

1. Nella console Google Cloud , vai a Cloud Run:

   Vai a Cloud Run

2. Fai clic su Scrivi una funzione e inserisci i dettagli della funzione. Per saperne di più sulla configurazione delle funzioni durante il deployment, consulta Eseguire il deployment delle funzioni.

3. Nella sezione Attivatore, fai clic su Aggiungi attivatore.

4. Seleziona un'opzione.

5. Nel riquadro Trigger Eventarc, modifica i dettagli del trigger come segue:

   1. Inserisci un nome per il trigger nel campo Nome trigger o utilizza il nome predefinito.

   2. Seleziona un tipo di trigger dall'elenco per specificare uno dei seguenti tipi di trigger:

      • Origini Google per specificare i trigger per Pub/Sub, Cloud Storage, Firestore e altri fornitori di eventi Google.

      • Terze parti per l'integrazione con provider non Google che offrono un'origine Eventarc. Per saperne di più, vedi Eventi di terze parti in Eventarc.

   3. Seleziona un fornitore di eventi dall'elenco Fornitore di eventi per selezionare un prodotto che fornisca il tipo di evento per attivare la funzione. Per l'elenco dei fornitori di eventi, consulta Provider e destinazioni di eventi.

   4. Seleziona un tipo di evento dall'elenco Tipo di evento. La configurazione del trigger varia a seconda del tipo di evento supportato. Per saperne di più, vedi Tipi di eventi.

   5. Se il campo Regione è attivato, seleziona una posizione per il trigger Eventarc. In generale, la località di un trigger Eventarc deve corrispondere a quella della risorsa che vuoi monitorare per gli eventi. Google Cloud Nella maggior parte degli scenari, devi anche eseguire il deployment della funzione nella stessa regione. Consulta la sezione Informazioni sulle località Eventarc per ulteriori dettagli sulle località dei trigger Eventarc.

   6. Nel campo Service account, seleziona un account di servizio. I trigger Eventarc sono collegati agli account di servizio da utilizzare come identità quando viene richiamata la funzione. Il account di servizio del trigger Eventarc deve disporre dell'autorizzazione per richiamare la funzione. Per impostazione predefinita, Cloud Run utilizza l'account di servizio predefinito di Compute Engine.

   7. (Facoltativo) Specifica il percorso dell'URL del servizio a cui inviare la richiesta in entrata. Questo è il percorso relativo nel servizio di destinazione a cui devono essere inviati gli eventi per il trigger. Ad esempio: /, /route, route e route/subroute.

6. Una volta compilati i campi obbligatori, fai clic su Salva attivatore.

gcloud

Quando crei una funzione utilizzando gcloud CLI, devi prima eseguirne il deployment e poi creare un trigger. Per creare un trigger per la tua funzione:

1. Esegui questo comando nella directory che contiene il codice campione per eseguire il deployment della funzione:

   gcloud run deploy FUNCTION \
           --source . \
           --function FUNCTION_ENTRYPOINT \
           --base-image BASE_IMAGE_ID \
           --region REGION
   

   Sostituisci:

   • FUNCTION con il nome della funzione che stai eseguendo il deployment. Puoi omettere completamente questo parametro, ma ti verrà chiesto il nome se lo ometti.

   • FUNCTION_ENTRYPOINT con l'entry point della tua funzione nel codice sorgente. Questo è il codice eseguito da Cloud Run quando viene eseguita la funzione. Il valore di questo flag deve essere un nome di funzione o un nome di classe completo che esiste nel codice sorgente.

   • BASE_IMAGE_ID con l'ambiente dell'immagine di base per la tua funzione. Per maggiori dettagli sulle immagini di base e sui pacchetti inclusi in ciascuna immagine, consulta Immagini di base dei runtime.

   • REGION con la Google Cloud regione in cui vuoi eseguire il deployment della funzione. Ad esempio: us-central1.

2. Esegui questo comando per creare un trigger che filtri gli eventi:

   gcloud eventarc triggers create TRIGGER_NAME  \
       --location=REGION \
       --destination-run-service=FUNCTION  \
       --destination-run-region=REGION \
       --event-filters="EVENT_FILTER" \
       --service-account=PROJECT_NUMBER-compute@developer.gserviceaccount.com
   

   Sostituisci:

   • TRIGGER_NAME con il nome dell'attivatore.

   • EVENTARC_TRIGGER_LOCATION con la località del trigger Eventarc. In generale, la località di un trigger Eventarc deve corrispondere a quella della risorsa Google Cloud che vuoi monitorare per gli eventi. Nella maggior parte degli scenari, devi anche eseguire il deployment della funzione nella stessa regione. Per saperne di più, consulta Località Eventarc.

   • FUNCTION con il nome della funzione che stai eseguendo il deployment.

   • REGION con la regione di Cloud Run della funzione.

   • PROJECT_NUMBER con il numero del tuo progetto Google Cloud . I trigger Eventarc sono collegati agli account di servizio da utilizzare come identità quando viene richiamata la funzione. Il account di servizio del trigger Eventarc deve disporre dell'autorizzazione per richiamare la funzione. Per impostazione predefinita, Cloud Run utilizza l'account di servizio Compute predefinito.

   • Il flag event-filters specifica i filtri eventi monitorati dal trigger. Un evento che corrisponde a tutti i event-filters, i filtri attiva le chiamate alla tua funzione. Ogni attivatore deve avere un tipo di evento supportato. Non puoi modificare il tipo di filtro eventi dopo la creazione. Per modificare il tipo di filtro eventi, devi creare un nuovo trigger ed eliminare quello precedente. (Facoltativo) Puoi ripetere il flag --event-filters con un filtro supportato nel formato ATTRIBUTE=VALUE per aggiungere altri filtri.

Terraform

Per creare un trigger Eventarc per una funzione Cloud Run, consulta Creare un trigger utilizzando Terraform.

Console

Dopo aver eseguito il deployment della funzione, segui questi passaggi per modificare la scadenza ack della funzione:

1. Nella console Google Cloud , vai a Cloud Run:

   Vai a Cloud Run

2. Individua la funzione che vuoi aggiornare nell'elenco Servizi e fai clic su per aprire i dettagli della funzione.

3. Apri la scheda Trigger.

4. Fai clic sul nome del trigger per aprire Dettagli trigger.

5. Fai clic sul link Argomento per aprire il riquadro di modifica dell'argomento.

6. Fai clic sul nome dell'ID abbonamento per andare al riquadro dell'abbonamento e fai clic su Modifica nella parte superiore della pagina.

7. Imposta il valore per Scadenza per la conferma su 600 e fai clic su Aggiorna per salvare la modifica.

gcloud

Aggiorna il termine ack per trigger al valore massimo di 600 secondi. Tieni presente che i seguenti comandi fanno riferimento a variabili (TRIGGER_NAME e REGION) i cui valori sono stati impostati nei passaggi precedenti.

## Per Cloud Run function:

# Update Ack Deadline to max (600s)
SUBSCRIPTION_ID=$(gcloud eventarc triggers describe "$TRIGGER_NAME" --location $REGION --format json | jq -r '.transport.pubsub.subscription')
gcloud pubsub subscriptions update "$SUBSCRIPTION_ID" --ack-deadline=600

Esegui un aggiornamento collettivo di tutti i trigger di servizi e funzioni per impostare le relative scadenze ack a 600 secondi:

### Match all Cloud Run service triggers and update all deadlines to 600s (max timeout)
### This will change ALL Cloud Run Service and Cloud Run function
TRIGGER_NAMES=($(gcloud eventarc triggers list | awk '/Cloud Run service/ {print $1}'))

if [ ${#TRIGGER_NAMES[@]} -eq 0 ]; then
  echo "No matching triggers found"
fi

for trigger in "${TRIGGER_NAMES[@]}"; do
echo "Updating ack deadline for trigger: $trigger"
SUBSCRIPTION_ID=$(gcloud eventarc triggers describe "$trigger" --location $REGION --format json | jq -r '.transport.pubsub.subscription')

if [ -z "$SUBSCRIPTION_ID" ]; then
    echo "Error: Could not retrieve subscription ID for trigger: $trigger"
    continue # Skip to the next trigger
fi
gcloud pubsub subscriptions update "$SUBSCRIPTION_ID" --ack-deadline=600
echo "Ack deadline updated for subscription: $SUBSCRIPTION_ID"
done