humanmade/local-pinpoint

Local testing server for AWS Pinpoint

Local AWS Pinpoint Server

This is a barebones mock image for testing AWS Cognito & Pinpoint. It is ideal for Amplify JS or any other implementation of client side Pinpoint anayltics.

API

The following AWS SDK API commands are supported:

• UpdateEndpoint: Updates and stores endpoint data for the given Cognito identity ID.
• PutEvents: Sends event data to Pinpoint, this is then merged with the corresponding endpoint data and delivered to elasticsearch.

Docker compose usage

services:
  pinpoint:
    image: humanmade/local-pinpoint
    ports:
      - 3000
    environment:
      ELASTICSEARCH_HOST: http://elasticsearch:9200
    networks:
      - default
  elasticsearch:
    image: blacktop/elasticsearch
    ports:
      - 9200
    networks:
      - default

networks:
  default:

Index rotation

Index rotation is supported in accordance with the AWS Kinesis Firehose Elasticsearch destination options.

To enable index rotation set the INDEX_ROTATION environment variable to one of the following values: NoRotation (default), OneMonth, OneWeek, OneDay or OneHour.

Local Cognito

This image is a counterpart to local-cognito but can also be used with a live Cognito Idenitity Pool instance.

local-pinpoint's Issues

Queue Elasticsearch writes

To better reflect the real service and also improve performance and reduce resource usage it'd be good to find a way to queue the writes to Elasticsearch up.

Can explore using a child/worker thread if it's possible to re-bind from a fresh function call.