https://github.com/milldr/serverless-site-basics

all you need to get a static website hosted on S3
https://github.com/milldr/serverless-site-basics

aws cloudfront hugo route53 s3 serverless

Last synced: 12 days ago
JSON representation

all you need to get a static website hosted on S3

• Host: GitHub
• URL: https://github.com/milldr/serverless-site-basics
• Owner: milldr
• License: mit
• Created: 2020-04-14T00:52:07.000Z (over 4 years ago)
• Default Branch: master
• Last Pushed: 2020-06-15T21:33:09.000Z (over 4 years ago)
• Last Synced: 2024-10-06T01:21:38.621Z (about 1 month ago)
• Topics: aws, cloudfront, hugo, route53, s3, serverless
• Size: 8.79 KB
• Stars: 0
• Watchers: 2
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# Static Site Quickstart

All you need to get started with a static website. Search and replace `mystaticsite.com` to whatever `site.com` you want throughout. It should be replaced in the Cloudformation template, the github action to deploy the stack, and in the config.toml example.

## AWS Generated Resources

### Manual Steps BEFORE Running:

- Register your Domain in Route53. AWS will generate a Route53 Hosted Zone after registration.

### Running Cloudformation

Cloudformation template will generate all necessary resources to host a static website on S3 linked to a Cloudfront Distribution. All resources are listed under youre newly created stack, including:

- S3 Bucket to host the static content

- S3 Bucket Policy for public access THROUGH Cloudfront

- CloudFront Origin Access Identity to limit access to the Bucket content

- CloudFront Distribution to provide to access the Bucket content and to link up the Domain name.

- ACM Certificate with AWS Certificate Manager, using DNS validation. 

*NOTE* For the first deployment, AWS requires that you manually add the CNAME for the new ACM Cert to your domain. From AWS Docs: "When you use the AWS::CertificateManager::Certificate resource in an AWS CloudFormation stack, the stack will remain in the CREATE_IN_PROGRESS state. Further stack operations will be delayed until you validate the certificate request, either by acting upon the instructions in the validation email, or by adding a CNAME record to your DNS configuration."

## Content Generation

I like to generate static code [Hugo](https://gohugo.io/), but that isnt actually included in this repo itself. Hugo will generate everything you need; all you need to do to get started is to follow their [quickstart](https://gohugo.io/getting-started/quick-start/). Other useful commands:

- Run locally with `hugo server -D`

- Build for s3 with `hugo -D`

- Deploy build to s3 with `hugo -v deploy`

## Pipeline Automation: GitHub Action

- Validate Cloudformation with [cfn_nag](https://github.com/stelligent/cfn_nag)