Before you can create an event mesh or edit and existing one, you must fulfill the following prerequisites:
- You require the Cluster Manager Editor role assigned to your user profile. Contact the administrator for your account if you require this role.
For more information about the role requirements, see Considerations for Working with Event Meshes in PubSub+ Cloud.
- The Enterprise event broker services that you want to include in the event mesh already exist. To create an event mesh, you require a minimum of two event broker services. After you create your event broker services, you use Mesh Manager to specify the nodes that are in your event mesh.
If you are connecting a DMR cluster that has multiple nodes in it, you must identify one event broker service to be the gateway node.
Creating and using an event mesh during its beta requires that your event broker services have specific Access Control List (ACL) Profile properties configured to ‘allow’. See Configuring ACL Profile Properties When Using the Event Mesh.
For more information abut event meshes and before you create an event mesh, see Understanding Event Meshes and Mesh Manager and Considerations for Working with Event Meshes in PubSub+ Cloud.
The following example illustrates how to create an 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. The URL to access the Cloud Console differs based on your authentication scheme. For more information, see Logging into the PubSub+ Cloud Console.
- 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.
On the Add Service: Full Mesh dialog, in the Select services to add to a full mesh topology field, select the event broker service to add to the event mesh using one of the following methods:
- Enter the first few letters of the name of your event broker service to filter the list. When you see the correct one in the list, select it, and then click Add Service.
- Scroll and select the name of your service in the drop-down menu, then 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 again and on the Add Service: Full Mesh dialog, select another event broker service. In most cases, you can accept the suggested initiating links.
You can optionally click the Switch Initiator icon to change which event broker service begins the creation of the DMR link. For more information about choosing the initiating service, see Switch the Initiator for a Link on the Event Mesh. There are the reasons you may want to change the initiator:
If the one of the event broker services has a private endpoint and the other service is a public endpoint, you must change the initiating service to be the one with the private endpoint. On the remote endpoint, you can only select the endpoint if you have more than one endpoint available, otherwise, only the single endpoint is shown and automatically selected for you.
For example, below My-First-Service only has a Public Endpoint so it is automatically selected:
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, the map on the right updates to show all the connections in your event mesh. When you're ready, click Create Mesh.
Creating an event mesh can take up to five minutes and starts after the Create started notification appears near the bottom of the page. You can wait on the same page or come back later to check the event mesh creation progress. For more information, see Checking the Progress of an Event Mesh.
A Creation is complete notification message appears after the event mesh creation process completes and you can see that the event mesh is up.
As part of creating an event mesh, a Health Check is run that validates connectivity for each of event broker service in the event mesh. You can also choose to run Health Check manually. For more information details, see Running Health Checks.