@dotcom-tool-kit/upload-assets-to-s3

@dotcom-tool-kit/upload-assets-to-s3

Upload files to a configured AWS S3 bucket.

Installation

Install @dotcom-tool-kit/upload-assets-to-s3 as a devDependency in your app:

npm install --save-dev @dotcom-tool-kit/upload-assets-to-s3

Add the plugin to your Tool Kit configuration:

plugins:
	- '@dotcom-tool-kit/upload-assets-to-s3'

Tasks

UploadAssetsToS3

Upload files to an AWS S3 bucket.

Task options

Property	Description	Type	Default
accessKeyIdEnvVar	variable name of the project's aws access key id. If uploading to multiple buckets the same credentials will need to work for all	string	'AWS_ACCESS_HASHED_ASSETS'
secretAccessKeyEnvVar	variable name of the project's aws secret access key	string	'AWS_SECRET_HASHED_ASSETS'
directory	the folder in the project whose contents will be uploaded to S3	string	'public'
reviewBucket	the development or test S3 bucket	Array<string>	["ft-next-hashed-assets-preview"]
prodBucket	production S3 bucket(s). The same files will be uploaded to each. Note: most Customer Products buckets that have a prod and prod-us version are already configured in AWS to replicate file changes from one to the other so you don't need to specify both here. Also, if multiple buckets are specified the same credentials will need to be valid for both for the upload to be successful.	Array<string>	["ft-next-hashed-assets-prod"]
region	the AWS region your buckets are stored in (let the Platforms team know if you need to upload to multiple buckets in multiple regions).	string	'eu-west-1'
destination	the destination folder for uploaded assets. Set to '' to upload assets to the top level of the bucket	string	'hashed-assets/page-kit'
extensions	file extensions to be uploaded to S3	string	'js,css,map,gz,br,png,jpg,jpeg,gif,webp,svg,ico,json'
cacheControl	header that controls how long your files stay in a CloudFront cache before CloudFront forwards another request to your origin	string	'public, max-age=31536000, stale-while-revalidate=60, stale-if-error=3600'

All properties are optional.

Testing uploads using the review bucket

You can test uploads to S3 locally on your review bucket to check that you are happy with the configuration. To do this set your NODE_ENV to branch:

$ export NODE_ENV=branch

If the AWS key names for accessing the review bucket are different to the prod bucket then update those in the .toolkitrc.yml.

The UploadAssetsToS3 task can run on any hook so you can configure it to run on a local hook to test deployment from the command line. For example, it could be added to your build:local hook as follows:

plugins:
  - '@dotcom-tool-kit/webpack'
  - '@dotcom-tool-kit/upload-assets-to-s3'
hooks:
  'build:local':
    - WebpackDevelopment
    - UploadAssetsToS3

Then running npm run build will run the UploadAssetsToS3 task on your review bucket.

Tasks

Name	Description	Preconfigured Hook
UploadAssetsTos3	Uploads provided files to a given S3 bucket	release:remote