Pubblica e ricevi eventi creando un bus e una registrazione (console)

Crea una subnet e abilita l'accesso privato Google

A meno che tu non crei un criterio dell'organizzazione che lo vieti, i nuovi progetti Google Cloud iniziano con una rete Virtual Private Cloud (VPC) predefinita (una rete VPC in modalità automatica) con una subnet in ogni regione. Alle subnet sono associati intervalli di indirizzi IP.

Poiché esegui il routing dei messaggi verso una destinazione Cloud Run utilizzando un indirizzo DNS, devi abilitare l'accesso privato Google nella subnet utilizzata nell'allegato di rete; in caso contrario, l'indirizzo DNS non può essere risolto. Per saperne di più sul networking privato e su Cloud Run, consulta Ricevere richieste dalle reti VPC.

Crea una subnet nella rete predefinita del progetto e abilita l'accesso privato Google:

1. Nella console Google Cloud , vai alla pagina Reti VPC.

   Vai a Reti VPC

2. Nell'elenco delle reti VPC, fai clic sul nome default.

3. Nella pagina Dettagli rete VPC, fai clic sulla scheda Subnet.

4. Fai clic su add_box Aggiungi subnet.

5. Nel riquadro Aggiungi una subnet, procedi nel seguente modo:

   1. Inserisci un Nome, ad esempio my-subnet.
   2. Nell'elenco Regione, seleziona us-central1.
   3. Inserisci un intervallo IPv4 principale per la subnet, ad esempio 10.8.0.0/24.
   4. Per Accesso privato Google, seleziona On.
   5. Accetta tutti gli altri valori predefiniti.
   6. Fai clic su Aggiungi.

Gli intervalli di indirizzi IP delle subnet devono essere univoci e non devono sovrapporsi all'interno di una rete VPC e di una rete VPC in peering. Per saperne di più sui tipi di subnet e sugli intervalli di subnet validi, consulta Subnet.

Crea un collegamento di rete

Un collegamento di rete è una risorsa che consente a una rete VPC producer di avviare connessioni a una rete VPC consumer. Per pubblicare eventi, Eventarc Advanced utilizza il collegamento di rete per stabilire una connessione all'endpoint ospitato in una rete VPC.

Crea un collegamento di rete nella stessa rete e regione contenente l'endpoint di destinazione eventi e che accetta automaticamente le connessioni da qualsiasi interfaccia Private Service Connect che fa riferimento al collegamento di rete:

1. Nella console Google Cloud , vai a Private Service Connect.

   Vai a Private Service Connect

2. Fai clic sulla scheda Allegati di rete.

3. Fai clic su add Crea collegamento di rete.

4. Inserisci un Nome, ad esempio my-network-attachment.

5. Nell'elenco Rete, seleziona valore predefinito.

6. Nell'elenco Regione, seleziona us-central1 (Iowa).

7. Nell'elenco Subnet, seleziona la subnet creata in precedenza.

8. Fai clic su Accetta automaticamente le connessioni per tutti i progetti.

9. Fai clic su Crea collegamento di rete.

Crea un repository standard Artifact Registry

Crea un repository standard di Artifact Registry per archiviare l'immagine container.

1. Nella console Google Cloud , vai alla pagina Repository.

   Vai a Repository

2. Fai clic su add Crea repository.

3. Inserisci un Nome, ad esempio my-repo.

   Per ogni posizione del repository in un progetto, i nomi dei repository devono essere univoci.

4. Per il Formato del repository, seleziona Docker.

5. Nell'elenco Regione, seleziona us-central1 (Iowa).

6. Accetta tutti gli altri valori predefiniti.

7. Fai clic su Crea.

Esegui il deployment di un servizio di ricezione di eventi in Cloud Run

Esegui il deployment di un servizio Cloud Run che registra i contenuti di un evento. Questo servizio è accessibile solo dalle reti VPC nello stesso progetto e l'URL del servizio non è direttamente accessibile perché il servizio consente solo chiamate autenticate.

1. Nel terminale, clona il repository GitHub:

   git clone https://github.com/GoogleCloudPlatform/eventarc-samples.git

2. Passa alla directory che contiene il codice campione di Cloud Run:

   cd eventarc-samples/eventarc-advanced-quickstart/

3. Crea un'immagine container Docker ed eseguirne il push nel repository:

   gcloud builds submit \
       --tag $REGION-docker.pkg.dev/PROJECT_ID/REPOSITORY/log-events:v1

   Sostituisci REPOSITORY con il nome del tuo repository Artifact Registry.

4. Esegui il deployment dell'immagine container su Cloud Run:

   1. Nella Google Cloud console, vai alla pagina Cloud Run.

      Vai a Cloud Run

   2. Fai clic su add_box Esegui il deployment del container > Servizio.

   3. Seleziona Esegui il deployment di una revisione da un'immagine container esistente.

   4. Per l'URL immagine container, fai clic su Seleziona per specificare l'immagine container di Artifact Registry che hai creato in precedenza.

   5. Se vuoi, puoi modificare il Nome servizio, ad esempio in my-service.

   6. Nell'elenco Regione, seleziona us-central1 (Iowa).

   7. Per Autenticazione, seleziona Richiedi autenticazione.

   8. Per Ingresso, seleziona Interno.

   9. Accetta tutti gli altri valori predefiniti.

   10. Fai clic su Crea e attendi il completamento del deployment.

Crea un bus Eventarc Advanced

Un bus riceve messaggi di eventi da un'origine messaggi o pubblicati da un provider e funge da router di messaggi.

Per maggiori informazioni, vedi Creare un bus per instradare i messaggi.

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

   Vai a Bus

2. Fai clic su add_box Crea bus.

3. Nella pagina Crea un bus:

   1. Inserisci un Nome bus, ad esempio my-bus.
   2. Nell'elenco Regione, seleziona us-central1 (Iowa).

4. Accetta tutti gli altri valori predefiniti.

5. Fai clic su Crea.

Crea una registrazione Eventarc Advanced

Una registrazione determina quali messaggi vengono instradati a una destinazione e specifica anche la pipeline utilizzata per configurare una destinazione per i messaggi di evento.

Per ulteriori informazioni, vedi Creare una registrazione per ricevere eventi.

Quando utilizzi la console Google Cloud , puoi creare contemporaneamente una registrazione e una pipeline.

1. Per creare una registrazione, nella console Google Cloud , vai alla pagina Eventarc > Pipeline.

   Vai a Pipeline

2. Fai clic su add_box Crea pipeline.

3. Nel riquadro Dettagli pipeline, segui questi passaggi:

   1. Inserisci un Nome pipeline, ad esempio my-pipeline.
   2. Nell'elenco Regione, seleziona us-central1 (Iowa). La pipeline deve essere creata nella stessa regione del bus.
   3. Accetta tutti gli altri valori predefiniti.
   4. Fai clic su Continua.

4. Nel riquadro Registrazioni, segui questi passaggi:

   1. Fai clic su Aggiungi registrazione.
   2. Inserisci un Nome registrazione, ad esempio my-enrollment.
   3. Nell'elenco Bus Eventarc Advanced, seleziona il bus creato in precedenza.

   4. Nel campo Espressione CEL, scrivi un'espressione di valutazione utilizzando CEL. Ad esempio:

      message.type == "hello-world-type"

   5. Fai clic su Fine.

   6. Fai clic su Continua.

   7. Nel riquadro Mediazione degli eventi, fai di nuovo clic su Continua.

5. Nel riquadro Destinazione, procedi nel seguente modo:

   1. Nell'elenco Tipo di destinazione, seleziona Servizio Cloud Run (tramite HTTP) e poi seleziona il servizio Cloud Run che hai creato in precedenza.

   2. Nell'elenco Collegamento di rete, seleziona il collegamento di rete che hai creato in precedenza.

   3. Seleziona la casella di controllo Abilita autenticazione.

      1. Nell'elenco Intestazione di autenticazione, seleziona Token OIDC.

      2. Nell'elenco Service account, seleziona il account di servizio che hai creato in precedenza e che richiamerà il servizio di destinazione. Questo indirizzo email dell'account di servizio viene utilizzato per generare il token OIDC.

6. Fai clic su Crea.

Pubblica un messaggio di evento nel bus

Per pubblicare direttamente un messaggio nel bus, puoi utilizzare il comando gcloud beta eventarc message-buses publish o inviare una richiesta all'API REST di pubblicazione di Eventarc. Per ulteriori informazioni, vedi Pubblicare eventi direttamente.

Il messaggio deve essere in formato CloudEvents, una specifica per descrivere i dati degli eventi in modo comune. L'elemento data è il payload del tuo evento. In questo campo può essere inserito qualsiasi JSON ben formato. Per saperne di più sugli attributi di contesto CloudEvents, consulta Formato dell'evento.

Pubblica un evento nel bus Eventarc Advanced utilizzando l'interfaccia alla gcloud CLI e un --event-data e altri flag di attributo evento:

gcloud beta eventarc message-buses publish BUS_NAME \
    --event-data='{"key": "hello-world-data"}' \
    --event-id=hello-world-id-1234 \
    --event-source=hello-world-source \
    --event-type=hello-world-type \
    --event-attributes="datacontenttype=application/json" \
    --location=$REGION

In alternativa, pubblica un evento nel bus Eventarc Advanced come messaggio JSON utilizzando gcloud CLI e un flag --json-message:

gcloud beta eventarc message-buses publish BUS_NAME \
    --location=$REGION \
    --json-message='{"id": "hello-world-id-1234", "type":
 "hello-world-type", "source":
 "hello-world-source", "specversion": "1.0", "data":
 {"key": "hello-world-data"}}'

Dopo aver pubblicato un evento, dovresti ricevere un messaggio "Evento pubblicato correttamente".

Visualizza i dati sugli eventi nei log di Cloud Run

Dopo aver pubblicato un evento nel bus Eventarc Advanced, puoi controllare i log del servizio Cloud Run per verificare che l'evento sia stato ricevuto come previsto.

1. Nella Google Cloud console, vai alla pagina Cloud Run.

   Vai a Cloud Run

2. Nella pagina Servizi, fai clic sul nome del servizio.

3. Fai clic sulla scheda Log.

4. Puoi filtrare le voci di log e restituire l'output. Ad esempio, puoi cercare hello-world-data.

5. Cerca una voce di log simile alla seguente:

   2025-02-27 08:36:44.350 EST [2025-02-27 13:36:44,352] INFO in server: Body: b'{"key": "hello-world-data"}'
   

Hai creato correttamente un bus e una registrazione Eventarc Advanced, hai pubblicato un messaggio di evento nel bus e hai verificato il risultato previsto nei log del servizio di ricezione eventi.