Boston Tech Workers Coalition

Local Boston subdomain website.

Prerequisites

Development:

• Google API Key
• NodeJS 18.x

Deployment:

• AWS Credentials
• Terraform

Quickstart

After cloning, build the project:

make

Open .env and terraform.tfvars and fill-in the appropriate GOOGLE_* values:

# .env
GOOGLE_API_KEY=<fill-me-in>

# terraform.tfvars
GOOGLE_API_KEY = "<fill-me-in>"

Start a local server at http://localhost:3000/:

make start

Deploy

This repo is configured to auto-deploy on tagged commits via GitHub Actions. Simply commit your changes, tag the repo, and push to GitHub and it should do the rest!

Manual Deploys

Terraform is used to manage infrastructure.

If you are on a macOS machine and have Homebrew installed, you can install Terraform with brew:

brew install terraform

Build the Lambda package with:

make [--dry-run]

Generate a terraform plan with:

terraform plan

Update infrastructure with:

terraform apply [-auto-approve]

or, to apply without an approval prompt:

make deploy [--dry-run]

Clean up any generated artifacts with:

make clean [--dry-run]

Infrastructure

The project manages the following AWS components:

• Lambda — A function to serve the website
• API Gateway — Web service to invoke the Lambda
• ACM Certificate — An Amazon-issued SSL certificate for boston.techworkerscoalition.org
• Custom Domain — Custom domain mapping the API to boston.techworkerscoalition.org using the above ACM certificate
• S3 Bucket — S3 bucket for storing terraform state