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.
- Register your Domain in Route53. AWS will generate a Route53 Hosted Zone after registration.
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."
I like to generate static code Hugo, 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. Other useful commands:
- Run locally with
hugo server -D - Build for s3 with
hugo -D - Deploy build to s3 with
hugo -v deploy
- Validate Cloudformation with cfn_nag