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​

Get started as an app admin​

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

  1. Click Connect near Slack connection.
  2. Continue with selecting your Slack workspace.
Slack connection

If your workspace is not available, add it by navigating to Slack connections page from left menu and click + Add new Slack workspace.

If you do not see Slack connections 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.

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.