Jira Cloud

Jira Cloud is built for every member of your software team to plan, track, and manage their work. Using the Atlassian platform, you can dynamically show information about issues, build new workflows and features, or integrate Jira with an existing service.

How to Integrate with Edgescan:

Clone a copy of EdgeRails and jira-cloud-plugin

For EdgeRails setup see Full Edgescan Application Setup

Launch EdgeRails on port 3000

JIRA-Cloud-Plugin Setup

Install project gems

1 bundle install


Installing gems requires access to our private gem server. If you’re doing this remotely you will need to use the following command:

http_proxy= bundle install


Copy the following into the config folder (remember to change the user and password if you chose non-default ones when you were setting up mysql):

adapter: mysql2
database: jiraplugin_development
username: db_user
password: Pa55word123!
pool: 5
timeout: 5000
host: <%= ENV.fetch('DB_HOST') { 'localhost' } %>

adapter: mysql2
database: jiraplugin
username: db_user
password: Pa55word123!
pool: 5
timeout: 5000

adapter: mysql2
database: jiraplugin_test<%= ENV['TEST_ENV_NUMBER'] %>
username: db_user
password: Pa55word123!
pool: 10
timeout: 5000


Setup the project database

bundle exec rake db:setup

NGROK Proxy Setup

ngrok is required to proxy your local jira-cloud-plugin to Atlassian when installing the application on the marketplace.

Follow ngrok installation instructions here

Then, launch it on the same port that your plugin will be running on

1ngrok http 3001


and copy the provided HTTPS URL

Local JIRA-Cloud-Plugin Changes

Go to app/views/install/descriptor.json and edit vendor → url

1 "vendor": {
2   "name": "Edgescan",
3   "url": "http//localhost:3000"
4 }

Create a .env file in the root directory and add the following variables

1BASE_URL = "https://example.ngrok.io"
2EDGESCAN_API_ROOT = "http://localhost:3000/api/v1"

Launch the project on the same port used above for ngrok

1rails s -p 3001

Plugin Installation on Atlassian

Go to Atlassian’s Manage Apps page and click on Upload App

Paste in the URL and upload


Having installed the app successfully, get an API token from your local EdgeRails app

1rails c
2User.find(28).create_token_for_function("auth", nil).value

On Atlassian, click on your newly installed app and click Configure , paste in your API token and save

Your local JIRA plugin is now installed and connected!