README.md

Learning HTTP Caching Headers

Learning cache-control and etag header with serverless, AWS Lambda, AWS Cloudfront and Fastly.

• API: https://832ibzgi7l.execute-api.us-east-1.amazonaws.com/
• CloudFront CDN: https://d2eritzsw5e2yi.cloudfront.net
• Fastly CDN: http://832ibzgi7l.execute-api.us-east-1.amazonaws.com.global.prod.fastly.net/

Usage

# install dependencies
yarn

# deploy function to AWS (make sure AWS CLI is setup)
yarn deploy

# stream the logs of the function
yarn logs

# only deploy function code (faster then full function deployment)
yarn deploy:function

# print lambda and cloudfront url
yarn deploy:info

# invalidate cloudfront (replace the distribution id with yours)
yarn invalidate:cdn

# remove function from AWS
yarn deploy:remove

First deploy can take very long (around 5 minutes) as we need to wait for CloudFront to instantiate

Architecture

The idea is to have a CDN in front of our serverless function to improve API performance. The CDN is controlled via the HTTP header cache-control.

Serverless Node Function
     (AWS Lambda)
          ↑ 
          ↓
         CDN
   (AWS Cloudfront)
          ↑
          ↓
         User

We can also use this setup to host a website. Depending on the framework and techniques you might also want to introduce S3 for your static files then.

Caching

• stale-while-revalidate: not supported by CloudFront
  • Very old post on AWS forums: https://forums.aws.amazon.com/thread.jspa?threadID=161496

Resources

• https://developer.mozilla.org/de/docs/Web/HTTP/Headers/Cache-Control
• https://www.youtube.com/watch?v=bfLFHp7Sbkg
• https://github.com/Droplr/serverless-api-cloudfront