Setup

Preview locally using the staging database tables:

0. Copy .arc-env-example to .arc-env and get the GITHUB_CLIENT_ID and GITHUB_CLIENT_SECRET values from Brian
1. Install deps by running npm run init
2. Start a reloading dev server npm start

Dev

Lint the code

npm run lint

Run the tests

npm t

Deploy one lambda to staging

npm run deploy src/html/get-index

Deploy static assets to staging

npm run deploy static

CI

Green builds ship everything to staging

important limits

aws infra	apps
60 api gateway restapis per region per account	means we can have max 30 apps per region
15 total availability zones	15 zones x 30 apps === 450 apps per account
1000 iam roles per account	each app requires 1 iam role; still within 450
AWS Orgs lets us create 300 accounts	450x300 === 13500 max possible apps with default limits

takes about 2 minutes to provision one app which means at the current limits it will take 9.375 days to get to max capacity

api gateway operational limits	per min
DeleteRestApi	2 per min
CreateDeployment	3 per min
GetResources	150 per min
CreateResource	300 per min
DeleteResource	300 per min

Total operations 10 request per second (rps) with a burst limit of 40 requests

deletes are ok because we can queue those by removing from app in the db and adding to a whatever-delete table that has a lambda running on a timer cleaning it out. creates/gets: need to be throttled, ui updated with pending state and resolved with completion and/or timeout. ideally via queue to its global to the system/account.

global infra

Each app is a preprovisioned arc app with:

• staging.app-name-0x1.fun.begin.com
• app-name-0x1.fun.begin.com

Static assets are also hosted via two cloudfront distributions:

• static.fun.begin.com/appname
• staging.static.fun.begin.com/appname

Once setup:

• Commits to master deploy to staging.app-name-0x1.fun.begin.com (if the build is green)
• Tags (Github releases) deploy to app-name-0x1.fun.begin.com (if the build is green)
• You can also initiate a release from the web ui
• Apps with npm run build defined will be run; .static is uploaded to their folder only; max 5mb
• Apps can add 3 HTML route Lambdas; max 5 mb ea
• Apps can add 5 JSON route Lambdas; max 5 mb ea
• HTML and JSON endpoints support sessions