This is a template repository to set up foundational infrastructure for your application in AWS. This template includes setup for:

• Team workflows - templates for pull requests (PRs), architecture decision records (ADRs), and Makefiles.
• Account level foundational infrastructure - infrastructure for terraform backends, including an S3 bucket and DynamoDB table for storing and managing terraform state files.
• Application infrastructure - the infrastructure you need to set up a basic web app, such as a image container repository, load balancer, web service, and database.
• CI for infra - GitHub action that performs infra code checks, including linting, validation, and security compliance checks.
• CD / Deployments - infrastructure for continuous deployment, including: AWS account access for Github actions, scripts for building and publishing release artifacts, and a Github action for automated deployments from the main branch.
• Documentation - technical documentation for the decisions that went into all the defaults that come with the template.

The template infra is intended to work with multiple application templates. See template-application-flask and template-application-nextjs.

To get started using the template infrastructure on your project, install the template by cloning the template repository and copying the following folders/files to your repository and removing any files that are only relevant to the template itself:

# fetch latest version of template-infra
git clone --single-branch --branch main --depth 1 [email protected]:navapbc/template-infra.git

cp -r \
  template-infra/.github \
  template-infra/bin \
  template-infra/docs \
  template-infra/infra \
  template-infra/Makefile \
  .

rm .github/workflows/template-only-*

# clean up template-infra folder
rm -fr template-infra

Now you're ready to set up the various pieces of your infrastructure.

1. Set up team workflow
2. Set up resources needed to manage infrastructure as code (IaC)
3. Set up continuous integration
4. Set up application
5. Set up application environments