Skip to content

docs: comprehensive AWS EC2 deployment guide - #42

Merged
getdownandcode merged 2 commits into
mainfrom
docs/aws-deployment-guide
Sep 29, 2026
Merged

getdownandcode merged 2 commits into
mainfrom
docs/aws-deployment-guide

Conversation

@getdownandcode

Copy link
Copy Markdown
Owner

Description

This PR implements Milestone 12 Task 2 (M12-T02).

Changes

  • docs/DEPLOY.md: Complete production deployment guide for AgentKit on AWS EC2:
    • Architecture diagram detailing internal docker networks and reverse proxy
    • Sizing guidance across development, production, and high-throughput workloads
    • Security group inbound/outbound rules strictly blocking public access to PostgreSQL and Redis
    • Automated host setup and Docker CE / Docker Compose installation instructions
    • Dynamic secrets management using AWS SSM Parameter Store and restricted .env permissions
    • Production systemd service unit (agentkit.service) for lifecycle management across reboots
    • Automated SSL/TLS reverse proxy configurations for both Caddy and Nginx + Certbot
    • Verification checklist and automated S3 backup cron script

Verification

  • Docs and markdown formatting verified
  • Test suite passing with 100% success (228 tests)
  • Mypy and ruff validation clean

…uide

- Define single-node EC2 target architecture diagram and components
- Document EC2 sizing recommendations across development and production
- Specify strict AWS security group inbound rules blocking direct DB/Redis exposure
- Provide automated Docker CE and Compose installation commands for Ubuntu 24.04
… proxy configuration

- Add AWS SSM Parameter Store dynamic secret retrieval script
- Provide production systemd service definition for Docker Compose lifecycle
- Include complete Caddy and Nginx + Certbot automatic SSL configurations
- Add deployment verification checklist and S3 database backup cron

@getdownandcode getdownandcode left a comment

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Self-review: docs/DEPLOY.md is comprehensive and satisfies M12-T02 criteria, providing complete instructions for EC2 provisioning, security groups, systemd service daemon, SSM secret handling, Caddy and Nginx SSL termination, and maintenance.

@getdownandcode
getdownandcode merged commit 15ff383 into main Sep 29, 2026
1 check passed
@getdownandcode
getdownandcode deleted the docs/aws-deployment-guide branch September 29, 2026 18:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant