Consulta i connettori supportati per Application Integration.

Trigger di Cloud Pub/Sub

Il trigger di Cloud Pub/Sub consente di eseguire l'integrazione in base agli eventi nel middleware Pub/Sub.

Utilizzando questo attivatore, puoi eseguire un'integrazione ogni volta che un publisher scrive un messaggio per l'argomento scelto. L'argomento può trovarsi nello stesso progetto Google Cloud dell'integrazione o in un altro progetto Google Cloud. Quando questo trigger viene eseguito, scrive anche il messaggio pubblicato nella variabile di output CloudPubSubMessage. In base ai tuoi requisiti, puoi utilizzare questa variabile nei trigger o nelle attività downstream.

Prima di iniziare

Assicurati di eseguire le attività seguenti nel progetto Google Cloud prima di configurare il trigger di Cloud Pub/Sub.

• Assegna l'amministratore IAM progetto (roles/resourcemanager.projectIamAdmin) all'utente che crea questo trigger.
• Abilita l'API Pub/Sub per il progetto Google Cloud che include la tua integrazione.
• Verifica di avere un argomento Pub/Sub. Per creare un nuovo argomento Pub/Sub:
  1. Vai alla pagina degli argomenti Pub/Sub nella console Cloud.

     Vai alla pagina degli argomenti Pub/Sub

  2. Fai clic su Crea un argomento.
  3. Nel campo ID argomento, fornisci un nome univoco per l'argomento.
  4. Fai clic su Salva.
  Nota: per il funzionamento del trigger non è necessario creare un abbonamento. Application Integration crea automaticamente una sottoscrizione per un argomento quando pubblichi l'integrazione. Puoi visualizzare tutti gli abbonamenti nella pagina Sottoscrizioni Pub/Sub.

  A partire dalla release di Application Integration del 1° dicembre 2023, ti verranno addebitati gli abbonamenti in base alle tariffe di fatturazione di Pub/Sub. Gli abbonamenti per il trigger Cloud Pub/Sub esistente continueranno a funzionare come prima e non verranno fatturati. Tuttavia, se aggiorni l'argomento di un trigger Cloud Pub/Sub esistente, la fatturazione Pub/Sub verrà applicata al trigger Cloud Pub/Sub aggiornato.

Per maggiori informazioni sulla gestione dell'accesso utilizzando i ruoli IAM, consulta Controllo dell'accesso.

Per informazioni sulla concessione dei ruoli alle entità, vedi Concessione, modifica e revoca dell'accesso.

Aggiungi un trigger di Cloud Pub/Sub

Per aggiungere un trigger di Cloud Pub/Sub a un'integrazione nuova o esistente, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Application Integration.

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Integrations (Integrazioni).

   Viene visualizzata la pagina Integrations List (Elenco delle integrazioni), in cui sono elencate 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.
      Nota:il menu a discesa Regioni elenca solo le regioni di cui è stato eseguito il provisioning nel progetto Google Cloud. Per eseguire il provisioning di una nuova regione, fai clic su Attiva regione. Per saperne di più, consulta Attivare una nuova regione.
   3. Seleziona un account di servizio per l'integrazione. Puoi modificare o aggiornare i dettagli dell'account di servizio di un'integrazione in qualsiasi momento dal riquadro Riepilogo dell'integrazione nella barra degli strumenti dell'integrazione.
      Nota: l'opzione per selezionare un account di servizio viene visualizzata solo se hai abilitato la governance dell'integrazione per la regione selezionata.
   4. Fai clic su Crea.

   L'integrazione viene aperta nell'editor dell'integrazione.

4. Nella barra di navigazione dell'editor di integrazione, fai clic su Trigger per visualizzare l'elenco degli attivatori disponibili.
5. Fai clic sull'elemento trigger Cloud Pub/Sub e posizionalo nel designer.

configura un trigger di Cloud Pub/Sub

Fai clic sull'elemento Trigger Cloud Pub/Sub nell'editor dell'integrazione per visualizzare il riquadro di configurazione del trigger, quindi esegui le attività seguenti:

1. Specifica l'argomento che il trigger deve ascoltare nel campo Argomento Pub/Sub nel seguente formato:

   projects/PROJECT_ID/topics/TOPIC_ID

   Per visualizzare tutti gli argomenti disponibili nel tuo progetto Google Cloud, consulta la colonna Nome argomento in Argomenti. Puoi anche selezionare un argomento da un altro progetto Google Cloud.

   Sostituisci quanto segue:
   • PROJECT_ID: il progetto Google Cloud in cui viene creato l'argomento.
   • TOPIC_ID: l'ID dell'argomento Pub/Sub. L'argomento può trovarsi nello stesso progetto Google Cloud dell'integrazione o in un altro progetto Google Cloud.
2. Seleziona l'account di servizio che vuoi utilizzare per richiamare l'integrazione. Puoi anche scegliere una variabile di configurazione che hai creato nell'integrazione. Il valore della variabile di configurazione deve essere l'indirizzo email di un account di servizio nel seguente formato: [e-mail]. Ad esempio: [e-mail].

   Per informazioni su come creare una variabile di configurazione, consulta Creare una variabile e su come creare un account di servizio, consulta Creazione di un account di servizio.

   Se scegli una variabile di configurazione, devi concedere i ruoli richiesti all'account di servizio a cui fa riferimento la variabile di configurazione. Per saperne di più su come concedere i ruoli, consulta Ruoli IAM richiesti.

   Se non sono presenti account di servizio, creane uno facendo clic su Crea nuovo nell'elenco Account di servizio.

   Nota: a partire dalla release di Application Integration del 1° dicembre 2023, quando configuri il trigger di Cloud Pub/Sub, devi specificare un account di servizio per il trigger. I trigger Pub/Sub esistenti, a cui non è associato alcun account di servizio, continueranno a funzionare come prima. Tuttavia, se vuoi modificare uno dei trigger Pub/Sub esistenti, devi configurare un account di servizio per continuare a utilizzare questi trigger.

Per impostazione predefinita, l'opzione del periodo di scadenza per gli abbonamenti è impostata su never expire. Se vuoi impostare la scadenza su un altro valore, vai alla pagina Sottoscrizioni Pub/Sub nella console Google Cloud e modifica l'abbonamento.

Ruoli IAM richiesti per gli account di servizio

Se fai clic su Concedi quando selezioni un account di servizio, i ruoli seguenti vengono forniti automaticamente ai vari account di servizio.

Service account	Ruolo IAM concesso
Account di servizio predefinito di Application Integration: [e-mail]	Editor Pub/Sub (roles/pubsub.editor) Utente account di servizio (roles/iam.serviceAccountUser) Se il progetto Google Cloud dell'argomento Pub/Sub è diverso dal progetto Google Cloud dell'integrazione, l'account di servizio predefinito deve avere il ruolo Editor Pub/Sub nel progetto Google Cloud dell'argomento.
Account di servizio selezionato per questo trigger	Invoker di Application Integration (roles/integrations.integrationInvoker)

Output trigger

Per ogni evento, il trigger di Cloud Pub/Sub genera una variabile di output CloudPubSubMessage che puoi utilizzare nelle attività downstream. La variabile è in formato JSON e ha la struttura PubsubMessage.

Considerazioni

• La dimensione massima di un messaggio Pub/Sub è 10 MB. Per comprendere tutte le limitazioni di Pub/Sub, consulta Quote e limiti di Pub/Sub.
• È possibile che Pub/Sub scriva lo stesso messaggio più di una volta in un argomento. Per comprendere questo comportamento di Pub/Sub, consulta Consegna at-Least-Una volta. Pertanto, devi progettare l'integrazione in modo che sia idempotente, in modo da non consentire di scrivere un messaggio più di una volta in un argomento.

  Il campo message_id nell'intestazione del messaggio identifica in modo univoco un messaggio Pub/Sub.

• Se annulli la pubblicazione di un'integrazione, la sottoscrizione Pub/Sub non viene eliminata per evitare la perdita di messaggi. Tuttavia, se elimini la versione pubblicata o tutte le versioni di integrazione di un'integrazione, viene eliminata anche la sottoscrizione Pub/Sub.

Crea una sottoscrizione con filtro per l'integrazione

Se vuoi impostare un filtro per la sottoscrizione Pub/Sub per elaborare eventi specifici nell'integrazione, segui questi passaggi:

1. Pubblica l'integrazione con il trigger di Cloud Pub/Sub configurato. Questo passaggio crea la sottoscrizione nel progetto di integrazione.
2. Nella console Google Cloud, vai alla pagina Abbonamenti.

   Vai ad Abbonamenti

3. Apri l'abbonamento e copia tutti i dettagli, incluso il nome.
4. Elimina l'abbonamento esistente.
5. Crea un nuovo abbonamento con tutti i dettagli dell'abbonamento eliminato, incluso il nome dell'abbonamento che hai copiato nel passaggio 3, e aggiungi un filtro nel nuovo abbonamento.

   La sottoscrizione appena creata attiva l'integrazione con i messaggi filtrati.

Esclusioni SLA

Il trigger di Cloud Pub/Sub dipende dal prodotto Pub/Sub. Poiché questa dipendenza è esterna ad Application Integration, i termini e le condizioni dell'accordo sul livello del servizio (SLA) di Application Integration sono applicabili solo quando il trigger di Cloud Pub/Sub avvia correttamente l'esecuzione di un'integrazione active.