tpl-aws-astro

A monorepo template for an AWS-hosted, Astro-generated static website, complete with infrastructure code, CI/CD automations, multiple environments, and optional basic auth protection.

💲 >= $0.50 🌟 Monthly AWS cost (🌐 DNS Zone + 🔧 usage)

Table of Contents

• Infrastructure and Flow Diagram
• Monorepo Layout
• Usage
• Setup
• Makefile

Infrastructure and Flow Diagram

A high-level infrastructure diagram illustrating service integrations and user flows.

Learn more infrastructure details from the documentation.

Monorepo Layout

• fe/ - Frontend project
• infra/ - Infrastructure project
• e2etest/ - End to end test project
• config.json - Config file
• Makefile - Task automations

Learn more about monorepo architecture from the documentation.

Usage

1. Start new repository from this template.
2. Update config.json as necessary.
3. Go through Setup steps.
4. Edit fe/src files, git add, git commit, git push, etc.
5. Vaildate stg deployment and run deploy workflow for prd env.

Setup

Deploy infrastructure

Start with deploying AWS shared resources and deploy infrastructure for stg and prd environments.

make infra-deploy-certificate
make infra-deploy-github-oidc
make infra-deploy ENV=stg
make infra-deploy ENV=prd

Update s3bucket and cloudfrontId in config.json with values returned in stack outputs.

CI/CD

To enable the deployment workflow, configure the following Environments and Environment Variables in your GitHub repository settings:

• Environments:
  • prd - Production
  • stg - Staging
• Environment variables:
  • AWS_REGION - AWS region environment is deployed to
  • AWS_ROLE - AWS CI/CD Role ARN

Use CDRoleArn value from infra-deploy outputs to update AWS_ROLE environment variable for a corresponding environment in repository settings.

Makefile

Use make to run tasks in this project:

make
# Available targets:
#   deploy - Build & deploy infrastructure and frontend
#   fe-%   - Frontend (fe) targets
#   infra-% - Infrastructure (infra) targets

make fe
# Available targets:
#   build - build frontend
#   deploy - deploy frontend
#   init - init dependencies
#   init-test - init test dependencies
#   test - run tests
#   npm-run-% - run any npm script
#   npm-% - run any npm command

make infra
# Available targets:
#   deploy - deploy infrastructure
#   deploy-certificate - deploy ACM certificate
#   deploy-github-oidc - deploy GitHub OIDC
#   test - test infrastructure

make e2etest
# Available targets:
#   run - run e2e tests
#   init - init dependencies
#   init-test - init test dependencies
#   test - run tests
#   npm-run-% - run any npm script
#   npm-% - run any npm command