localstack.md

Localstack

We use Localstack as a stub implementation of many AWS services that we can run locally for development and testing of Taco.

Installing

localstack's dependencies are found here: https://github.com/localstack/localstack#requirements

Follow the directions on installing localstack here: https://github.com/localstack/localstack#installing.

Running

Start localstack by running the command:

$ SERVICES=dynamodb,kinesis,s3 localstack start

Next we have to set up the services.

Create the resources table in DynamoDB:

$ awslocal dynamodb create-table --table-name resources \
  --attribute-definitions "AttributeName=id,AttributeType=S" \
  --key-schema "AttributeName=id,KeyType=HASH" \
  --provisioned-throughput=ReadCapacityUnits=100,WriteCapacityUnits=100

Create the S3 bucket:

$ awslocal s3api create-bucket --bucket taco-deposited-files

Create the Kinesis stream:

$ awslocal kinesis create-stream --stream-name deposit --shard-count 3