Serverless + DataStax Astra + Apache Cassandra with React Router demo

This is a demo repository set up to a Serverless react based todo application using a DataStax Astra free tier database for storage in AWS.

This project uses the DataStax NodeJS Cassandra Driver and in AWS Lambda with server rendered React components.

Preparing for demo

Before running the demo, you must install a number of components

AWS cli & proper credentials
servlerless (npm install -g serverless)

Also, create DataStax Astra Cassandra database (free tier):

To keep allow defaults to work name cluster and keyspace tododemo
Download secure bundle to local astra directory

Running in AWS

Deploys Lambda and sets up API Gateway. If custom domain specified, deploys app under this custom domain (first deploy might take some time)

npm install
PUBLIC_PATH=/dev/ \
ASTRA_USERNAME=todolist \
ASTRA_PASSWORD=****** \
npm run sls:deploy

To initialize/clear the Astra C* Database:

curl -X POST https://{deployed_endpoint}/api/init

NOTE: if you specify a different secure connect bundle name the path must be /opt/secure-connect-{dbname}.zip for AWS lambda to locate it.

Running locally

git clone https://github.com/tjake/todo-react-serverless-astra
cd todo-react-serverless-astra
npm install
npm run build
ASTRA_USERNAME=todolist \
ASTRA_PASSWORD=******** \
ASTRA_SECURE_BUNDLE_ZIP=./astra/secure-connect-todolist.zip \
npm start

To initialize/clear the Astra C* Database:

curl -X POST https://localhost:3000/api/init

NOTE: The (secure connect bundle)[https://docs.datastax.com/en/astra/aws/doc/dscloud/astra/dscloudObtainingCredentials.html] must be specified to the local astra directory location when running locally.

Running in AWS with a Custom Domain

Create/transfer yourdomain.com in/to Route53
Verify yourdomain.com ownership
Create *.yourdomain.com certificate request in CloudFront Global (N. Virginia)
Wait for it verification

Run once to deploy domain:

CUSTOM_DOMAIN=todo.domain.com CUSTOM_DOMAIN_ENABLED=true API_URL=https://todo.yourdomain.com/api npm run sls create_domain

To properly serve assets you can use bucket for static files (created automatically by serverless)

PUBLIC_PATH=https://s3-eu-west-1.amazonaws.com/todocdn.yourdomain.com/ \
  CDN_BUCKET=todocdn.yourdomain.com \
  CUSTOM_DOMAIN=todo.yourdomain.com \
  CUSTOM_DOMAIN_ENABLED=true \
  API_URL=https://todo.yourdomain.com/api \
  npm run sls:deploy

Removing from AWS

When you want to remove all AWS resources for this demo:

npm run sls:remove

Things of note:

The contents of this repo were based on the TodoMVC code originally written by Pete Hunt.
The Astra demo was modified from https://github.com/huksley/todo-react-ssr-serverless
There are 3 webpack configs:
- One for server
- Another for client
- Third one (./webpack.serverless.js) for running in serverless
The server starts with empty data. Run curl -X POST http://localhost:3000/api/init to load initial data.
The Cassandra lambda calls are located in server.js

tjake/todo-astra-react-serverless

ErrorLooks like something went wrong!

About

Resources

Uh oh!

Stars

Watchers

Forks

Languages

Error
Looks like something went wrong!