2.4 KiB
If you are running JIRA version 5.2 or greater, or using the hosted JIRA provided by Atlassian, we recommend using the web-hook method above instead. This plugin supports older versions of JIRA.
First, create the stream you'd like to use for JIRA notifications, and
subscribe all interested parties to this stream. We recommend the name
jira
.
Plugin mechanism
{! download-python-bindings.md !}
Plugin Installation
The JIRA integration plugin requires two JIRA plugins. Please install the following plugins using the Universal Plugin Manager in your JIRA installation:
SSL Setup
As Zulip is using a StartCOM SSL certificate that is not recognized by default in the Java installation shipped with JIRA, you will need to tell JIRA about the certificate.
-
Navigate to
Administration > System > Configure SSL
and in theImport SSL Certificates
field, enter{{ external_api_uri_subdomain }}
. -
After clicking
Save Certificates
, follow the on-screen instructions and restart JIRA for it to recognize the proper certificates.
Zulip Integration
-
Copy the folder
integrations/jira/org/
(from the tarball you downloaded above) to your JIRAclasses
folder. For self-contained JIRA installations, this will beatlassian-jira/WEB-INF/classes/
, but this may be different in your deployment. -
Edit the constants at the top of
org/zulip/jira/ZulipListener.groovy
and fill them with the appropriate values:
String zulipEmail = "jira-notifications-bot@example.com"
String zulipAPIKey = "0123456789abcdef0123456789abcdef"
String zulipStream = "JIRA"
String issueBaseUrl = "https://jira.COMPANY.com/browse/"
-
In the Administrators page, navigate to
Plugins > Other > Script Listeners
. -
In the
Add Listener
section, click on theCustom Listener
option. Select the events you wish the Zulip integration to fire for, and the projects you wish Zulip to be notified for. -
In the
Name of groovy class
field, enterorg.zulip.jira.ZulipListener
. -
Click
Add Listener
, and JIRA will now notify your Zulip of changes to your issues! Updates from JIRA will be sent to the stream you've configured.
{! congrats.md !}