Upgrade to Pro — share decks privately, control downloads, hide ads and more …

NodeConf.eu Atlassian Connect Workshop

Ralph Whitbeck
September 07, 2015

NodeConf.eu Atlassian Connect Workshop

Equip Successful Teams with a NodeJS Microservice

Ralph Whitbeck

September 07, 2015
Tweet

More Decks by Ralph Whitbeck

Other Decks in Technology

Transcript

  1. Unleash the power of teams … through the power of

    software ATLASSIAN MISSION STATEMENT “ ”
  2. Extending Atlassian Products Atlassian SDK Open Technology Stack Ease of

    upgradability Only needed for JIRA and Confluence
  3. Atlassian Connect descriptor { "key": "weather-tutorial-addon", "name": "Weather", "description": "A

    simple add-on to get the weather.", "vendor": { "name": "Ralph Whitbeck", "url": "https://www.hipchat.com" }, "links": { "self": "{{localBaseUrl}}/atlassian-connect.json", "homepage": "{{localBaseUrl}}/atlassian-connect.json" }, "capabilities": { "hipchatApiConsumer": { "scopes": [ "send_notification" ] }, "installable": { "callbackUrl": "{{localBaseUrl}}/installable" }, "webhook": { "url": "{{localBaseUrl}}/webhook", "pattern": "^/weather", "event": "room_message", "name": "Get Weather" } } } { "name": "Hello World", "description": "Atlassian Connect add-on", "key": "com.example.myaddon", "baseUrl": "Your baseURL here", "vendor": { "name": "Example, Inc.", "url": "http://example.com" }, "authentication": { "type": "none" }, "version": "1.0", "modules": { "generalPages": [ { "url": "/helloworld.html", "key": "hello-world", "name": { "value": "Greeting" } } ] } }
  4. Extensibility via web fragments "modules": { "webPanels": [ { "location":

    ”alt.jira.view.issue.right.context”, "url": “/show-stats.html", "key": “show-stats", "name": { "value": "Statistics" } } ] }
  5. • Node (You have this already, don’t you?!) • HipChat

    Account (http://hipchat.com) • nGrok (http://ngrok.com) • Sign up for an API key at Weather Underground (http://www.wunderground.com/ weather/api/) • Download source code incase you fall behind or don’t want to code along • https://bitbucket.org/rwhitbeck/hipchat-weather-addon Make sure you have the following
  6. Sending a request with cURL curl \ -H "Content-Type: application/json"

    \ -X POST -d '{"message": "This is a test from cURL."}' \ https://api.hipchat.com/v2/room/1071697/notification?auth_token={Room Token}
  7. • Download the SDK at http://developer.atlassian.com • Find the commands

    for spinning up the cloud versions • http://connect.atlassian.com -> Local Development • Downloads the application • Takes about 15 minutes the first time. Atlassian SDK
  8. Use ngrok Connect Command Atlassian SDK Developing for JIRA Cloud

    Remember to use the long command found at connect.atlassian.com to start JIRA as it is in the cloud with Atlassian Connect Use the SDK to spin up a local version of JIRA Use ngrok to expose your add-on externally and allow JIRA to install it.
  9. Add-on descriptor "generalPages": [ { "url": "/helloyou.html", "key": "hello-you", "location":

    "system.top.navigation.bar", "name": { "value": "Click me" } } ] • Products can be extended using Web fragments (web item, web section, web panel) in various parts of the UI • You specify the fragment location, a target URL, and options, through the add-on descriptor To find the list of available locations, install the Web Fragments Finder add-on from Wittified: https://marketplace.atlassian.com/plugins/com.wittified.webfragment-finder W E B F R A G M E N T S - E X T E N D I N G T H E U I
  10. Use ngrok Connect Command Atlassian SDK Developing for Confluence Cloud

    Remember to use the long command found at connect.atlassian.com to start Confluence as it is in the cloud with Atlassian Connect Use the SDK to spin up a local version of Confluence Use ngrok to expose your add-on externally and allow Confluence to install it.
  11. Use ngrok Works in Server No SDK Developing for HipChat

    Cloud Unlike JIRA and Confluence Atlassian Connect works the same in HipChat Server. You can install directly into any room you have admin rights too. Don’t have admin rights to the group. Just create a room. Use ngrok to expose your add-on externally and allow HipChat to install it.
  12. Use ngrok No Server No SDK Developing for Bitbucket Cloud

    Currently not supported in the server version, Stash. You can install directly into Bitbucket. Just need a user account Use ngrok to expose your add-on externally and allow HipChat to install it.
  13. API Reference Links to API references for all products can

    be found right on the home page http://developer.atlassian.com
  14. Awesome Judges $75 AWS Credit* $130,000 in prizes Codegeist: Atlassian

    Add-on Hack-a-thon Plus a t-shirt. Just for participating. *First 400 sign-ups 7 categories to win Robert Scoble Dion Almaer Emma Jane Hogbin Westby http://codegeist.atlassian.com