Keptn Bridge

Explains how the access the Keptn Bridge.

The Keptn Bridge is the user interface of Keptn and presents all projects and services managed by Keptn. It is automatically installed with your Keptn deployment.

Expose/Lockdown Bridge

The Keptn Bridge is not publicly accessible by default.

• To expose the Keptn Bridge, execute the following command. It is then available on: https://bridge.keptn.YOUR.DOMAIN/

keptn configure bridge --action=expose --user=<USERNAME> --password=<PASSWORD>

Note: The user and password you specify here will be used for the basic authentication that will be generated by Keptn when this command is received. If you would like to change those credentials afterwards, simply execute the keptn configure bridge command again with your desired credentials.

• To lockdown the Keptn Bridge:

keptn configure bridge --action=lockdown

Views in Keptn Bridge

Project view

The Keptn Bridge provides an easy way to browse all events that are sent within Keptn. When you access the Keptn Bridge, all projects will be shown on the start screen. When clicking on a project, the stages of this project and all onboarded services are shown on the next view.

When selecting one service, all events that belong to this service are listed on the right side. Please note that this list only represents the start of a deployment (or problem) of a new artifact. More information on the executed steps can be revealed when you click on one event.

Event Stream

When selecting an event, the Keptn Bridge displays all other events that are in the same Keptn context and belong to the selected entry point. As can be seen in the screenshot below, the entry point around 4:03 pm has been selected and all events belonging to this entry point are displayed on the right side.

Deep links into Keptn Bridge

For integration of the Keptn Bridge into DevOps tools, a list of following deep links is provided:

• project/:projectName
  • Opens project view of the project specified by projectName.
• project/:projectName/:serviceName
  • Opens project view of the project specified by projectName and expands the service specified by serviceName.
• project/:projectName/:serviceName/:contextId
  • Opens project view of projectName, expands the service specified by serviceName, and selects root event of keptn context specified by contextId.
• project/:projectName/:serviceName/:contextId/:eventId:
  • Opens project view of projectName, expands the service specified by serviceName, and selects root event of keptn context specified by contextId.
  • Finally, Keptn Bridge scrolls to event with the eventId.
• trace/:shkeptncontext
  • Loads that root event and redirects to project/:projectName/:serviceName/:contextId
• trace/:shkeptncontext/:stage
  • Loads that root event and redirects to project/:projectName/:serviceName/:contextId/:eventId where eventId is the id of the first event of the specific stage.
• trace/:shkeptncontext/:eventtype
  • Loads that root event and redirects to project/:projectName/:serviceName/:contextId/:eventId where eventId is the id of the last event with the specific event type.

Early Access Version of Keptn Bridge

Right now there is no early access version of Keptn Bridge available. You can upgrade to the latest version (0.6.2) by executing the following commands:

kubectl -n keptn set image deployment/bridge bridge=keptn/bridge2:0.6.2 --record
kubectl -n keptn set image deployment/configuration-service bridge=keptn/configuration-service:0.6.2 --record
kubectl -n keptn-datastore set image deployment/mongodb-datastore mongodb-datastore=keptn/mongodb-datastore:0.6.2 --record

If you have any questions or feedback regarding Keptn Bridge, please contact us through our Keptn Community Channels!