Creating an Event Mesh
Before you can create an event mesh, you require the following prerequisites:
- You require the Mesh Manager Editor role assigned to your user account. For more information about the role requirements, see Considerations for Working with Event Meshes in PubSub+ Cloud. You require the Mesh Manager Editor role assigned to your user profile. Contact your PubSub+ Cloud administrator if you require this role.
- The Enterprise event broker services have been created that you are using to create an event mesh. If you are connecting a DMR cluster that have multiple nodes in it, you must identify the event broker service that will be the gateway node.
To create an event mesh, you can start by creating multiple enterprise event broker services in Cluster Manager. After you create your event broker services, you use Mesh Manager to specify the nodes that are in your event mesh. To create an event mesh, you require an minimum of two event broker services.
If you are creating an event mesh with DMR clusters that have more than one node (event broker service), you must identify one event broker service from each DMR cluster to use. For more information abut event meshes, see Understanding Event Meshes and Mesh Manager.
Before you create an event mesh, we recommend that you review the considerations when you work with event meshes. For this information, see Considerations for Working with Event Meshes in PubSub+ Cloud.
To illustrate how to create an event mesh, we'll show you how to create the illustrated event mesh with these characteristics:
- Three Enterprise event broker services connected in a full-mesh (where every event broker service is connected to others in the event mesh), called My_First_Service, My_Second_Service, and My_Third_Service. For illustrative purposes, the event broker service run in separate data centers and with different cloud providers.
- Each event broker service is the only node in the DMR cluster and hence is the event broker service (gateway node) we use for the event mesh.
Log in to the PubSub+ Cloud Console if you have not done so yet.
- Select Mesh Manager from the navigation bar.
- In Mesh Manager, click Create Mesh.
- On the Create Mesh page, enter a name for your event mesh in the Mesh Name field.
Click Add Service and on the Add Service: Full Mesh dialog, select the service to add to the event mesh using one of the following methods:
- Click and then enter the first few letters of the name of your service that you want to add to the event mesh in the Select services to add to a full mesh topology field to filter the list, when you see your event broker service appear, select it, and then click Add Service.
Click the Select services to add to a full mesh topology field and then scroll and select the name of your service in the drop-down menu, and click Add Service. Note that the list can be long and for that reason, we recommend using the previous method to find the name of your event broker service.
After you return to the Create Mesh page, click Add Service and on the Add Service: Full Mesh dialog, select another event broker service. At this point, you'll see the list of links that will be created and optionally, and you can click the Switch Initiator link to set which event broker service initiates the creation of the link before you click Add Service. In most cases, you can accept the suggested initiating links, but if the one of the event broker services is in a Virtual Private Cloud or Virtual Network (VPC/VNet) and the other service is not, you must change the initiating service must be the one in the VPC/VNet. For more information about what choosing the initiating service, see Switch the Initiator for a Link on the Event Mesh.
Repeat this step until you've added all the event broker services that you want to your event mesh.
After you return to the Create Mesh page, you'll see the links under Services in Mesh.
As you add services, you'll see the map on the right visualize the connections in your event mesh. When you're ready, click Create Mesh.
You'll see a Create started notification appear near the bottom of the page. As part of the event mesh creation process, a Heath Check is run to validate that the event mesh is healthy.
The time to create an event mesh can take up to five minutes. You can wait on the page or check its progress. For more information, see Checking the Progress of an Event Mesh.
After the event mesh creation process completes, you'll see a Create is complete notification message and you can see that the event mesh is up.
As part of first creating an event mesh, a Health Check is run that validates the links between each event broker service in the event mesh. You can also choose to run it manually. For more information about running a Health Check, see Creating an Event Mesh.