This is a Slack and Mattermost integration for notifying JIRA events. It is written in Go and runnable on App Engine.
Setup Slack or Mattermost
Setup JIRA Webhook
Create a Webhook on your JIRA cloud or server.
Set the URL of Webhook as follows:
You can add the following query parameters:
||Slack Webhook URL||Mandatory||
||BOT Icon emoji or URL||-||
||Dump JIRA and Slack messages to console||
You can deploy jira-to-slack on your server as well. See the later section for details.
Download the latest release and run the server:
You can run the server on Docker:
docker run --rm -p 3000:3000 int128/jira-to-slack
You can deploy on App Engine:
# Install SDK brew cask install google-cloud-sdk gcloud components install app-engine-go # Run dev_appserver.py appengine/app.yaml # Deploy gcloud app deploy --project=jira-to-slack appengine/app.yaml
You can install the Kubernetes Helm Chart:
git clone https://github.com/int128/devops-kompose && cd devops-kompose export DEVOPS_DOMAIN=dev.example.com helmfile -l name=jira-to-slack sync
How it works
jira-to-slack sends a message to the Slack channel on the following triggers:
- Someone created an issue.
- Someone commented to an issue.
- Someone assigned an issue.
- Someone updated summary or description of an issue.
- Someone deleted an issue.
jira-to-slack sends mentions to reporter and assignee of the issue.
If the issue or comment has mentions (Slack style
@foo or JIRA style
jira-to-slack sends the mentions as well.
JIRA Mattermost Webhook Bridge. Great work. This is almost perfect but notifies many events so it may be noisy.
Mattermost official JIRA Webhook Plugin. This is still beta and in progress. Currently this does not notify comment.
This is an open source software licensed under Apache License 2.0. Feel free to open your issues or pull requests.
Start the server:
go run main.go
dev_appserver.py --port 3000 appengine/app.yaml
You can send actual payloads of actual JIRA events by the following script:
# Slack SLACK_WEBHOOK="https://hooks.slack.com/xxx&username=JIRA&icon=https://lh3.googleusercontent.com/GkgChJMixx9JAmoUi1majtfpjg1Ra86gZR0GCehJfVcOGQI7Ict_TVafXCtJniVn3R0" ./testdata/post_jira_events.sh # Mattermost SLACK_WEBHOOK="https://mattermost.example.com/hooks/xxx&username=JIRA&icon=https://lh3.googleusercontent.com/GkgChJMixx9JAmoUi1majtfpjg1Ra86gZR0GCehJfVcOGQI7Ict_TVafXCtJniVn3R0&dialect=mattermost" ./testdata/post_jira_events.sh