This document discusses integrating Jira Software Cloud with the AWS Code Suite. It covers using Atlassian Connect and Spring Boot to build a Jira app, deploying the necessary AWS infrastructure including ECS, CodePipeline, Lambda, and ECR, and using Lambda functions and triggers to integrate development workflows and send build data from AWS to Jira. The presentation provides an overview of the key AWS services and development tools used, sample code and configurations, and best practices for building and hosting containerized Jira apps on AWS.

1. JAY YERAS | PARTNER SOLUTIONS ARCHITECT | AMAZON WEB SERVICES
Integrating Jira Software Cloud
with the AWS Code Suite

2. About Me
• Partner Solutions Architect
• Specialize in DevOps
• Over 20 years experience
• 2 ½ years at AWS

3. About Me
• Partner Solutions Architect
• Specialize in DevOps
• Over 20 years experience
• 2 ½ years at AWS
What you will learn
• This is a technical presentation
• Best practices for containerized applications
• Sample code

4. Why are we here?
INTRODUCTION

6. Source WorkflowServices Integrate
Topics to Cover

7. Getting started
Building your application
SOURCE

8. Source
Atlassian Connect
Foundation for Jira Cloud apps which
provides discovery, installation,
authentication, and seamless
integration into the Jira UI.

9. Source
Atlassian Connect

10. Framework
Spring Boot
Externalize your configuration in order
to leverage the same application code
in different environments.

11. Framework
Spring Boot
server.port: ${SERVER_PORT:8080}
addon:
key: jira-data-provider-aws-addon
base-url: http://localhost:${BASE_URL:8080}
logging.level.com.atlassian.connect.spring: DEBUG
security.ignored: /jwt-myself,/oauth2-myself,/relay/**
security:
login: ${SECURITY_LOGIN:user}
password: ${SECURITY_PASSWORD:password}

12. Framework
App descriptor
{
"modules": {},
"key": "my-app-key",
"name": "My Connect App",
"description": "A connect app that does something",
"vendor": {
"name": "My Company",
"url": "http://www.example.com"
},
"links": {
"self": "http://www.example.com/connect/jira/atlassian-connect.json"
},
"lifecycle": {
"installed": "/installed",
"uninstalled": "/uninstalled"
},
"baseUrl": "http://www.example.com/connect/jira",
"authentication": {
"type": "jwt"
},
"enableLicensing": true,
"scopes": [
"read",
"write"
]
}

13. Framework
App descriptor
"key": "my-app-key",
"baseUrl": "http://www.example.com/connect/jira",
"key": "${addon.key}”,
"baseUrl": "${addon.base-url}”,

14. Networking
By the numbers
1. A valid SSL certificate issued by
an external Certificate Authority
is required.
2. Jira strictly supports HTTPS for all
communications between the
add-on application and your
cloud tenant.

15. Networking
ngrok
Public URLs for exposing web
applications and building webhook
integrations and more!

16. Networking
ngrok
>npm install ngrok -g
>ngrok http 8080
Session Status online
Session Expires 7 hours, 57 minutes
Version 2.3.25
Region United States (us)
Web Interface http://127.0.0.1:4040
Forwarding http://YOUR_NGROK_SUBDOMAIN.ngrok.io -> http://localhost:8080
Forwarding https://YOUR_NGROK_SUBDOMAIN.ngrok.io -> http://localhost:8080
Connections ttl opn rt1 rt5 p50 p90 0 0 0.00 0.00 0.00 0.00

17. Run
Java & Maven
We will need to have Java 8 and
Maven installed.

18. Run
Using the Maven Plugin
mvn spring-boot:run -Drun.arguments=
"--addon.base-url=$ngrokURL",
"--security.login=$(aws secretsmanager
get-secret-value --secret-id
AtlassianAPIUser --query SecretString)",
"--security.password=$(aws secretsmanager
get-secret-value --secret-id
AtlassianAPIToken --query SecretString)"

19. Run
Response
{
"modules": {},
"key": "my-app-key",
"name": "My Connect App",
"description": "A connect app that does something",
"vendor": {
"name": "My Company",
"url": "http://www.example.com"
},
"links": {
"self": "http://www.example.com/connect/jira/atlassian-connect.json"
},
"lifecycle": {
"installed": "/installed",
"uninstalled": "/uninstalled"
},
"baseUrl": "http://www.example.com/connect/jira",
"authentication": {
"type": "jwt"
},
"enableLicensing": true,
"scopes": [
"read",
"write"
]
}

20. Using the right tools
Hosting your application on AWS
SERVICES

21. AWS Cloud
getCommit function
AWS CodeBuild
AWS CodeCommit
AWS CodePipeline
VPC
Public Subnet
Availability zone 1
Atlassian Connect App
getState function
AWS Fargate
Network Load Balancer
Event (event-based)
Amazon CloudWatch
AWS Lambda
Certificate
AWS Certificate Manager
AWS Secrets Manager
RegistryImage
Task
Service
Amazon EC2 Container Registry
Request token
Return token
Git push
Build and store artifacts
Issue certificate
Listener: tcp 443
Deploynewimage
QueryCode*APIs
POST

22. IDE
AWS Cloud9
Write, run, and debug your code with
just a browser. Integrated direct
terminal access to AWS.

23. IDE

24. Registry
Amazon ECR
Fully-managed Docker container
registry that makes it easy for
developers to store, manage, and
deploy Docker container images.

25. Pipeline
AWS CodePipeline
Fully managed continuous delivery
service that helps you automate the
build, test, and deploy phases of your
release process.

26. Orchestrator
AWS Fargate
Fully managed compute engine for
Amazon ECS that allows you to run
containers without having to manage
servers or clusters.

27. Deploying your infrastructure
Automation every step of the way
WORKFLOW

28. AWS Cloud9
WORKFLOW
AWS Fargate
LAUNCH
AWS CodePipeline
Amazon ECR
AWS CodeBuild
INSTALL
AWS CodeCommit
AWS Lambda
Java 8 & Maven
DEPLOY
INTEGRATE

29. Dockerfile
Multi-stage builds
Allows you to use multiple FROM
statements that use a different base,
and selectively copy artifacts from
one stage to another.

30. Dockerfile

31. Build
Build Specification File
A collection of build commands and
related settings, in YAML format, that
AWS CodeBuild uses to run a build.

32. Build

33. Definitions
ECS Task Definitions
Blueprint for our application. Defines
attributes such as CPU and memory
requirements, networking
configuration, and container
definitions.

34. Definitions
ECS Task Definitions
Environment:
- Name: SECURITY_LOGIN
Value: !Ref 'JiraUser'
- Name: SECURITY_PASSWORD
Value: !Ref 'JiraPass'
- Name: ADDON_BASE_URL
Value: !Join ['', ['https://', !GetAtt 'PublicLoadBalancer.DNSName']]
- Name: SERVER_PORT
Value: !Ref 'JiraServerPort'

35. Definitions
ECS Task Definitions

36. Leveraging integration points
Using AWS Lambda
INTEGRATE

38. Triggers
AWS CodeCommit
Will allow our Lambda function to be
invoked based on events that take
place in our repository.

39. SEQUENCE OF EVENTS
COMMIT TRIGGER POST TRIGGER POST
Change to source
Query
CodeCommit API
Send event data
to app
Query
CodePipeline API
Send event data
to app
TRIGGER
Pipeline starts
build

40. Triggers
AWS CodePipeline
You can invoke AWS Lambda in a
Pipeline in CodePipeline, but…

41. SEQUENCE OF EVENTS
COMMIT TRIGGER POST TRIGGER POST
Change to source
Query
CodeCommit API
Send event data
to app
Query
CodePipeline API
Send event data
to app
TRIGGER
Pipeline starts
build

42. Functions
Development Tool
Sending development information to
JIRA will be displayed in the
development information panel when
an issue is viewed.

43. SEQUENCE OF EVENTS
COMMIT TRIGGER POST TRIGGER POST
Change to source
Query
CodeCommit API
Send event data
to app
Query
CodePipeline API
Send event data
to app
TRIGGER
Pipeline starts
build
commitId,
commitMessage,
authorName,
fileCount,
etc.

44. Functions
Build
Sending build information to JIRA and
associate it with issues.

45. SEQUENCE OF EVENTS
COMMIT TRIGGER POST TRIGGER POST
Change to source
Query
CodeCommit API
Send event data
to app
Query
CodePipeline API
Send event data
to app
TRIGGER
Pipeline starts
build
commitId,
commitMessage,
authorName,
fileCount,
etc.
pipelineExecutionId,
executionStatus

46. What did we learn?
CONCLUSION

47. Summary
Source
Atlassian Connect Spring Boot
starter.
Workflow
Deploying a supporting infrastructure
to host your Connect app on AWS.
Integrate
AWS Lambda functions and event
triggers to send data to Connect.
Services
AWS Cloud9, Amazon ECR, AWS
Developer Tools, & AWS Fargate

49. JAY YERAS | PARTNER SOLUTIONS ARCHITECT | AMAZON WEB SERVICES
Thank you!
https://atlassian.awsworkshop.io
https://github.com/aws-samples/aws-code-suite-for-atlassian-connect