Creare trigger dagli eventi Cloud Storage

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. Nell'elenco dei servizi, fai clic su un servizio esistente.

4. Nella pagina dei dettagli del servizio, vai alla scheda Trigger.

5. Fai clic su add Aggiungi trigger e seleziona Trigger Cloud Storage.

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

   1. Nel campo Nome trigger, inserisci un nome per il 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 provider 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 Cloud Storage dall'elenco Provider di eventi per selezionare un prodotto che fornisca il tipo di evento per attivare il servizio. Per l'elenco dei fornitori di eventi, vedi Fornitori e destinazioni di eventi.

   4. Seleziona google.cloud.storage.object.v1.finalized dall'elenco Tipo di evento. La configurazione del trigger varia a seconda del tipo di evento supportato. Per saperne di più, consulta Tipi di eventi.

   5. Nel campo Bucket, fai clic su Sfoglia per selezionare un bucket Cloud Storage che il trigger deve monitorare. Le modifiche agli oggetti all'interno di questo bucket attiveranno chiamate alla tua funzione.

   6. 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 Google Cloud risorsa che vuoi monitorare per gli eventi. Nella maggior parte degli scenari, devi anche deployare il servizio nella stessa regione. Per maggiori dettagli sulle località dei trigger Eventarc, consulta Informazioni sulle località Eventarc.

   7. Nel campo Service account, seleziona un account di servizio. I trigger Eventarc sono collegati ai service account da utilizzare come identità quando viene richiamato 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.

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

   9. (Facoltativo) Per abilitare i nuovi tentativi se il tentativo di consegna non va a buon fine, seleziona la casella di controllo Abilita ripetizione dei tentativi in caso di errore; in caso contrario, il comportamento predefinito è un singolo tentativo di consegna senza ripetizioni. Per saperne di più, consulta Nuovi tentativi per gli eventi.

   10. 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 ed esegua il routing degli eventi:

   gcloud eventarc triggers create TRIGGER_NAME  \
       --location=LOCATION \
       --destination-run-service=DESTINATION_RUN_SERVICE  \
       --destination-run-region=DESTINATION_RUN_REGION \
       --event-filters="type=EVENT_FILTER_TYPE" \
       --event-filters="bucket=BUCKET" \
       --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
   

   Sostituisci quanto segue:

   • TRIGGER_NAME: l'ID del trigger o un identificatore completo.
   • LOCATION: la posizione del trigger Eventarc. In alternativa, puoi impostare la proprietà eventarc/location, ad esempio gcloud config set eventarc/location us-central1.

     Per evitare problemi di prestazioni e residenza dei dati, la località deve corrispondere a quella del Google Cloud servizio che genera eventi. Per saperne di più, consulta Località Eventarc.

   • DESTINATION_RUN_SERVICE: il nome del servizio Cloud Run che riceve gli eventi per il trigger. Il servizio può trovarsi in una qualsiasi delle località supportate da Cloud Run e non deve trovarsi nella stessa località del trigger. Tuttavia, il servizio deve trovarsi nello stesso progetto del trigger e riceverà gli eventi come richieste HTTP POST inviate al percorso dell'URL principale (/), ogni volta che l'evento viene generato.
   • DESTINATION_RUN_REGION: (facoltativo) la posizione di Cloud Run in cui si trova il servizio Cloud Run di destinazione. Se non specificato, si presume che il servizio si trovi nella stessa regione del trigger.
   • EVENT_FILTER_TYPE: l'identificatore dell'evento. Viene generato un evento quando una chiamata API per il metodo ha esito positivo. Per le operazioni a lunga esecuzione, l'evento viene generato solo al termine dell'operazione e solo se l'azione viene eseguita correttamente. Per un elenco dei tipi di eventi supportati, consulta Tipi di eventi Google supportati da Eventarc.
   • BUCKET: l'identificatore univoco globale del bucket Cloud Storage.
   • SERVICE_ACCOUNT_NAME: il nome del account di servizio gestito dall'utente.
   • PROJECT_ID: il tuo ID progetto Google Cloud .

   Note:

   • Il flag --event-filters="type=EVENT_FILTER_TYPE" è obbligatorio. Se non è impostato alcun altro filtro eventi, vengono abbinati gli eventi per tutte le risorse.
   • EVENT_FILTER_TYPE non può essere modificato dopo la creazione. Per modificare EVENT_FILTER_TYPE, crea un nuovo trigger ed elimina quello precedente.
   • Ogni attivatore può avere più filtri evento, separati da virgole in un unico --event-filters=[ATTRIBUTE=VALUE,...] flag oppure puoi ripetere il flag per aggiungere altri filtri. Solo gli eventi che corrispondono a tutti i filtri vengono inviati alla destinazione. I caratteri jolly e le espressioni regolari non sono supportati. Tuttavia, quando utilizzi il flag --event-filters-path-pattern, puoi definire un pattern di percorso della risorsa.
   • (Facoltativo) Per specificare un singolo tentativo di invio di eventi senza ripetizioni, utilizza il flag --max-retry-attempts. L'unico valore valido è 1. Se ometti il flag, viene applicato il comportamento di ripetizione standard. Per saperne di più, vedi Nuovi tentativi per gli eventi.
   • Sono disponibili altri flag. Per saperne di più, vedi gcloud eventarc triggers create.

Terraform

Per creare un trigger Eventarc per un servizio Cloud Run, consulta Crea 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 attivatore 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 ulteriori informazioni sulla configurazione delle funzioni durante il deployment, consulta Esegui il deployment delle funzioni.

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

4. Seleziona Trigger di Cloud Storage.

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

   1. Inserisci un nome per l'attivatore nel campo Nome attivatore o utilizza il nome predefinito.

   2. Seleziona un tipo di trigger dall'elenco:

      • Origini Google per specificare i trigger per Pub/Sub, Cloud Storage, Firestore e altri provider 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 Cloud Storage dall'elenco Provider di eventi per selezionare un prodotto che fornisca il tipo di evento per attivare la funzione. Per l'elenco dei fornitori di eventi, vedi Fornitori e destinazioni di eventi.

   4. Seleziona google.cloud.storage.object.v1.finalized dall'elenco Tipo di evento. La configurazione del trigger varia a seconda del tipo di evento supportato. Per saperne di più, consulta Tipi di eventi.

   5. Lascia invariato il campo Tipo di contenuti dei dati sugli eventi.

   6. Nel campo Bucket, fai clic su Sfoglia per selezionare un bucket Cloud Storage che il trigger deve monitorare. Le modifiche agli oggetti all'interno di questo bucket attiveranno chiamate alla tua funzione.

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

   8. Nel campo Service account, seleziona un account di servizio. I trigger Eventarc sono collegati a service account 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.

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

   10. (Facoltativo) Per abilitare i nuovi tentativi se il tentativo di consegna non va a buon fine, seleziona la casella di controllo Abilita ripetizione dei tentativi in caso di errore; in caso contrario, il comportamento predefinito è un singolo tentativo di consegna senza ripetizioni. Per saperne di più, consulta Nuovi tentativi per gli eventi.

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

7. Fai clic su Crea.

8. Nella scheda Origine, modifica il codice sorgente se necessario, poi seleziona Salva e ridistribuisci.

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 quanto segue:

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

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

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

   • REGION: la regione Google Cloudin cui vuoi eseguire il deployment della funzione. Ad esempio: europe-west1.

2. Esegui questo comando per creare un trigger che filtri ed esegua il routing degli eventi:

   gcloud eventarc triggers create TRIGGER_NAME  \
       --location=LOCATION \
       --destination-run-service=FUNCTION  \
       --destination-run-region=DESTINATION_RUN_REGION \
       --event-filters="type=EVENT_FILTER_TYPE" \
       --event-filters="bucket=BUCKET" \
       --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
   

   Sostituisci quanto segue:

   • TRIGGER_NAME: l'ID del trigger o un identificatore completo.
   • LOCATION: la posizione del trigger Eventarc. In alternativa, puoi impostare la proprietà eventarc/location, ad esempio gcloud config set eventarc/location us-central1.

     Per evitare problemi di prestazioni e residenza dei dati, la località deve corrispondere a quella del Google Cloud servizio che genera eventi. Per saperne di più, consulta Località Eventarc.

   • FUNCTION: il nome della funzione Cloud Run di cui è stato eseguito il deployment che riceve gli eventi per il trigger.
   • DESTINATION_RUN_REGION: (facoltativo) la posizione di Cloud Run in cui si trova la funzione Cloud Run di destinazione. Se non specificato, si presume che la funzione si trovi nella stessa regione del trigger.
   • EVENT_FILTER_TYPE: l'identificatore dell'evento. Viene generato un evento quando una chiamata API per il metodo ha esito positivo. Per le operazioni a lunga esecuzione, l'evento viene generato solo al termine dell'operazione e solo se l'azione viene eseguita correttamente. Per un elenco dei tipi di eventi supportati, consulta Tipi di eventi Google supportati da Eventarc.
   • BUCKET: l'identificatore univoco globale del bucket Cloud Storage.
   • SERVICE_ACCOUNT_NAME: il nome del account di servizio gestito dall'utente.
   • PROJECT_ID: il tuo ID progetto Google Cloud .

   Note:

   • Il flag --event-filters="type=EVENT_FILTER_TYPE" è obbligatorio. Se non è impostato alcun altro filtro eventi, vengono abbinati gli eventi per tutte le risorse.
   • EVENT_FILTER_TYPE non può essere modificato dopo la creazione. Per modificare EVENT_FILTER_TYPE, crea un nuovo trigger ed elimina quello precedente.
   • Ogni attivatore può avere più filtri evento, separati da virgole in un unico --event-filters=[ATTRIBUTE=VALUE,...] flag oppure puoi ripetere il flag per aggiungere altri filtri. Solo gli eventi che corrispondono a tutti i filtri vengono inviati alla destinazione. I caratteri jolly e le espressioni regolari non sono supportati. Tuttavia, quando utilizzi il flag --event-filters-path-pattern, puoi definire un pattern di percorso della risorsa.
   • (Facoltativo) Per specificare un singolo tentativo di invio di eventi senza ripetizioni, utilizza il flag --max-retry-attempts. L'unico valore valido è 1. Se ometti il flag, viene applicato il comportamento di ripetizione standard. Per saperne di più, vedi Nuovi tentativi per gli eventi.
   • Sono disponibili altri flag. Per saperne di più, vedi gcloud eventarc triggers create.

Terraform

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