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​

By default Everyone in your Actioner workspace is added to your app as Runner.

To grant app admin permission to a user, 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

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.

How to customize this app​

Updating channel for commit to main notifications​

During the setup, a new channel is created with your give prefix.you’ll be prompted to complete some steps. These steps are necessary for your app to get up and running in Slack. After the setup, you can also update your notification settings.