Skip to main content

GitLab merge request management

Learn how to get started with merge request management solution for GitLab


Install GitLab merge request management from app directory and start using it by connecting your GitLab and Slack accounts.

Get started as a user

If you are invited to this app as a user, proceed to Get started as a user section to learn how to connect your GitLab account.

Features

Review GitLab merge requests in temporary Slack channels, collaborate and communicate better with your team.

Use cases

How to get started

Step 1. Install GitLab merge request management

Visit GitLab merge request management in app directory and click Install button at top right corner.

Install GitLab merge request management

Step 2. Connect to GitLab and Slack

After installing the app, you'll be prompted to connect your Slack workspace and GitLab account.

Connections for GitLab merge request management

Complete GitLab connection

  1. Click Connect near GitLab connection and proceed to authentication in GitLab via OAuth2.
  2. You will be asked to sign in to your GitLab account if you haven't already.
  3. Click Authorize Actioner. You’ll be redirected to Actioner upon successful authorization.

Complete Slack connection

If you have not connected your Slack workspace, you can click Connect near Slack connection.

Slack connection

You can also add your Slack workspace by navigating to Workspace settings page from left menu and then switching to Slack workspace tab.

If you do not see Workspace settings page, contact with your workspace admin.

Step 3. Complete setup

Setup GitLab merge request management

  1. Run Subscribe to GitLab events. This workflow creates a webhook on GitLab to subscribe to the merge request events from a selected project.

    If you want to subscribe events from multiple projects, you can re-run this workflow.

  2. Run Set merge request update channel. This workflow creates a merge request channel on Slack with a given prefix. (#-gitlab-updates) Anyone who joins this channel will receive an onboarding message from Actioner to explain how to connect GitLab.

    Also, when a commit is pushed to the main branch, a message will be sent to this channel to notify your team.

Step 4. Invite your team

Go to the Permissions tab of your app and add users or groups via + Add permission button. If you can't find the users you want to add, ensure they have been invited to your Actioner workspace.

Permissions for GitLab merge request management

Inviting everyone

To enable all users in your Actioner worksapce to run the workflows in your app, add Everyone as Runner.

Get started as a user

If you are invited to this app as a user, you need to complete GitLab connection. This connection is required for you to take actions on GitLab notifications in Slack.

  1. Navigate to GitLab connection, click Connect and proceed to authentication in GitLab via OAuth2.
  2. You will be asked to sign in to your GitLab account if you haven't already.
  3. Click Connect app. You’ll be redirected to Actioner upon successful authorization.

How to customize this app

Merge request or merge request reviews with a different tool

If you are using GitHub or Bitbucket, you can install Actioner apps that work in Slack with your version control tool.

Update emoji to send Slack messages as comments to GitLab MR requests

To use another emoji to add comments to the GitLab merge request,

  1. Go to Workflows tab of your app and find the workflow named Add comment to merge request with pin emoji.
  2. Navigate to the trigger event and update the emoji on Trigger conditions.

Add a new repo to this app

If your team is working on multiple repos, you can add all of them by running Subscribe to GitLab events.

  1. In Slack, call Actioner from shortcuts, or simply type /actioner and navigate to Subscribe to GitLab events workflow.
  2. Select the repo that you want to add.
Note

You do not need add the repositories that this app previously subscribed to their events.