tacklebox-webhooks v0.1.2

Overview

Tacklebox is an open-source serverless framework that offers webhooks as a service.

It includes:

• a CLI tool to deploy and manage AWS infrastructure
• 4 client libraries (JavaScript, Ruby, Python, and Go)
• a RESTful API with docs
• an admin UI

You can read more about our case study here, and you can also watch our presentation here.

The Team

Juan Palma Software Engineer Phoenix, AZ

Kevin Counihan Software Engineer Seattle, WA

Armando Mota Software Engineer Los Angeles, CA

Kayl Thomas Software Engineer Atlanta, GA

Getting Started

Prerequisites

• AWS account
• AWS CLI
• AWS CDK
• Node.js >= 8.10
• NPM

Tacklebox requires that users have an account with AWS and have set up an AWS CLI configuration on their local machine. If you have not already done so, please visit Configuring the AWS CLI and Configuring the AWS CDK for instructions. Tacklebox will use the default credentials and region specified within that profile in order to interact with AWS services.

Install Tacklebox

To install Tacklebox globally to be able to run commands, run:

npm install -g tacklebox-webhooks

Commands

Tacklebox commands conform to the following structure:

tacklebox <commandName>

tacklebox deploy

Used to deploy AWS infrastructure. Once the process finishes, you will be provided with the API Host, which is the base URL you will use to communicate with the Tacklebox API, and the API Key, which is the key the Tacklebox API uses to authenticate you.

The deploy command will create instances of the below:

• API Gateway resource
• SNS topic
• CloudWatch Logs log groups
• Lambda functions
• RDS instance with PostgreSQL
• VPC
• IAM roles

tacklebox ui

Run management UI locally.

tacklebox destroy

Tear down AWS infrastructure.

tacklebox help

Documentation of commands.

Helpful Tips

Accessing AWS services

Tacklebox deploys instances of multiple AWS services. While these instances can be deleted using the destroy command, they can also be accessed and modified using the AWS CLI or via the web console.

Message ordering

Tacklebox does not guarantee delivery of messages in the order in which they are generated.