Join Atlassian developer Patrick Streule to learn about a Java- and JavaScript-based framework that makes it easy for developers to create and deploy serverless add-ons, thanks to platforms like AWS Lambdas and DynamoDB. He'll cover the overall architecture of serverless add-ons, then explain how to manage security, deployments, and integrations with various AWS services and other modern serverless providers. Patrick Streule, Architect, Atlassian

1. Atlassian Connect
on Serverless Platforms
Low Cost Add-Ons
PATRICK STREULE | ARCHITECT | ATLASSIAN | @PSTREULE

2. • Big cool statistic
• 2,56
9
• Add-Ons in Marketplace
SERVERS
SERVERS EVERYWHERE

3. • Big cool statistic
• 2,56
9
• Add-Ons in Marketplace

4. Agenda
Static Add-ons
Serverless Data Storage
Serverless Add-ons
Deploying Serverless Add-ons

5. Agenda
Static Add-ons
Serverless Data Storage
Serverless Add-ons
Deploying Serverless Add-ons

6. Agenda
Static Add-ons
Serverless Data Storage
Serverless Add-ons
Deploying Serverless Add-ons

7. Agenda
Static Add-ons
Serverless Data Storage
Serverless Add-ons
Deploying Serverless Add-ons

8. Static Add-ons

9. Static
Add-ons
Static Site
Static Add-on
HTML
JS
CSS
HTML
JS
CSS
Browser
Static Hosting
CDN
Cheap
Fast
Cacheable

10. Static
Add-ons
Static Site
Static Add-on
HTML
JS
CSS
HTML
JS
CSS
Browser
Static Hosting
CDN
Host

11. Static
Add-ons
Static Site
Static Add-on
API
Iframe bridge
JS (and REST) API
HTML
JS
CSS
HTML
JS
CSS
Host
Browser
Static Hosting
CDN

13. ADD-ON Host Client API Lib
Adobe editor
Versioned add-on CSS
Versioned add-on JS
React Mount Point

14. HOST API EXAMPLE
Use HipChat API
to interact with
the host
Register
handlers for
HipChat events

15. Limitations

16. LIFECYCLE HOOKS JWT OPT-OUT
installable": {
"callbackUrl": "https://…",
"allowRoom": true,
"allowGlobal": false
}
{
"key": "editor",
"title": {
"value": "Image editor"
},
"url": "https://image-editor…",
"authentication": "none"
},

17. WEBHOOKS SCOPES
"webhook": {
"url": "https://addon…",
"event": "room_message",
"pattern": "something"
}
"hipchatApiConsumer": {
"scopes": [
"send_notification",
"view_room"
]
}

18. Integrated in
Bitbucket Pipelines
Git push deployments
Hosting
Free Starter Plan
Yes, free!
Hosted on Aerobatic
Automatic asset versioning,
CDN, SSL

19. Serverless Data Storage
also known as Content Properties

21. CONTENT PROPERTIES
Property Key
Value Object Array of
Page Views
Array of Users

22. BLUEPRINT
iFrameBridge
Add-On Page
Comment
Space
AP.request()
POST /rest/api/space/{key}/property

23. BLUEPRINT
iFrameBridge
Add-On
AP.request()
POST /rest/api/content/{id}/property
Page
Comment
Space

24. CONTENT API
Connect AP.request Module
Content Property URL
with Content ID…
…and property
key
Success function

25. Content
API
GET /rest/api/2/issue/{id}/properties
GET /rest/api/2/project/{key}/properties
GET /rest/api/2/user/properties
GET /rest/atlassian-connect/1/addons/{add-on-key}/properties
Limits
Other Options

26. Content
API
GET /rest/api/content/{id}/property
GET /rest/api/space/{key}/property
GET /rest/atlassian-connect/1/addons/{add-on-key}/properties
Limits
Other Options

27. Content
API
32KB
Is the maximum amount of data that can be stored for
each key.
More than one key
You can use different keys for different purposes,
which allows more than 32KB of data in total.
Limits
Other Options

28. Content
API
Custom Content
Confluence allows to define custom content types,
which can also be used for data storage by add-ons.
Limits
Other Options

29. Serverless Add-ons

30. Run short-lived
backend code.
Don't pay for idle
time.
Client-accessible
backend
services. Pay for
what you use.
BACKEND AS A SERVICE FUNCTIONS AS A SERVICE

31. FUNCTIONS AS A SERVICE
time𝝺 𝝺𝝺
Invocation
Deployed,
but not running
𝝺
Invocation
Started when
called
𝝺
Stopped when
inactive
𝝺
May stay active
across multiple
calls

32. No
Infrastructure
No base image
updates, no instance
provisioning
Less Ops
Monitoring,
deployment
infrastructure etc.
still needed.
Serverless != NoOps
Cheap
Pre-prod
Low-traffic dev and
staging
environments don't
add cost
Elastic Scaling
Managed and
automatic
Benefits
Dev
Staging
Production

33. Expensive at scale
Possibly cheaper to run
instances and containers at
scale
Downsides
Start-up penalty
Increased latency on
requests that spin up the
function
Tooling
Less mature tooling for
development, deployment,
debugging, …

34. Examples

36. EXAMPLE 1
Wolfram Alpha
A HipChat bot that tries to
answer any question.

37. AWS Lambda
Runs the code.
Pay only for
execution time
AWS API Gateway
HTTP to Lambda gateway.
Pay for # of calls and data
transfer.
What is being used?

38. BLUEPRINT
/wolfram 1+1
APIGateway
𝝺
Implementation
webhook
webhook response
Wolfram Lambda - 8:12 PM
1+1: 2

39. PROJECT STRUCTURE
Deployed to AWS
Test data
Business Logic
Test helper
API token config
Lambda entry point
Deployment
descriptor

40. SERVERLESS DESCRIPTOR
Exclude files not
needed at runtime
Keep them as
low as possible
This is the
entry point POST /wolfram

41. ADD-ON
This is the
entry point
Reply to the
HipChat
web hook
Call Wolfram
Alpha API
Transform
API Result
(removed error handling)

42. Monthly Cost?
2000
calls/month
Free calls to
Wolfram Alpha API
API responses
10KB
data per call+ = $0.01

43. EXAMPLE 2
Bitbucket
Activity Graph
A calendar heat map of commit
activity

44. Aerobatic
Hosts static assets.
Free for two add-
ons.
AWS Lambda
Runs the code.
Pay only for
execution time.
AWS API
Gateway
HTTP to Lambda
gateway.
Pay for # of calls and
data transfer.
AWS
DynamoDB
Stores the data.
Pay for storage and
access.
What is being used?

45. BLUEPRINT
Browser
git push
APIGateway
𝝺
Implementation
DynamoDB
Aerobatic
iframe
webhook
data and assets

46. SERVERLESS
Two
endpoints:
- handle git push
- return data to UI
DynamoDB
Table Definition

47. DESCRIPTOR
Static page,
ajax call to
/activity for
data
Webhook called
on every push
Base URL,
replaced by
Aerobatic

48. PROXY THROUGH AEROBATIC
Proxy calls
to Lambda
Add cache header

49. FUNCTIONS

50. Monthly cost?
100'000
views/day
One query
per view
One write
per commit
≈$15+
20'000
commits/day
1KB
data size+
Counters
are small

51. Deployment
Using Bitbucket Pipelines

52. Reproducible
The build is the source of
truth for every commit.
Deployment
Safe
Automatic deployments to
dev, manual promotion to
production. Easy rollback.
Automated
Run tests on every branch.
Automatically deploy master
to dev environment.

53. Branches
Build Test
master
Build Test Deploy
dev
Deploy
prod

54. PIPELINES
Master: Build and
deploy to dev
Any branch
Manual trigger for
production deployments

55. STAGES
Both Aerobatic and Serverless
support stages

56. STAGES dev stage suffix no suffix for production

61. CONFIGURE ENVIRONMENTS
Linking different stages together
Browser
APIGW
Aerobatic
iframe

62. Configuration
per stage

65. Links
Wolfram Lambda Code: https://bitbucket.org/pstreule/wolfram-lambda
Commit Stats Code: https://bitbucket.org/pstreule/bb-activity-graph
Usage Tracking Code: https://bitbucket.org/kihlberg/usage-tracking

66. Thank you!
PATRICK STREULE | ARCHITECT | ATLASSIAN | @PSTREULE