@moneylion/s3-deploy NPM

s3-deploy

A command line tool to deploy static sites to an S3 bucket.

Why?

At Moneylion, we have a lot of web properties. In order to untangle some of our deploy processes for frontend assets, we developed this script which allows us to quickly and painlessly configure a new deployment to S3.

One of the main uses for this script is to create temporary review-apps. When a new PR is created, this triggers a build in our CI pipeline, if all the tests pass and it builds successfully, then we deploy that PR to a temporary and shareable URL. Once the PR is closed, we tear it down.

Required ENV Variables

AWS_SECRET_ACCESS_KEY
AWS_ACCESS_KEY_ID
AWS_DEFAULT_REGION

optional

SLACK_TOKEN

Usage

npx @moneylion/s3-deploy

Arguments

argument	description
`domain`	A fully qualified domain name.
`zone`	The route53 HostedZoneId.
`distribution`	The CloudFront DistributionId.
`channel`	The slack channel name.

Commands

`deploy`

This will create a new S3 bucket and point route53 at it. The last argument must be the directory to be uploaded. If an S3 bucket with this name already exists, then it will be cleared before the new files are uploaded.

requires:

domain
zone

e.g. npx @moneylion/s3-deploy deploy --domain test.example.com --zone Z2XDC2IJ26IK32 ./dist

`undeploy`

This will delete an S3 bucket and the route53 record set.

requires:

domain
zone

optional

channel

e.g. npx @moneylion/s3-deploy undeploy --domain example.com --zone Z2XDC2IJ26IK32

`promote`

Creating a cloudfront distribution is outside the scope of this script. There are no future plans to support this feature.

requires an already existing bucket requires an already existing cloudfront distribution

This will not create a new bucket, it will instead empty an already existing and then upload the new assets to that bucket. It will also invalidate the cloudfront cache.

requires: