Inoltra gli eventi a un endpoint HTTP interno in una rete VPC

Console

1. Nella console Google Cloud , nella pagina del selettore di progetti, seleziona o crea un Google Cloud progetto.

   Vai al selettore dei progetti

2. Abilita le API Cloud Logging ed Eventarc.

   Abilita le API

3. Se applicabile, abilita l'API relativa agli eventi diretti. Ad esempio, per gli eventi Cloud Run Functions, attiva cloudfunctions.googleapis.com.

4. Se non ne hai già uno, crea un account di servizio gestito dall'utente, poi concedigli i ruoli e le autorizzazioni necessari affinché Eventarc possa gestire gli eventi per il servizio di destinazione.

   1. Nella console Google Cloud , vai alla pagina Crea service account.

      Vai a Crea service account

   2. Seleziona il progetto.

   3. Nel campo Nome account di servizio, inserisci un nome. La console Google Cloud compila il campo ID service account in base a questo nome.

      Nel campo Descrizione service account, inserisci una descrizione. Ad esempio, Service account for event trigger.

   4. Fai clic su Crea e continua.

   5. Per fornire l'accesso appropriato, nell'elenco Seleziona un ruolo, seleziona i ruoli Identity and Access Management (IAM) richiesti da concedere al tuo service account. Per maggiori informazioni, consulta la sezione Ruoli e autorizzazioni per un endpoint HTTP interno in una rete VPC.

      Per altri ruoli, fai clic su add Aggiungi un altro ruolo e aggiungi ogni ruolo aggiuntivo.

   6. Fai clic su Continua.

   7. Per completare la creazione dell'account, fai clic su Fine.

5. Se stai creando un trigger per eventi diretti da Cloud Storage, concedi il ruolo Publisher Pub/Sub (roles/pubsub.publisher) al service agent Cloud Storage:

   1. Nella console Google Cloud vai alla pagina IAM.

      Vai a IAM

   2. Seleziona la casella di controllo Includi concessioni di ruoli fornite da Google.

   3. Nella colonna Entità, trova l'agente di servizio Cloud Storage con il modulo service-PROJECT_NUMBER@gs-project-accounts.iam.gserviceaccount.com, quindi fai clic su edit Modifica entità nella riga corrispondente.

   4. Fai clic su add Aggiungi ruolo o su add Aggiungi un altro ruolo.

   5. Nell'elenco Seleziona un ruolo, filtra per Pub/Sub Publisher e poi seleziona il ruolo.

   6. Fai clic su Salva.

6. Se l'URI dell'endpoint HTTP interno nella rete VPC utilizza il nome DNS interno di un servizio risolvibile da Cloud DNS, concedi il ruolo peer DNS (roles/dns.peer) nel progetto host VPC all'agente di servizio Eventarc.

   Tieni presente che, a seconda di come hai configurato la rete VPC, il progetto host VPC potrebbe essere anche il progetto trigger Eventarc.

   1. Nella console Google Cloud , nella pagina del selettore dei progetti, seleziona il progetto host VPC.

      Vai al selettore dei progetti

   2. Nella console Google Cloud vai alla pagina IAM.

      Vai a IAM

   3. Seleziona la casella di controllo Includi concessioni di ruoli fornite da Google.

   4. Modifica o aggiungi l'agente di servizio Eventarc come entità:

      • Se l'agente di servizio Eventarc ha già altri ruoli nel progetto, individua la riga contenente l'entità nel formato service-PROJECT_NUMBER@gcp-sa-eventarc.iam.gserviceaccount.com, fai clic su edit Modifica entità nella riga e fai clic su add Aggiungi un altro ruolo.

      • Se l'agente di servizio Eventarc non ha ruoli esistenti nel progetto, fai clic su person_add Concedi accesso, quindi inserisci l'indirizzo email nel modulo service-PROJECT_NUMBER@gcp-sa-eventarc.iam.gserviceaccount.com.

      Sostituisci PROJECT_NUMBER con il numero di progetto Google Cloud del progetto di trigger Eventarc. Puoi trovare il numero di progetto nella pagina Benvenuto della console Google Cloud o eseguendo il seguente comando:

      gcloud projects describe PROJECT_ID --format='value(projectNumber)'

   5. Nell'elenco Seleziona un ruolo, filtra per Peer DNS, quindi seleziona il ruolo.

   6. Fai clic su Salva.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

   At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

2. Abilita le API Cloud Logging, Eventarc e Eventarc Publishing.

   gcloud services enable logging.googleapis.com \
     eventarc.googleapis.com \
     eventarcpublishing.googleapis.com

3. Se applicabile, abilita l'API correlata agli eventi. Ad esempio, per gli eventi di Cloud Run Functions, attiva cloudfunctions.googleapis.com.

4. Se non ne hai già uno, crea un account di servizio gestito dall'utente e concedigli i ruoli e le autorizzazioni necessari affinché Eventarc possa gestire gli eventi per il servizio di destinazione.

   1. Crea l'account di servizio:

      gcloud iam service-accounts create SERVICE_ACCOUNT_NAME

      Sostituisci SERVICE_ACCOUNT_NAME con il nome del account di servizio. Deve essere compreso tra 6 e 30 caratteri e può contenere caratteri alfanumerici minuscoli e trattini. Una volta creato un account di servizio, non puoi modificarne il nome.

   2. Concedi i ruoli o le autorizzazioni IAM (Identity and Access Management) richiesti. Per maggiori informazioni, consulta la sezione Ruoli e autorizzazioni per un endpoint HTTP interno in una rete VPC.

5. Se l'URI dell'endpoint HTTP interno nella rete VPC utilizza il nome DNS interno di un servizio risolvibile da Cloud DNS, concedi il ruolo Peer DNS (roles/dns.peer) nel progetto host VPC all'agente di servizio Eventarc.

   Tieni presente che, a seconda di come hai configurato la rete VPC, il progetto host VPC potrebbe essere anche il progetto trigger Eventarc.

   gcloud projects add-iam-policy-binding VPC_HOST_PROJECT_ID \
       --member=serviceAccount:service-PROJECT_NUMBER@gcp-sa-eventarc.iam.gserviceaccount.com \
       --role=roles/dns.peer

   Sostituisci quanto segue:

   • VPC_HOST_PROJECT_ID: l' Google Cloud ID progetto per il progetto host VPC.
   • PROJECT_NUMBER: il Google Cloud numero di progetto per il progetto del trigger Eventarc. Puoi trovare il numero di progetto nella pagina Benvenuto della console Google Cloud o eseguendo il seguente comando:

   gcloud projects describe PROJECT_ID --format='value(projectNumber)'

6. Se stai creando un trigger per eventi diretti da Cloud Storage, concedi il ruolo Pub/Sub Publisher (roles/pubsub.publisher) sul progetto al service agent Cloud Storage:

   gcloud projects add-iam-policy-binding PROJECT_ID \
       --member=serviceAccount:service-PROJECT_NUMBER@gs-project-accounts.iam.gserviceaccount.com \
       --role=roles/pubsub.publisher

Console

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

   Vai ai trigger

2. Fai clic su add_box Crea trigger.
3. Digita un Nome trigger.

   Questo è l'ID del trigger e deve iniziare con una lettera. Può contenere fino a 63 lettere minuscole, numeri o trattini.

4. Per Tipo di trigger, seleziona Origini Google o Di terze parti.
5. Seleziona un fornitore di eventi.

   Questo è il servizio che è l'origine degli eventi. Per un'origine Google, questo avviene direttamente o tramite i relativi audit log.

6. A seconda del tipo di evento che stai instradando, esegui una delle seguenti operazioni:
   1. Eventi diretti: nell'elenco Tipo di evento, seleziona un tipo di evento tra quelli Diretti.
      1. Per gli eventi Cloud Pub/Sub diretti, nell'elenco Seleziona un argomento Cloud Pub/Sub, seleziona un argomento o accetta il valore predefinito Nessuno in modo che venga creato un nuovo argomento.
      2. Per gli eventi diretti di Cloud Storage, specifica o cerca l'identificatore univoco globale del bucket Cloud Storage.
   2. Eventi dei log di controllo: nell'elenco Tipo di evento, seleziona un tipo di evento tra gli eventi tramite Cloud Audit Logs, quindi seleziona una delle seguenti opzioni:
      • Qualsiasi risorsa: questa è l'impostazione predefinita e include risorse create dinamicamente con identificatori generati al momento della creazione.
      • Risorsa specifica: devi fornire il nome completo della risorsa.
      • Pattern del percorso: puoi filtrare le risorse utilizzando un pattern del percorso. Ad esempio, digita projects/_/buckets/eventarc-bucket/objects/random.txt o digita projects/_/buckets/**/r*.txt.
   3. Eventi di terze parti: nell'elenco Canale, seleziona un canale e poi, nell'elenco Tipo di evento, seleziona un evento.

      Per ulteriori informazioni, vedi Creare un canale e recuperarne i dettagli.

7. Se applicabile al tipo di evento, nell'elenco Tipo di contenuti dei dati evento, seleziona application/json o application/protobuf per specificare la codifica del payload dell'evento.

   Tieni presente che un payload evento formattato in JSON è più grande di uno formattato in Protobuf. Ciò potrebbe influire sull'affidabilità a seconda della destinazione dell'evento e dei suoi limiti di dimensione. Per saperne di più, consulta la sezione Problemi noti.

8. Se applicabile al fornitore di eventi, fai clic su Aggiungi filtro e specifica quanto segue:
   1. Nel campo Attributo 1, a seconda dell'evento diretto che hai scelto, seleziona un ID risorsa che può fungere da filtro per gli eventi.
   2. Seleziona un operatore:
      • Uguale
      • Pattern del percorso

        Per saperne di più, consulta Informazioni sui pattern di percorso.

   3. Nel campo Valore attributo 1, a seconda dell'operatore che hai scelto, digita il valore esatto o applica un pattern di percorso.
   4. Se è applicabile un campo Attributo 2, specifica i valori appropriati.
9. Nell'elenco Regione, seleziona una località.

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

   Tieni presente che per questa destinazione evento sono supportate solo le seguenti località:

   • asia-east1
   • europe-north1
   • europe-west1
   • us-east1

   Per saperne di più, consulta Località Eventarc.

10. Seleziona l'account di servizio che richiamerà il tuo servizio.

    In alternativa, puoi creare un nuovo account di servizio.

    Specifica l'indirizzo email del account di servizio IAM associato al trigger e a cui hai concesso in precedenza ruoli specifici richiesti da Eventarc.

11. Nell'elenco Destinazione evento, seleziona Endpoint HTTP (interno).
    1. Specifica l'URI di destinazione. Questo è l'URI dell'endpoint HTTP interno nella rete VPC che riceve gli eventi per il trigger. L'URI può essere un indirizzo IP interno statico nella rete VPC indirizzata dall'allegato di rete o il nome DNS interno di un servizio risolvibile da Cloud DNS.

       Se l'endpoint HTTP utilizza un nome DNS interno, Eventarc crea automaticamente zone di peering DNS e inoltra le richieste DNS alle zone DNS nella rete VPC di destinazione. Il peering DNS consente di inviare richieste di record provenienti dallo spazio dei nomi di una zona a un'altra rete VPC. Per saperne di più, consulta Zone di peering e Creare una zona di peering.

       Tieni presente che non puoi creare più di un trigger per lo stesso nome DNS.

    2. Nell'elenco Collegamento di rete, seleziona un identificatore per la risorsa di collegamento di rete. Questo identificatore viene generato dopo la creazione di un collegamento di rete. Per ulteriori informazioni, vedi Creare collegamenti di rete.

       I collegamenti di rete consentono alle reti VPC del producer di servizi di avviare connessioni alle reti VPC consumer. Eventarc utilizza il collegamento di rete per stabilire una connessione all'endpoint HTTP interno ospitato nella rete VPC del consumer e pubblicare eventi.

       Quando crei un collegamento di rete, puoi autorizzare esplicitamente una connessione tramite gli elenchi di accettazione e rifiuto del producer; in ogni caso, Eventarc può aggiornare l'elenco di accettazione di un collegamento di rete con l'ID progetto appropriato e senza alcun intervento da parte tua.

12. Fai clic su Crea.

Una volta creato un trigger, i filtri dell'origine eventi non possono essere modificati. Crea invece un nuovo trigger ed elimina quello precedente. Per saperne di più, consulta Gestire i trigger.

gcloud

Puoi creare un trigger eseguendo un comando gcloud eventarc triggers create insieme ai flag obbligatori e facoltativi.

gcloud eventarc triggers create TRIGGER \
    --location=LOCATION \
    --destination-http-endpoint-uri=ENDPOINT_URI \
    --network-attachment=NETWORK_ATTACHMENT_ID \
    --event-filters="type=EVENT_FILTER_TYPE" \
    --event-filters="COLLECTION_ID=RESOURCE_ID" \
    --event-filters-path-pattern="COLLECTION_ID=PATH_PATTERN" \
    --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com"

gcloud eventarc triggers create helloworld-trigger \
    --location=us-central1 \
    --destination-http-endpoint-uri=http://my-vm.us-central1-a.c.my-project.internal \
    --network-attachment="projects/my-project/regions/us-central1/networkAttachments/my-attachment-name" \
    --event-filters="type=google.cloud.pubsub.topic.v1.messagePublished" \
    --service-account=my-service-account@my-project.iam.gserviceaccount.com

gcloud eventarc triggers create TRIGGER \
    --location=LOCATION \
    --destination-http-endpoint-uri=ENDPOINT_URI \
    --network-attachment=NETWORK_ATTACHMENT_ID \
    --event-filters="type=google.cloud.audit.log.v1.written" \
    --event-filters="serviceName=SERVICE_NAME" \
    --event-filters="methodName=METHOD_NAME" \
    --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com"

gcloud eventarc triggers create helloworld-trigger \
    --location=us-central1 \
    --destination-http-endpoint-uri=http://10.10.10.2 \
    --network-attachment="projects/my-project/regions/us-central1/networkAttachments/my-attachment" \
    --event-filters="type=google.cloud.audit.log.v1.written" \
    --event-filters="serviceName=eventarc.googleapis.com" \
    --event-filters="methodName=google.cloud.eventarc.v1.Eventarc.GetTrigger" \
    --event-filters="resourceName=projects/my-project/locations/us-central1/triggers/my-trigger" \
    --service-account=my-service-account@my-project.iam.gserviceaccount.com

gcloud eventarc triggers create TRIGGER \
    --location=LOCATION \
    --destination-http-endpoint-uri=ENDPOINT_URI \
    --network-attachment=NETWORK_ATTACHMENT_ID \
    --event-filters="type=EVENT_FILTER_TYPE" \
    --channel=CHANNEL_NAME \
    --project=PROJECT_ID \
    --service-account=SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com"

gcloud eventarc triggers create helloworld-trigger \
    --location=us-central1 \
    --destination-http-endpoint-uri=http://my-vm.us-central1-a.c.my-project.internal \
    --network-attachment="projects/my-project/regions/us-central1/networkAttachments/my-attachment-name" \
    --event-filters="type=third-party-event-type" \
    --channel=my-channel \
    --project=my-project-ID \
    --service-account=my-service-account@my-project.iam.gserviceaccount.com

Console

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

   Vai ai trigger

   Questa pagina elenca i trigger in tutte le posizioni e include dettagli quali nomi, regioni, fornitori di eventi, destinazioni e altro ancora.

2. Per filtrare i trigger:

   1. Fai clic su filter_list Filtro o sul campo Trigger del filtro.
   2. Nell'elenco Proprietà, seleziona un'opzione per filtrare gli attivatori.

   Puoi selezionare una singola proprietà o utilizzare l'operatore logico OR per aggiungere altre proprietà.

3. Per ordinare i trigger, fai clic su arrow_upward Ordina accanto a un'intestazione di colonna supportata.

gcloud

Esegui questo comando per elencare i trigger:

gcloud eventarc triggers list --location=-

Questo comando elenca i trigger in tutte le posizioni e include dettagli come nomi, tipi, destinazioni e stati.