Deployment

The docs site is part of the onebrick-stack Compose deployment. It builds a static Zudoku site and serves it from an nginx container named docs-site. Caddy terminates TLS and routes docs.onebrick.io to that container.

Local Build

From deploy/docs-site:

Code
npm install
npm run build

The production build writes static assets to dist.

EC2 Deployment

The production deploy root is:

Code
/srv/onebrick/stack/deploy

After syncing the updated deploy folder to EC2:

Code
cd /srv/onebrick/stack/deploy
sudo docker compose --env-file .env up -d --build docs-site reverse-proxy

Verify:

Code
sudo docker compose ps docs-site reverse-proxy
curl -fsS https://docs.onebrick.io/

DNS for docs.onebrick.io must point to the same EC2 Elastic IP as the other OneBrick stack domains, and inbound ports 80 and 443 must remain open.