Configura un trigger Eventarc

Questa pagina descrive come configurare un trigger Eventarc in Application Integration.

Un trigger Eventarc consente di eseguire integrazioni basate su eventi instradati tramite Eventarc Standard. Utilizzando un trigger Eventarc, puoi creare flussi di integrazione attivati da eventi provenienti da vari Google Cloud servizi, servizi di terze parti e origini eventi personalizzate. Ad esempio, puoi utilizzare il trigger per avviare un'integrazione quando un nuovo oggetto viene caricato in un bucket Cloud Storage.

Nella console Google Cloud , puoi creare e configurare un trigger Eventarc nei seguenti modi:

Prima di iniziare

Prima di configurare il trigger Eventarc, abilita l'API Eventarc e l'API Pub/Sub:

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre dell'autorizzazione serviceusage.services.enable. Se hai creato il progetto, probabilmente disponi già di questa autorizzazione tramite il ruolo Proprietario (roles/owner). In caso contrario, puoi ottenere questa autorizzazione tramite il ruolo Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin). Scopri come concedere i ruoli.

Abilita le API

Considerazioni

Tieni presente quanto segue quando configuri un trigger Eventarc:

  • Se la creazione del trigger Eventarc non riesce durante la pubblicazione dell'integrazione a causa di errori di configurazione, l'integrazione verrà comunque pubblicata, ma il trigger non sarà attivo.

    Per risolvere il problema, annulla la pubblicazione dell'integrazione, rivedi e correggi attentamente la configurazione del trigger Eventarc, quindi ripubblica l'integrazione. Puoi controllare lo stato di creazione del trigger Eventarc facendo clic su (Notifica) nella barra degli strumenti della console Google Cloud.

  • La pubblicazione di una nuova versione dell'integrazione con una configurazione del trigger Eventarc modificata sostituisce automaticamente il vecchio trigger con uno nuovo. In questo modo, l'integrazione utilizza sempre la configurazione dell'attivatore più recente ed elimina gli attivatori obsoleti.
  • Se pubblichi una nuova versione dell'integrazione e utilizzi lo stesso trigger Eventarc e la relativa configurazione, non viene creato un nuovo trigger. Il trigger Eventarc esistente viene riutilizzato per la nuova versione dell'integrazione.

Crea un trigger Eventarc da Application Integration

Per creare un trigger Eventarc da Application Integration:

  1. Aggiungi il trigger Eventarc in Application Integration
  2. Configura il trigger Eventarc nell'editor di integrazione

Aggiungi il trigger Eventarc

Per aggiungere un trigger Eventarc all'integrazione, completa i seguenti passaggi:

  1. Nella console Google Cloud , vai alla pagina Integrazione di applicazioni.

    Vai ad Application Integration

  2. Nel menu di navigazione, fai clic su Integrazioni.

    Viene visualizzata la pagina Elenco integrazioni, che elenca tutte le integrazioni disponibili nel progetto Google Cloud.

  3. Seleziona un'integrazione esistente o fai clic su Crea integrazione per crearne una nuova.

    Se stai creando una nuova integrazione:

    1. Inserisci un nome e una descrizione nel riquadro Crea integrazione.
    2. Seleziona una regione per l'integrazione.
    3. Seleziona un account di servizio per l'integrazione. Puoi modificare o aggiornare i dettagli del account di servizio di un'integrazione in qualsiasi momento dal riquadro Riepilogo integrazione di nella barra degli strumenti dell'integrazione.
    4. Fai clic su Crea.

    L'integrazione appena creata si apre nell'editor integrazioni.

  4. Nella barra di navigazione dell'editor dell'integrazione, fai clic su Trigger per visualizzare l'elenco dei trigger disponibili.
  5. Trascina l'elemento Eventarc nell'Editor integrazioni.

Configura il trigger Eventarc

Per configurare un trigger Eventarc, fai clic sull'elemento Trigger Eventarc nell'Editor integrazioni. Viene visualizzato il riquadro di configurazione Trigger Eventarc che mostra i seguenti campi:

  • (Facoltativo) Etichetta:il nome visibile del trigger Eventarc nell'integrazione. Puoi modificare l'etichetta con un nome a tua scelta.
  • Note: (facoltativo) puoi aggiungere note per fornire informazioni aggiuntive sul trigger.
  • Fai clic su Configura trigger Eventarc e fornisci i seguenti input nell'editor trigger Eventarc:
    • Nome trigger: inserisci un nome per il trigger.
    • Tipo di trigger: seleziona uno dei seguenti tipi di trigger:
      • Origine Google: seleziona questa opzione per creare un trigger per Pub/Sub, Cloud Storage, Firestore e altri provider di eventi Google.
      • Personalizzato: seleziona questa opzione per creare un attivatore per un'origine evento personalizzata.
      • Terze parti: seleziona questa opzione per creare un trigger per i provider non Google che offrono un'origine Eventarc. Per saperne di più, vedi Eventi di terze parti in Eventarc.
    • Provider di eventi: seleziona il provider di eventi per il trigger. L'elenco dei fornitori di eventi dipende dal tipo di trigger. Per saperne di più, vedi Fornitori e destinazioni di eventi.
    • Tipo di evento: seleziona il tipo di evento per il trigger. La configurazione dell'attivatore varia in base al fornitore di eventi selezionato. Per saperne di più, vedi Tipi di eventi.
    • Regione: seleziona la regione per il trigger.
    • Filtri: (facoltativo) aggiungi filtri per selezionare le API che corrispondono ai tuoi criteri. Ad esempio, se filtri le API in base a un nome specifico, l'evento viene attivato solo se vengono aggiornate le API che corrispondono ai criteri di filtro.
    • Service account: seleziona il account di servizio da utilizzare per il trigger. Se non selezioni un account di servizio, il trigger utilizza il account di servizio Compute Engine predefinito come identità quando richiama il servizio. Il account di servizio associato al trigger deve disporre delle autorizzazioni richieste per richiamare il servizio.

    • Riprova in caso di errore: seleziona questa opzione per abilitare i nuovi tentativi di attivazione se la destinazione non riesce a elaborare l'evento.
    • Collegamento di rete: seleziona il collegamento di rete da utilizzare per il trigger. Questo elenco viene generato in base ai collegamenti di rete creati nel tuo progetto.

      Gli allegati di rete facilitano la comunicazione tra le reti Virtual Private Cloud (VPC) del producer di servizi e le reti VPC consumer. Eventarc utilizza il collegamento di rete configurato per stabilire una connessione a un endpoint HTTP interno ospitato all'interno della rete VPC del consumer, consentendo la distribuzione dei dati sugli eventi. Per saperne di più sulla creazione e sulla gestione dei collegamenti di rete, consulta Crea e gestisci i collegamenti di rete.

  • Per salvare la configurazione dell'attivatore, fai clic su Salva attivatore.

Crea un trigger Eventarc utilizzando la console Eventarc

Per creare un trigger Eventarc dalla pagina della console Eventarc:

  1. Nella console Google Cloud , vai alla pagina Eventarc > Trigger.

    Vai ai trigger

    La pagina Trigger elenca tutti i trigger del progetto.

  2. Fai clic su Crea trigger.
  3. Nella pagina Crea trigger, fornisci i seguenti input:
    1. Nome trigger: inserisci un nome per il trigger.
    2. Tipo di trigger: seleziona uno dei seguenti tipi di trigger:
      • Origini Google: seleziona questa opzione per creare un trigger per Pub/Sub, Cloud Storage, Firestore e altri provider di eventi Google.
      • Personalizzato: seleziona questa opzione per creare un attivatore per un'origine evento personalizzata.
      • Terze parti: seleziona questa opzione per creare un trigger per i provider non Google che offrono un'origine Eventarc. Per saperne di più, vedi Eventi di terze parti in Eventarc.
    3. Provider di eventi: seleziona il provider di eventi per il trigger. L'elenco dei fornitori di eventi dipende dal tipo di trigger. Per saperne di più, vedi Fornitori e destinazioni di eventi.
    4. Tipo di evento: seleziona il tipo di evento per il trigger. La configurazione dell'attivatore varia in base al fornitore di eventi selezionato. Per saperne di più, consulta Tipi di eventi.
    5. Tipo di contenuti dei dati sugli eventi: seleziona il tipo di dati per i contenuti dell'evento. Seleziona application/json o application/protobuf.
    6. Regione: seleziona la regione per il trigger.
    7. Service account: seleziona il account di servizio da utilizzare per il trigger. Se non selezioni unaccount di serviziot, il trigger utilizza il service account Compute Engine predefinito come identità quando richiama il servizio. Il account di servizio associato al trigger deve disporre delle autorizzazioni richieste per richiamare il servizio.
    8. Destinazione evento: seleziona Application Integration.
    9. Seleziona un'integrazione: seleziona l'integrazione per cui vuoi creare il trigger. Se l'integrazione viene pubblicata, Application Integration crea una nuova versione bozza dell' integrazione a cui aggiungere il trigger Eventarc.
    10. Collegamento di rete: seleziona il collegamento di rete da utilizzare per il trigger. Questo elenco viene generato in base ai collegamenti di rete creati nel tuo progetto.

      Gli allegati di rete facilitano la comunicazione tra le reti Virtual Private Cloud (VPC) del producer di servizi e le reti VPC consumer. Eventarc utilizza il collegamento di rete configurato per stabilire una connessione a un endpoint HTTP interno ospitato all'interno della rete VPC del consumer, consentendo la distribuzione dei dati sugli eventi. Per ulteriori informazioni sui collegamenti di rete, consulta Informazioni sui collegamenti di rete.

  4. Fai clic su Open integration (Apri integrazione).

    Si apre la pagina dell'editor di Application Integration con l'integrazione selezionata e il nuovo elemento trigger Eventarc aggiunto all'integrazione.

  5. Fai clic sull'elemento Trigger Eventarc e apri il riquadro di configurazione del trigger.
  6. Esamina e verifica la configurazione del trigger nella pagina Editor trigger Eventarc.
  7. Collega il nuovo trigger Eventarc al flusso di integrazione e pubblica l'integrazione.