Build React Static in Lambda

Static Site Generation in Lambda with React Static: Medium

Configuration

Lambda

• Architecture: x86_64
• Memory: 1024 MB (at least)
• Ephemeral storage: 512 MB (at least)
• Timeout: 15 min (maximum available)

Permissions

Configure the policy:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "VisualEditor0",
      "Effect": "Allow",
      "Action": "s3:PutObject",
      "Resource": "arn:aws:s3:::${LAMBDA_S3_BUCKET_NAME}/*"
    }
  ]
}

Environment Variables

• LAMBDA_ACCESS_KEY_ID and LAMBDA_SECRET_ACCESS_KEY - credentials for the AWS user to deploy files, for local
  development usage,
• LAMBDA_S3_BUCKET_NAME - S3 bucket name to deploy files to,
• LAMBDA_USE_POLICY - to use (true) or not to use (false) IAM policy instead of the AWS user, convenient in the
  actual Lambda environment,
• LAMBDA_USE_TMPDIR - to use (true) or not to use (false) temporary directory for the build artifacts, must
  be true in the actual Lambda environment, can be false for local development usage.

Development

Make sure to set up environment variables in the .env file (see .env.example).

Docker

Build

docker build -t build-react-static-in-lambda .

Run

docker run --env-file .env -p 9000:8080 build-react-static-in-lambda

Test

curl -XPOST "http://localhost:9000/2015-03-31/functions/function/invocations" -d '{}'

Explore container

docker ps
docker exec -it <CONTAINER ID> bash

Without Docker

npm install
node lambda/without-docker

Reference

• Creating Lambda container images
• Running Gatsby in an AWS Lambda