Purpose

Uploads static assets to S3 when deploying to heroku. Requires NodeJS to be installed when building.

Setting Mandatory Environment Variables for build

AWS_ACCESS_KEY_ID=<aws access key id>
AWS_SECRET_ACCESS_KEY=<aws secret access key>
AWS_DEFAULT_REGION=<aws-region>
AWS_STATIC_BUCKET_NAME=<s3-bucket-name>
# The directory to upload to S3 (uploads the content of the directory)
AWS_STATIC_SOURCE_DIRECTORY=public

Exported Environment Variables to runtime

STATIC_SERVER=<AWS_STATIC_BUCKET_NAME>.s3.amazonaws.com

This variable can be overriden with config vars as expected

heroku config:set STATIC_SERVER=your.cdn.host

To return to the default value just unset the config vars

heroku config:unset STATIC_SERVER