Skip to content

Add AWS deployment tutorial (two-instance demo runbook) - #108

Open
arvsa wants to merge 1 commit into
mainfrom
docs/aws-deployment-tutorial
Open

Add AWS deployment tutorial (two-instance demo runbook)#108
arvsa wants to merge 1 commit into
mainfrom
docs/aws-deployment-tutorial

Conversation

@arvsa

@arvsa arvsa commented Jul 10, 2026

Copy link
Copy Markdown
Owner

The Phase 5 tutorial deliverable from plan/argus-server-gaps-and-demo-deployment-v1.md, written as a top-to-bottom runbook for the recommended §4.2 topology:

  • Step 0–4: names/vars, S3 bucket (private + SSE + 7-day lifecycle), two IAM roles/instance profiles (client = PutObject on its own zone prefix only; server = read-only), security groups + 2× t4g.small Ubuntu ARM EC2 via CLI, DNS.
  • Step 5–6: Docker + swap + rsync + Traefik/Let's Encrypt on both boxes (using the repo's compose.traefik.yml).
  • Step 7–8: full .env for each role, compose.yml --profile client vs plain, smoke checks (exporter pushes, aws s3 ls, ingestion logs, role-aware UI).
  • Step 9: signing-key registration through the new zone-detail UI panel (public key read from a pushed manifest — private key never leaves the zone's volume).
  • Step 10: the zone-went-dark staleness demo.
  • Plus ongoing ops (update deploys, backups, key-volume caveat), a troubleshooting table, full teardown commands, and the graduation path.

Cross-linked from deployment.md, which stays the variable-by-variable reference. The doc is explicitly marked as authored ahead of the first real deployment — per the plan, it gets corrected in place while Phase 5 actually runs.

🤖 Generated with Claude Code

Runbook for plan §4.2/Phase 5: S3 bucket with 7-day lifecycle, scoped
write-only/read-only IAM instance profiles (no static keys), two t4g.small
EC2 boxes, Traefik + Let's Encrypt, per-role compose invocations, signing
key registration through the new UI panel, staleness demo, ops notes,
troubleshooting table, and full teardown.

Marked as authored ahead of the first real deployment, to be corrected
in place as Phase 5 executes.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@github-actions github-actions Bot added the docs label Jul 10, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant