tusd-dynamo-locker

Godoc

This package provides a DynamoDB-based locker for tusd - a reference implementation of a server that allows resumable uploads via the tus protocol.

Usage

Creating a New DynamoDB Table

A helpful CLI tool has been created to allow one to easily provision a DynamoDB table that can be used with this locker. This tool assumes that the correct AWS credentials have been set or a session (with proper IAM permissions) is currently active.

go build -o setup cmd/setup/main.go

Usage of ./setup:
  -read-capacity-units int
      (optional) DynamoDB Read Capacity Units for Provisioned Capacity
  -region string
      AWS Region (default "us-east-1")
  -table-name string
      DynamoDB Table Name
  -write-capacity-units int
      (optional) DynamoDB Write Capacity Units for Provisioned Capacity

If -read-capacity-units and -write-capacity-units are not specified, a Pay-Per-Request DynamoDB table is provisioned.

In your tusd server

To initialize a locker, a pre-existing connected DynamoDB client must be present.

import (
  dynamolocker "github.com/chen-anders/tusd-dynamo-locker"
)

...

cfg, err := config.LoadDefaultConfig(
		context.TODO(),
		config.WithRegion("us-west-2"),
)

if err != nil {
	t.Fatalf("failed to connect to local dynamoDB: %v", err)
}
dynamoDBClient := dynamodb.NewFromConfig(cfg)
locker, err := dynamolocker.New(dynamoDBClient, "my-locker")
if err != nil {
  log.Fatal(err)
}

The locker will need to be included in composer that is used by tusd

composer := tusd.NewStoreComposer()
locker.UseIn(composer)