Skip to content

docs: add AWS deploy page#530

Open
Mustafa-Esoofally wants to merge 7 commits intomainfrom
update/aws-docs-v2
Open

docs: add AWS deploy page#530
Mustafa-Esoofally wants to merge 7 commits intomainfrom
update/aws-docs-v2

Conversation

@Mustafa-Esoofally
Copy link
Contributor

Summary

  • Replace overview.mdx with deploy.mdx for the AWS template, matching the Docker (Docker deploy docs #529) and Railway deploy page pattern
  • Dev section: 6 steps (Clone, API key, Start, Load knowledge, Confirm, Connect)
  • Prod section: 6 steps (Verify credentials, Configure, Deploy, Load knowledge, Get endpoint, Connect)
  • Update docs.json nav: overviewdeploy (Customize subgroup unchanged)

Type of Change

  • Refactoring (restructure existing content)

Checklist

  • Matches Docker/Railway deploy page structure
  • docs.json nav updated
  • Old overview.mdx removed
  • Customize subgroup still works

Replace overview.mdx with deploy.mdx matching the Docker/Railway
deploy pattern (6-step dev + 6-step prod).
Add reference.mdx (manage, customize, troubleshoot) and remove
the 14-page Customize subgroup from nav. Matches Docker/Railway
deploy + reference pattern.
Restore the 14-page Customize subgroup alongside deploy + reference.
Restructure later.
Verified against the actual agentos-aws-template repo:
- Container name: agentos-aws-template-api (not ai-api)
- ECS cluster: agentos-aws-template-prd (not agentos-prd-cluster)
- Commands use --env dev/prd format (not prd:aws shorthand)
- Settings param: aws_subnet_ids (not subnet_ids)
- Remove ECR prereq (template uses Docker Hub)
- Simplify manage table to match README commands
- Add "Set production secrets" step (copy example YAMLs, set API key + DB password)
- Add image_repo and push_images to Configure step
- Add container registry to prerequisites
Docker Hub or ECR login is required before ag infra up can push the image.
- Fix secrets copy path: example_secrets/ -> secrets/ (not secrets/ -> secrets/)
- Fix DB secret key names: MASTER_USERNAME/MASTER_USER_PASSWORD (not DB_USER/DB_PASS)
- Fix ECS container name: agentos-aws-template-prd-api (verified via dry-run)
- Add aws_az1/aws_az2 to Configure step (must match subnet AZs)
- Add Session Manager plugin to prerequisites (required for ECS Exec)
- Require two subnets in different AZs (needed for ALB and RDS)
@shaloo
Copy link
Contributor

shaloo commented Feb 18, 2026

@Mustafa-Esoofally these updates need to go after #534, right?

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.

2 participants

Comments