mattermost-integration-gitlab | GitLab Integration Service for Mattermost | SMS library

To install this project using Heroku, you will need:.
A Heroku account, available for free at Heroku.com
A GitHub account, available for free at GitHub.com
Create a copy of this project to manipulate
Log in to your GitHub account. Go to the Github repository of this project and click Fork in the top-right corner to create a copy of this project that you control and manipulate.
Deploy your project copy to Heroku
Go to your Heroku Dashboard and click + in the top-right corner then Create New App. Give your app a unqiue name (like mattermost-gitlab-[YOUR_GITHUB_USERNAME]), select your region and click Create App.
Heroku directs you to the Deploy tab of the dashboard for your new app, select GitHub as your connection option, then click Connect to GitHub at the bottom of the screen to authorize Herkou to access your GitHub account.
In the pop up window, click Authorize Application to allow Heroku to access your accounts repositories. On your Heroku dashboard, select your account in the first drop-down then search for the repo we created earlier by forking this project. Type mattermost-integration-gitlab in the repo-name field, then click Search and then the Connect button once Heroku finds your repository.
Scroll to the bottom of the new page. Under the Manual Deploy section, make sure the master branch is selected then click Deploy Branch. After a few seconds you'll see a confirmation that the app has been deployed.
At the top of your app dashboard, go to the Settings tab and scroll down to the Domains section. Copy the URL below Heroku Domain (we'll refer to this as http://<your-heroku-domain>/ and we'll need it in the next step)
Leave your Heroku interface open as we'll come back to it to finish the setup.
Connect your project to your GitLab account for outgoing webhooks
Log in to GitLab account and open the project from which you want to receive updates and to which you have administrator access. From the left side of the project screen, click on Settings > Web Hooks. In the URL field enter http://<your-heroku-domain>/ from the previous step, plus the word new_event to create an entry that reads http://<your-heroku-domain>/new_event so events from your GitLab project are sent to your Heroku server. Make sure your URL has a leading http:// or https://.
On the same page, under Trigger select Push events, Comment events, Issue events, Merge Request events
(Recommended but optional): Encrypt your connection from GitLab to your project by selecting Enable SSL verification. If this option is not available and you're not familiar with how to set it up, contact your GitLab System Administrator for help.
Click Add Web Hook and check that your new webhook entry is added to the Web hooks section below the button.
Leave this page open as we'll come back to it to test that everything is working.
Set up your Mattermost instance to receive incoming webhooks
Log in to your Mattermost account. Click the three dot menu at the top of the left-hand side and go to Account Settings > Integrations > Incoming Webhooks.
Under Add a new incoming webhook select the channel in which you want GitLab notifications to appear, then click Add to create a new entry.
Copy the contents next to URL of the new webhook you just created (we'll refer to this as https://<your-mattermost-webhook-URL> and add it to your Heroku server).
Go back to your Heroku app dashboard under the Settings tab. Under the Config Variables section, click Reveal Config Vars Type MATTERMOST_WEBHOOK_URL in the KEY field and paste https://<your-mattermost-webhook-URL> into the VALUE field, then click Add. In the second KEY field, type PUSH_TRIGGER and in the corresponding VALUE field, type True.
Test your webhook integration
If your GitLab project is in active development, return to the Settings > Web Hooks page of your GitLab project and click Test Hook to send a test message about one of your recent updates from your GitLab project to Mattermost. You should see a notification on the Gitlab page that the hook was successfully executed. In Mattermost, go to the channel which you specified when creating the URL for your incoming webhook and make sure that the message delivered successfully.
If your GitLab project is new, try creating a test issue and then verify that the issue is posted to Mattermost.
Back on the settings tab of your Heroku app dashboard, under the Config Variables, click Reveal Config Vars and then click the X next to the PUSH_TRIGGER field you added. This config variable was used for testing only, and is better left turned off for production
If you have any issues, please go to http://forum.mattermost.org and let us know which steps in these instructions were unclear or didn't work.