Static Website CLI

This CLI tool makes it easy to deploy a static website to AWS. It builds and hosts the website, sets up a CDN and DNS, and provisions an SSL certificate.

Prerequisites

In order to manage DNS, the tool needs to be able to configure endpoints in your DNS zone. You must have an existing Route53 zone corresponding to the --domain-zone specified. To purchase a new domain name and setup the corresponding zone, follow the Register a domain name instructions here.

This will have cost implications!

AWS Access

The tool needs AWS CLI credentials setup in order to deploy to AWS. The minimum policy required is available in a sample policy.json document.

Although the AWS CLI itself isn't required, staticwebsite-cli uses the same configuration system. The CLI's credential file configuration documentation will help you get started.

You will need to either:

• Setup a profile in your AWS credentials file
• Setup environment variables AWS_ACCESS_KEY and AWS_SECRET_ACCESS_KEY

Download the CLI

Grab the latest release artifact for your system. Builds are published for Windows, Mac, and Linux. Alternatively, clone this repository and run cargo build 🙂!

Usage

Simply specify: --domain-zone The zone to deploy the website into - e.g. - mydomain.com --domain-name The name of the host. If this isn't specified, we'll deploy at the apex --deploy The directory containing the static website to deploy Your website will then be accessible at https://{domain-name}.{domain-zone} or simply https://{domain-zone} if you didn't specify a domain-name within the zone

```bash

staticwebsite_cli --domain-zone demo.com --domain-name rustacean --deploy sample

💻 ➜ staticwebsite-cli git:(main) ✗ target/debug/staticwebsitecli --domain-zone demo.com --domain-name rustacean --deploy test INFO staticwebsitecli: Checking AWS access INFO staticwebsitecli: AWS access looks good, continuing INFO staticwebsitecli: Found zone zone="ABCDEFG" INFO staticwebsitecli: Using Cloudformation stack name="StaticSite--rustacean-demo-com" INFO staticwebsitecli: Stack doesnt exist; creating INFO staticwebsitecli: Stack created stackid="..." INFO staticwebsitecli: Waiting for stack deployment to complete ... INFO staticwebsitecli::cloudformationhelpers: Stack status status="CREATEINPROGRESS" INFO staticwebsitecli::cloudformationhelpers: Stack status status="CREATECOMPLETE" INFO staticwebsitecli: Stack deploy complete INFO staticwebsitecli: Finding website bucket INFO staticwebsitecli: Uploading bucket="..." INFO staticwebsitecli: Invalidating distribution distributionid="E3EF9EZ9CV2KGJ" INFO staticwebsitecli::cloudfronthelpers: Waiting for invalidation to complete INFO staticwebsitecli::cloudfronthelpers: Invalidation status="InProgress" INFO staticwebsitecli::cloudfronthelpers: Invalidation status="Completed" INFO staticwebsitecli: Distribution invalidated. Ready to go! INFO staticwebsitecli: Link href="https://rustacean.demo.com" INFO staticwebsitecli: All done! ```

Updates

Simply re-run staticwebsite_cli with the same arguments to replace the contents of the website. The CLI will invalidate the CDN distribution and the changes should become immediately available.

Removing the stack

1. Login to the AWS console
2. Visit the Cloudformation console in us-east-1
3. Find the stack named StaticSite--your-domain-name and delete it.