DynamoDB bindings for atlassian cloud applications

AWS DynamoDB bindings for atlassian-connect-express.

This is useful to host atlassian cloud applications in AWS lambda. One could use a rational DB with AWS, but DynamoDB is better suited for this task.

Installation

To use this library in your atlassian cloud application:

1. Create a new DynamoDB table to store information about tenants

   TenantTable:
     Type: AWS::DynamoDB::Table
     Properties:
       TableName: TENANT_TABLE
       KeySchema:
         - AttributeName: clientKey
           KeyType: HASH
         - AttributeName: key
           KeyType: RANGE
       AttributeDefinitions:
         - AttributeName: clientKey
           AttributeType: S
         - AttributeName: key
           AttributeType: S
       BillingMode: PAY_PER_REQUEST
       SSESpecification:
         SSEEnabled: true
   

2. Install this library

   npm install --save atlassian-connect-express-dynamodb

3. Add this library as requirement to app.js and register the adapter

   var ac = require('atlassian-connect-express'); // insert after this line
   var adapter = require('atlassian-connect-express-dynamodb');
   ac.store.register("dynamodb", adapter);
   

4. Modify config.json to use the dynamodb adapter

       [...]
       "store": {
           "adapter": "dynamodb",
           "table": "tenants",
   
           // optional options
           "connectionTimeout": 2500, // milliseconds
           "timeout": 2500 // milliseconds
           "maxRetries": 4
       },
       [...]
   

Credentials

This library uses the AWS SDK for nodejs. There are several methods for providing the needed AWS credentials. Consult the AWS documentation for more information.