Reviewing Promotions to Event Brokers

You can use promotion requests in Event Portal to establish a promotion approval workflow for Solace event brokers in your organization. An approval process is especially valuable in environments where configuration is pushed to operational event brokers automatically on promotion. The promotion approval process is not available for Kafka event brokers.

When a user wants to promote application changes to a modeled event mesh, the promotion can use the approval process to create a step that requires another user to review the promotion before it occurs. The following actions can generate a promotion request:

  • promoting a new application version to an event broker
  • promoting an update to an application version that was already promoted to an event broker
  • removing an application from an event broker

Whether the approval process is optional or required depends on the role of the user. For more information, see Managing User Access to Event Portal.

Administrators and Event Portal Managers
Solace Cloud users with the Administrator or Event Portal Manager role can request approval to promote applications to an event broker or can promote applications without requesting approval from another user.
They can also review promotion requests from all other users.
Event Portal Users
Solace Cloud users with the Event Portal User role require additional access to both the application domain and the environment to promote applications.
Application Domain Access
Event Portal Users must have Application Domain Editor or Application Domain Manager access to an application domain to promote applications. They must also have sufficient access to the environment that they want to promote to.
Environment Access
Event Portal Users must have EP Runtime Editor or EP Runtime Approver access to an environment to promote applications to an event broker in the environment without requiring approval from another user.
Event Portal Users with EP Runtime Viewer access can request approval to promote an application to an event broker but can't promote an application without approval.
Event Portal Users with EP Runtime Approver access to an environment can also review promotion requests from all other users.

Managing Promotion Requests

Administrators, Event Portal Managers, and Event Portal Users with EP Runtime Approver access to an environment can manage application promotion requests. Users can't approve their own requests. Event Portal Users with EP Runtime Editor or EP Runtime Viewer access to an environment can view promotion requests for an environment but can't act on them.

By default, request approvers receive notifications in the Cloud Console and by email when someone makes a new request. The user who made the request receives a notification when the request has been approved or declined. For more information, see Notifications.

To review a promotion request, perform these steps:

  1. Log in to the Solace 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 In to the Solace Cloud Console.
  2. On the navigation bar, select Runtime Event Manager .
  3. Select the environment containing the modeled event mesh that you want to view promotion requests for.
  4. Select the Promotion Requests tab.
  5. Select Open Requests to display the list of requests that have not been completed.
  6. Select the name of the application that you want to review the promotion request for.

  7. In the information panel, click Open Request.

    You can also view Closed Requests but you can't act on them.

  8. Review the request details then click Review and perform one of these steps:
    1. To approve the request, select Approved.
    2. To send the request back without approval, select Declined and enter details to let the requestor know what they need to do.

  9. Click Send Review to notify the requestor of the result.

    If you approved the request, the request remains open until the application is promoted. Anyone with at least EP Runtime Editor access to the environment and Application Domain Editor access to the application domain can promote the application to the event broker from the request in Runtime Event Manager or from the application in Designer.

Notifications

By default, users requesting application promotion are notified in the Cloud Console and by email when the approval status of a request changes.

Users who can review promotion requests are notified in the Cloud Console and by email by default when a new request is created and needs to be reviewed.

For information about managing your notification settings, see System Notifications.

To open a notification for a promotion request in the Cloud Console, perform these steps:

  1. Log in to the Solace 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 In to the Solace Cloud Console.

  2. On the navigation bar, click Notifications.
  3. Click a notification to see its details.
  4. In the notification details, click the link to review or open the request.

Each notification remains in the notification list until you mark it as read or delete it. Click See All in the notification list to open the Notifications page where you can mark individual notifications as read or delete them.