Test the configuration

Standard

Test a third-party configuration and ensure that the event subscription and publishing flow is working as expected. The following is a recommended way to approach this task.

Prerequisites

You will need the following values that you specified when registering as a provider :
- PROVIDER_NAME : the provider name that subscribers will specify when subscribing to events.
- PUBLISHER_PROJECT_ID : the provider's Google Cloud project that is used to publish events.
- SUBSCRIBER_PROJECT_ID : the subscriber's Google Cloud project ID used to subscribe to events for testing or during any alpha period.
- EVENT_TYPE : the event types published by the event provider.

Use the Google Cloud CLI to enable the Eventarc API in your subscriber project, and to enable the Eventarc Publishing API in both your publisher and subscriber projects:

 gcloud  
services  
 enable 
  
eventarc.googleapis.com  
--project = 
 SUBSCRIBER_PROJECT_ID 
gcloud  
services  
 enable 
  
eventarcpublishing.googleapis.com  
--project = 
 PUBLISHER_PROJECT_ID 
gcloud  
services  
 enable 
  
eventarcpublishing.googleapis.com  
--project = 
 SUBSCRIBER_PROJECT_ID

Event subscription and publishing test

This test includes creating a channel, a channel connection, and a trigger. To ensure that an event is delivered to the trigger's destination, an event receiver is deployed: a Workflows workflow that logs received events. All steps in the test must succeed.

Note that you must use a service account that has been granted the appropriate roles to access your Google Cloud project resources.

Subscriber tasks

In the subscriber project, do the following:

Create a channel to support the interaction with the provider.
```
 gcloud  
eventarc  
channels  
create  
 CHANNEL_NAME 
  
 \ 
  
--provider  
 PROVIDER_NAME 
  
 \ 
  
--project  
 SUBSCRIBER_PROJECT_ID 
  
 \ 
  
--location  
 LOCATION 
 
```
Replace the following:
- CHANNEL_NAME : a name for the channel
- PROVIDER_NAME : the provider's name; see List event providers
- SUBSCRIBER_PROJECT_ID : the subscriber's Google Cloud project ID
- LOCATION : a supported Eventarc region
For details, see Create a channel .

Retrieve specific channel properties.

 gcloud  
eventarc  
channels  
describe  
 CHANNEL_NAME 
  
 \ 
  
--project  
 SUBSCRIBER_PROJECT_ID 
  
 \ 
  
--location  
 LOCATION

In the output, note the activationToken value and the channel name .

For details, see Retrieve channel details .

Enable the Workflows APIs:

 gcloud  
services  
 enable 
  
workflows.googleapis.com  
workflowexecutions.googleapis.com

Create a service account and give it a name:
```
 gcloud  
iam  
service-accounts  
create  
 MY_SERVICE_ACCOUNT 
 
```
Replace MY_SERVICE_ACCOUNT with a name for your service account.

Grant the roles/workflows.invoker and roles/logging.logWriter roles to the service account:

 gcloud  
projects  
add-iam-policy-binding  
 PROJECT_ID 
  
 \ 
  
--role = 
 "roles/workflows.invoker" 
  
 \ 
  
--role = 
 "roles/logging.logWriter" 
  
 \ 
  
--member = 
 "serviceAccount: MY_SERVICE_ACCOUNT 
@ SUBSCRIBER_PROJECT_ID 
.iam.gserviceaccount.com"

For more information about how to control access to Workflows resources, see Use IAM to control access .

Create and deploy a workflow that logs a received event:

Open a terminal or Cloud Shell .
In your home directory, create a new file called logEventsWorkflow.yaml .

Copy and paste the following into the new file and save it:

  main 
 : 
  
 params 
 : 
  
 [ 
 event 
 ] 
  
 steps 
 : 
  
 - 
  
 logStep 
 : 
  
 call 
 : 
  
 sys.log 
  
 args 
 : 
  
 data 
 : 
  
 ${event}

Deploy the workflow:

 gcloud  
workflows  
deploy  
logEventsWorkflow  
--source = 
logEventsWorkflow.yaml

Create a trigger for an event type. The following command creates a trigger for a specified event type supported by the provider, and for the logEventsWorkflow target workflow.

 gcloud  
eventarc  
triggers  
create  
 TRIGGER 
  
 \ 
  
--location = 
 LOCATION 
  
 \ 
  
--destination-workflow = 
logEventsWorkflow  
 \ 
  
--event-filters = 
 type 
 = 
 EVENT_TYPE 
  
 \ 
  
--channel = 
 CHANNEL_NAME 
  
 \ 
  
--project = 
 SUBSCRIBER_PROJECT_ID 
  
 \ 
  
--service-account = 
 " MY_SERVICE_ACCOUNT 
@ SUBSCRIBER_PROJECT_ID 
.iam.gserviceaccount.com"

Replace TRIGGER with the ID of the trigger or a fully qualified identifier. For example, my-event-trigger .

For more information, see Create a trigger for a third-party provider .

Provider tasks

In the provider project, do the following:

Create a channel connection. You can do this through your own code. You can also use the gcloud CLI.

 gcloud  
eventarc  
channel-connections  
create  
 CHANNEL_CONNECTION 
  
 \ 
  
--project  
 PUBLISHER_PROJECT_ID 
  
 \ 
  
--location  
 REGION 
  
 \ 
  
--channel  
 CHANNEL_NAME 
  
 \ 
  
--activation-token  
 ACTIVATION_TOKEN

For details, see Create a channel connection .

Once a channel connection exists, you can publish events using the Eventarc Publishing API. Publish an event that matches the trigger's filter. To test this, you can use cURL and the gcloud CLI. For example:

  curl 
  
 - 
 H 
  
 "Authorization: Bearer $(gcloud auth print-access-token)" 
  
 - 
 H 
  
 "Content-Type: application/json" 
  
 - 
 H 
  
 "X-Goog-User-Project: {publisher_project_id}" 
  
 - 
 X 
  
 POST 
  
 - 
 d 
  
 ' 
 { 
 "channelConnection" 
 : 
  
 "projects/{publisher_project_id}/locations/us-central1/channelConnections/test-connection-123" 
 , 
 "events" 
 : 
  
 [ 
  
 { 
  
 "@type" 
 : 
  
 "type.googleapis.com/io.cloudevents.v1.CloudEvent" 
 , 
  
 "id" 
 : 
  
 "12345" 
 , 
  
 "source" 
 : 
  
 "//companyname/example" 
 , 
  
 "specVersion" 
 : 
  
 "1.0" 
 , 
  
 "type" 
 : 
  
 "{event_type}" 
 , 
  
 "attributes" 
 : 
  
 { 
  
 "time" 
 : 
  
 { 
  
 "ceTimestamp" 
 : 
  
 "1970-01-01T00:00:01Z" 
  
 }, 
  
 "datacontenttype" 
 : 
  
 { 
  
 "ceString" 
 : 
  
 "application/json" 
  
 } 
  
 }, 
  
 "textData" 
 : 
  
 "{\"message\": \"test message 123\"}" 
  
 } 
 ] 
 } 
 ' 
  
 h 
 tt 
 ps 
 : 
 //eventarcpublishing.googleapis.com/v1/projects/{publisher_project_id}/locations/us-central1/channelConnections/test-connection-123:publishEvents

For details, see Publish events .

Verify results

As a subscriber, to test the configuration, verify that the event is delivered as expected to the trigger's destination. An execution of the workflow should have been triggered by the publishing of the event.

To verify that a workflow execution was triggered, list the last five executions:

   
gcloud  
workflows  
executions  
list  
 ${ 
 MY_WORKFLOW 
 } 
  
--limit = 
 5

The output should be similar to the following, listing a NAME and STATE equal to SUCCEEDED for each workflow execution.

 NAME: projects/606789101455/locations/us-central1/workflows/logEventsWorkflow/executions/8c02b8f1-8836-4a6d-99d9-fc321eb9668f
  STATE: SUCCEEDED
  START_TIME: 2021-09-13T19:15:10.275677049Z
  END_TIME: 2021-09-13T19:15:10.963136883Z
  NAME: projects/606789101455/locations/us-central1/workflows/logEventsWorkflow/executions/a6319d9d-36a6-4117-904e-3d1118bdc90a
  STATE: SUCCEEDED
  START_TIME: 2021-09-13T17:28:51.492864252Z
  END_TIME: 2021-09-13T17:28:52.227212414Z

Each workflow execution automatically triggers at least two execution logs: one at the start of an execution and one at the end. To view the logs do the following:

In the Google Cloud console, go to the Workflowspage:
Go to Workflows
To access a workflow's Detailspage, click the workflow's name.

To view the logs, click Logs. The output should be similar to the following:

  2022-06-10 
  
 13 
 : 
 49 
 : 
 50.019 
  
 BST 
  
 { 
 da 
 ta 
 : 
  
 { 
 … 
 }, 
  
 da 
 ta 
 co 
 ntentt 
 ype 
 : 
  
 applica 
 t 
 io 
 n 
 /jso 
 n 
 ,[ 
 ... 
 ] 
 { 
  
 "eventCategory" 
 : 
  
 "TestEvent" 
 , 
  
 "id" 
 : 
  
 "a91ca1a5-85e7-4dad-a329-cf7deba8e14d" 
 , 
  
 "severity" 
 : 
  
 "0" 
 , 
  
 "source" 
 : 
  
 "//provider/providerChannel/test" 
 , 
  
 "type" 
 : 
  
 "companyname.fooProcess.v1.resourceUpdated" 
 , 
  
 "link" 
 : 
  
 "https://www.example.com" 
 , 
  
 "eventName" 
 : 
  
 "Test Event" 
 , 
  
 "datacontenttype" 
 : 
  
 "application/json" 
 , 
  
 "resource" 
 : 
  
 "TestEvent" 
 , 
  
 "specversion" 
 : 
  
 "1.0" 
 , 
  
 "data" 
 : 
  
 { 
  
 "EVENT_ID" 
 : 
  
 "0" 
 , 
  
 "EVENT_TYPE" 
 : 
  
 "TestEvent" 
 , 
  
 "START_TIME" 
 : 
  
 "10 Jun 2022 12:49 GMT" 
 , 
  
 "LINK" 
 : 
  
 "https://www.example.com" 
 , 
  
 "EVENT_DETAILS" 
 : 
  
 { 
  
 "data" 
 : 
  
 null 
  
 }, 
  
 "SEVERITY" 
 : 
  
 0 
 , 
  
 "SUMMARY" 
 : 
  
 "This is a test Message." 
 , 
  
 "EVENT_CATEGORY" 
 : 
  
 "TestEvent" 
 , 
  
 "EVENT_NAME" 
 : 
  
 "Test Event" 
  
 } 
 }