Introduction to Atlassian Connect

Mirketa_Introduction_to_Attlasian connect

What is Atlassian Connect Framework?

Atlassian Connect framework is used to develop add-ons for Atlassian applications like Jira and Confluence.

Atlassian Connect add-ons are web applications. They operate remotely over HTTP and can be written in any programming language.

How Atlassian Connect Framework works?

To an end user, your add-on should appear as a fully integrated part of the Atlassian application. Once your add-on is registered with the application, features are delivered from the UI and workflows of the host application. This deep level of integration is part of what makes Atlassian Connect add-ons so powerful. (This content and diagram has been taken from the Atlassian Connect Documentation Guide: – https://developer.atlassian.com/static/connect/docs/latest/guides/introduction.html )

Mirketa_Atlassian_Connect_Framework_works_1

Here, I am going to introduce you to the Atlaasian Connect add-ons development.

How to create your first add-on for Jira On Demand?

For developing your first add-on you need to install the Node.js, SDK and ACE (Atlassian Connect Express) toolkit.

For developing your first add-on you need to create your developing environment which is also called your local environment, where you will perform your add-on development.
–  There could be three environments for your Add-on:-

1- Local Environment

2- Test Environment

3- Production Environment

–  Configuring Development Environment

Local (Development) Environment Setup

1- For Jira On Demand we first need SDK in our machine. After setting up the SDK check atlas-version for your
confirmation by typing atlassian-version command on CMD.

2- Now download and install Node.js by clicking on the link https://nodejs.org/en/

3- Open CMD & Install ACE by using this command npm install -g atlas-connect

4- Create your ACE project by using the given command

Atlas-connect new project name
5. Change directory by typing cd project name

6- Install all dependencies for your project by typing npm install command on cmd in your project directory.

Note: – You can add or install node modules by using npm install node module name command.

7- Change your port to 8000 for your npm server in config.json.

8- As well as you can do all configuration in your config.json. For example: – you can change your port, and other
required URL according to your requirement.

9- Start your Jira On Demand instance by using the given command

atlas-run-standalone –product Jira –version 7.0.0-OD-04-018 –bundled-plugins com.atlassian.bundles:json-schema-validator-atlassian-bundle:1.0.4,com.atlassian.webhooks:atlassian-webhooks-plugin:2.0.0,com.atlassian.jwt:jwt-plugin:1.2.2,com.atlassian.upm:atlassian-universal-plugin-manager-plugin:2.19.4-D20150819T002936,com.atlassian.plugins:atlassian-connect-plugin:1.1.48 –jvmargs -Datlassian.upm.on.demand=true

After which you can access your Jira in cloud mode by going to this URL:-

http://localhost:2990/jira

Now you can login in to Jira Cloud by using these credentials.

Username:admin
Password:admin

10- Start your local server by using the command node app.js

11- You can confirm your files by visiting this kind of a URL :http://localhost:8000/atlassian-connect.jso

12- For uploading(manually) the add-on on your local environment use the following process:
Go to Add-ons (right hand side of your Jira and click on * icon) and select Manage add-ons.
Now click on upload add-on and type the given URL for uploading your add-on on your local environment if you
want to upload it(add-on) manually, otherwise it will automatically upload in your local environment.
Example of Add-on URL for Uploading in your local environment
http://localhost:8000/atlassian-connect.json

– Add-on Description

Your Add-on directory structure will be like this:

Mirketa_Attlasian_plugin

Note: – If you are familiar with atlassian-plugin.xml, you will understand the concept of atlassian-connect.json.

Atlassian-connect.json:-The add-on descriptor is a JSON file (atlassian-connect.json) that describes the add-on to the Atlassian application. The descriptor includes general information about the add-on, as well as the modules that the add-on wants to use or extend.

Note: – For more details about Atlassian Connect framework you can visit here:

https://developer.atlassian.com/static/connect/docs/latest/guides/introduction.html

Install your plugin on your cloud instance (Testing environment)

Three steps for Add On upload

1- Cloud instance (Testing Environment)
First we need a testing environment where we upload our plugin from marketplace from the given link
https://www.atlassian.com/ondemand/signup
/form?product=jira.ondemand,greenhopper.jira.ondemand,confluence.ondemand

You can create your testing environment.
For example you can create your own testing environment for Jira On Demand cloud instance.

https://example.atlassian.net/secure/Dashboard.jspa

Username: – anil@example.com

Password: – 123@example

 2.Https Server for add-on

After which you have to create an https server for your atlassian-connect.json (for ssl certificate)
So your JSON URL should be:-

https://a baseurl/atlassian-connect.json

Same as local server

http://localhost:8000/atlassian-connect.json

3. Marketplace account
For uploading your add-on on your testing environment you have to register/upload your add-on at
Marketplace, so first create your marketplace account by visiting the given url:-

https://marketplace.atlassian.com

Username

Password

You can create your own marketplace account by using the given URL.

You can set your marketplace account setting and other settings for your add-on by visiting the given link:-

https://developer.atlassian.com/static/connect/docs/latest/developing/cloud-installation.html

Example of your Add On marketplace URL:-

Your Add -on URL should be like this:-

https://marketplace.atlassian.com/download/plugins/com.example.add-on/version/39/descriptor?access-token=9ad5037b)

After uploading your Add-on in marketplace, now you can upload your Add-on in your Testing or Production environment by putting the marketplace URL of your Add-On (shown above)

Note: – By using the given link you can install your Add-on on your cloud environment.

https://developer.atlassian.com/static/connect/docs/latest/developing/cloud-installation.html

How to upload your Add-on on your cloud environment

GO to Add-on and select Manage Add-ons.

Now click on Settings and select Enable Private Listings.

Now you will get the upload add-on option so now you can upload your Add On by putting marketplace URL of your Add-on.

Note: – After finishing your add-on testing now you will be able to upload your add-on at your production environment.

Thanks,

Anil Singh

Posted in Agile, CSS, HTML/CSS, J2EE, JAVA, JIRA, JIRA on Demand, Mirketa Atlassian Connect, Mirketa Atlassian Framework, MirketaInc, UI, UX. Tagged with , , .

Leave a Reply

Your email address will not be published. Required fields are marked *


2 + eight =

CommentLuv badge
Skip to toolbar