GitLab
Integrating Currents dashboard with GitLab
Currents Dashboard integration with GitLab allows posting commit build statuses as well merge request comments with a summary of your cypress tests.

Example of GitLab commit status

Cypress GitLab Integration - commit build status example

Example of GitLab Merge Request note

Cypress GitLab Integration - Merge Request comment example

Enabling GitLab Integration

In order to install GitLab integration in Currents Dashboard, visit Project Settings -> Integrations and click Connect GitLab repositories.
Installing GitLab integration for Cypress
GitLab Enterprise and self-hosted GitLab users: you'd override the default GitLab Instance Domain with the base URL of your GitLab setup. For example https://gitlab.yourcompany.com
Follow the on-screen instructions to create a new GitLab OAuth App with the following properties:
  • https://hub.currents.dev/gitlab/callback as Redirect URI
  • api scope in the application permissions
Please note: api scope is required for the integration to work correctly. At the time of implementation, GitLab didn't allow setting more granular permissions.
Here's the list of API calls that Currents use:
  • Getting the list of repositories accessible to OAuth token issuer
  • Posting commit build status updates
  • Posting and deleting Merge Request notes
Enter the details (App ID and App Secret) of the newly created GitLab OAuth App and click Connect.
After a successful connection, you will see a dropdown list of accessible GitLab projects (repositories). Select the repository you'd like to integrate with the Currents project and click Save.
Installing GitLab Integration with Cypress
Currents Dashboard will start posting commit build statuses and merge request comments with a summary of your cypress tests for Merge Requests in the selected project.

Customizing GitLab Integration

Toggling GitLab Integration settings change the type of content that is being posted to GitLab
Customizing GitLab Integration
  • Merge Requests Comment - will toggle on / off posting run results summary to a merge request
  • Commit Status - will toggle on / off updating commit status with run results

Disabling GitLab Integration

Clicking Disconnect Project (1) will detach the integration from the currently selected GitLab project. Disconnecting a project would keep GitLab OAuth App credentials. You would still be able to select a different GitLab project from the list to reactivate the integration.
Uninstalling (2) the integration removes the associated credentials and the integration altogether.
Disabling GitLab Integration
Copy link
On this page
Enabling GitLab Integration
Customizing GitLab Integration
Disabling GitLab Integration