jira-matter-bridge's Introduction

JIRA Mattermost Webhook Bridge

Serves as a bridge that translates the JIRA webhooks into Mattermost webhooks.

Configuration

Set the following environment variables to provide the Mattermost server details:

MATTERMOST_SERVER_PORT - Default: 80
MATTERMOST_SERVER_PATH - Default: /hooks/
MATTERMOST_SERVER_PROTO - Default: http
MATTERMOST_SERVER - Default: localhost

Integration

Install the required modules by running npm install
Start the app by running npm start
Configure Mattermost server and create a new incoming webhooks and note the hook-id (the part that appears after hooks in the hook URL.
Configure JIRA Webhooks to forward the hook (for the required JQL) to http://<jira-matter-bridge-server>:3000/hooks/<mattermost hook id>
That's it.

Hosted Version

The app is hosted on a free dyno at https://jira-matter-bridge.herokuapp.com/
If the Mattermost server and JIRA server are on public domain, you can directly use this hosted version.
In the JIRA Server, configure the webhook URL as given in this example
https://jira-matter-bridge.herokuapp.com/hooks/<hookid from your mattermost server>?matterurl=<your mattermost server base url>
E.g.:
https://jira-matter-bridge.herokuapp.com/hooks/ckshz5joqigkfmj6po7fm4r8wh?matterurl=https://someserver.com
https://jira-matter-bridge.herokuapp.com/hooks/ckshz5joqigkfmj6po7fm4r8wh?matterurl=http://someserver.com:3000
https://jira-matter-bridge.herokuapp.com/hooks/ckshz5joqigkfmj6po7fm4r8wh?matterurl=https://someserver.com:8443

⚠️ Since this is hosted on a free dyno, there is no guarantee that the messages will be delivered and it is recommended that you use a paid dyno at Heroku using this repository as source.

Recommend Projects