Infrastructure

Work-in-progress: This content is incomplete; you can help by expanding it

Hosting

Amplify

EC2

Lambda

Hosting on a subdomain (e.g. projectname.nj.gov) is waaay easier than hosting on a subpath of nj.gov (e.g. nj.gov/agencyname/projectname)

Containerization

We do not have licenses for Docker Desktop, which requires licenses for government entities. We don’t need the GUI, but Docker Engine is difficult to install on MacOS without Docker Desktop. We instead use these open source tools:

1. Docker CLI: Docker’s OCI-compatible container CLI tools
2. Colima: Open source replacement for Docker Engine
3. Docker Compose: it’s open source

For macOS:

# As of writing `brew install docker` installs Docker CLI, but not Docker Engine
brew install colima docker docker-compose
mkdir ~/.docker
cat >~/.docker/config.json <<EOF
  "cliPluginsExtraDirs": [
      "/opt/homebrew/lib/docker/cli-plugins"
  ]
EOF
brew services start colima

For Debian/Ubuntu and WSL:

curl -fsSL https://get.docker.com/ | sh

Docker Engine can still be easily installed on Linux without Docker Desktop. For Windows machines (e.g. agency stakeholders), we suggest using WSL (see Setting up a state Windows laptop), which can be harangued into running containers using the Docker engine on Linux.

Infrastructure as Code

AWS CDK

If Terraform, use OpenTofu

Serverless is deprecated