Serverless HipChat Connect Boilerplate by GorillaStack

Elliott Spira | Thu, 30 Jun 2016

Have you ever wanted to try out a full serverless architecture? Or write a HipChat plug-in? The new open source boilerplate from GorillaStack helps developers deploy the back ends for their plugins to Amazon Web Services’ serverless products in Lambda, API Gateway, DynamoDB and S3.

Atlassian, together with Amazon Web Services, engaged GorillaStack to develop an open source boilerplate repository to help their plugin developers deploy the back ends for their plugins to AWS’ serverless products in Lambda, API Gateway, DynamoDB and S3. Basically an AWS HipChat Integration

GorillaStack is a SaaS solution that automates optimizations in the AWS cloud and is a go-to tool for DevOps engineers who want to ease the burden of automating and managing their cloud environments.

We have shown our commitment to open source contributions in the past with a particular focus on serverless solutions so this was an obvious contribution for us to make.

If you’re an engineer and you’re building for HipChat or any of the other Atlassian platforms, you’ll have already given careful consideration to the stack that you use to run your integrations but did you consider AWS’ serverless Lambda function?

Why go serverless with Lambda?

There are four clear benefits to a serverless deployment:

  1. Pay for what you use

Why pay big money for servers to sit mostly idle to have a HA REST API? With AWS Lambda, you pay per invocation and for the amount of time your code runs and amount of memory required. No more paying for idle time.

  1. Easy to start

You don't have to spend a bunch of hours building environments or building CI-CD pipelines for blue-green deployments. Just get your code going, then you can sit back and relax.

  1. Iterate faster

Its super easy to deploy different stages and versions. dev, staging, beta, prod, v1, v2. Slashing deployment overhead gives your more time to focus on the development work that truly matters.

  1. Scale built in

Once again to the architecture point. No need to worry about performance testing or worrying about whether your infrastructure will be able to handle high volumes. Let that be Amazon’s problem!

So, if you want to try out a fully serverless architecture or just write a HipChat plugin. Head to the GorillaStack HipChat Connect Bitbucket Repository and let us know what you think!

For reference, here is the full script of the video:

_Hi, my name is Elliott Spira from GorillaStack and we are doing a screencast of how to get started with our serverless HipChat connect boilerplate repository

First thing we are going to do is clone the repository and change directory to the root directory of the project.

Now we install the serverless framework

And then the grunt-cli

Now we install the project dependencies (all the dependencies for the serverless project)

Then we change to the restApi directory and install these dependencies. This keeps our lambda function zip file smaller and makes deploying quicker!

Now we are going to set up a development environment. We will use ngrok to give our localhost HTTPS endpoints for our emulated API gateway and for our emulated S3 bucket (using python SimpleHTTPServer). Copy both URLs to our config.json file.

Now we run babel to transpile our ES6 code to ES5, to make it compatible with AWS lambda's version of Node.js. We have two grunt tasks available to you, one for single run use, and one that runs in watch mode. Let's leave it in watch mode.

Now we run our grunt task to start our emulated S3 bucket.

We start up DynamoDB local for our local persistence layer.

We now run a grunt task to create our DynamoDB local tables.

Run sls offline start to start emulating API gateway on localhost port 3000.

One of the static assets we serve is an install page. This has an 'Add to HipChat' button and information about the plugin.

Clicking 'Add to HipChat' brings us to our integrations page and brings up modals to select a chat room and verify the granting of permissions.

In our boilerplate we have an example 'echo' webhook, a glance, a sidebar that can update our glance, post a card and launch a dialog.

I'll just demonstrate how a plugin can also be added using your plugin's descriptor URL.

But enough about development environments... Let's go live!

First thing we do is use serverless to create a new stage called 'beta'. This creates a new CloudFormation stack just for this stage.

Now we will deploy our lambda function and all API Gateway endpoints for this stage.

We will copy the endpoint URL back to our config.json file.

Then we update the name and region in our S3 bucket endpoint in the config.json file.

Now we substitute our config.json properties for the stage into our static asset templates and deploy to a new S3 bucket for this stage.

As you can see, we now have our assets hosted on S3 and can add the HipChat connect plugin as we did before.

And there you have it. A HipChat connect plugin running in Lambda, API Gateway, S3 and DynamoDB_

Tags AtlassianDevelopmentHipchatLambdaOpen SourceOpen SourceServerlessBack To All Posts