b9f6d4f61e
All checks were successful
CI / validate (pull_request) Successful in 57s
- System design doc (self-hosted + module model, hybrid architecture) - HTML visualization for design review - Architecture diagram (Python diagrams library, real AWS icons) - CloudFormation template (t4g.small EC2 + Docker Compose) - Theme reference images (midnight blue, forest, light) - Updated README for new product direction - MCP config (context7 only, removed aws-docs) - Backend type deps fixed for Windows dev Co-authored-by: Samuel James <ssamjame@amazon.com> Co-authored-by: Kiro <noreply@kiro.dev>
173 lines
4.4 KiB
YAML
173 lines
4.4 KiB
YAML
AWSTemplateFormatVersion: '2010-09-09'
|
|
Description: >
|
|
ArchNest - Single-user self-hosted ops dashboard on AWS.
|
|
Deploys a t4g.small EC2 instance with Docker Compose.
|
|
|
|
Parameters:
|
|
KeyPairName:
|
|
Type: String
|
|
Default: kiro-ide-key
|
|
Description: SSH key pair name for EC2 access
|
|
|
|
InstanceType:
|
|
Type: String
|
|
Default: t4g.small
|
|
AllowedValues:
|
|
- t4g.micro
|
|
- t4g.small
|
|
- t4g.medium
|
|
Description: EC2 instance type (ARM/Graviton)
|
|
|
|
VolumeSize:
|
|
Type: Number
|
|
Default: 30
|
|
Description: EBS volume size in GB
|
|
|
|
Resources:
|
|
# Security Group — allows SSH, HTTP, HTTPS, and the backend port
|
|
ArchNestSecurityGroup:
|
|
Type: AWS::EC2::SecurityGroup
|
|
Properties:
|
|
GroupDescription: ArchNest security group
|
|
GroupName: archnest-sg
|
|
SecurityGroupIngress:
|
|
- IpProtocol: tcp
|
|
FromPort: 22
|
|
ToPort: 22
|
|
CidrIp: 0.0.0.0/0
|
|
Description: SSH access
|
|
- IpProtocol: tcp
|
|
FromPort: 80
|
|
ToPort: 80
|
|
CidrIp: 0.0.0.0/0
|
|
Description: HTTP (redirect to HTTPS)
|
|
- IpProtocol: tcp
|
|
FromPort: 443
|
|
ToPort: 443
|
|
CidrIp: 0.0.0.0/0
|
|
Description: HTTPS
|
|
- IpProtocol: tcp
|
|
FromPort: 8080
|
|
ToPort: 8080
|
|
CidrIp: 0.0.0.0/0
|
|
Description: Frontend (direct, before proxy)
|
|
- IpProtocol: tcp
|
|
FromPort: 4000
|
|
ToPort: 4000
|
|
CidrIp: 0.0.0.0/0
|
|
Description: Backend API
|
|
SecurityGroupEgress:
|
|
- IpProtocol: -1
|
|
CidrIp: 0.0.0.0/0
|
|
Description: All outbound (SSH to managed hosts, Docker pulls, etc.)
|
|
Tags:
|
|
- Key: Name
|
|
Value: archnest-sg
|
|
|
|
# Elastic IP — stable public IP across stop/start
|
|
ArchNestEIP:
|
|
Type: AWS::EC2::EIP
|
|
Properties:
|
|
Domain: vpc
|
|
Tags:
|
|
- Key: Name
|
|
Value: archnest-eip
|
|
|
|
# EC2 Instance
|
|
ArchNestInstance:
|
|
Type: AWS::EC2::Instance
|
|
Properties:
|
|
InstanceType: !Ref InstanceType
|
|
KeyName: !Ref KeyPairName
|
|
ImageId: !FindInMap [RegionAMI, !Ref 'AWS::Region', AMI]
|
|
SecurityGroupIds:
|
|
- !Ref ArchNestSecurityGroup
|
|
BlockDeviceMappings:
|
|
- DeviceName: /dev/sda1
|
|
Ebs:
|
|
VolumeSize: !Ref VolumeSize
|
|
VolumeType: gp3
|
|
Encrypted: true
|
|
UserData:
|
|
Fn::Base64: |
|
|
#!/bin/bash
|
|
set -e
|
|
|
|
# Update system
|
|
apt-get update -y
|
|
apt-get upgrade -y
|
|
|
|
# Install Docker
|
|
apt-get install -y docker.io docker-compose-v2 git curl
|
|
systemctl enable --now docker
|
|
|
|
# Create deploy directory
|
|
mkdir -p /opt/archnest
|
|
chown ubuntu:ubuntu /opt/archnest
|
|
|
|
# Signal ready
|
|
echo "ArchNest instance ready" > /opt/archnest/READY
|
|
Tags:
|
|
- Key: Name
|
|
Value: archnest
|
|
|
|
# Associate Elastic IP with instance
|
|
ArchNestEIPAssociation:
|
|
Type: AWS::EC2::EIPAssociation
|
|
Properties:
|
|
InstanceId: !Ref ArchNestInstance
|
|
EIP: !Ref ArchNestEIP
|
|
|
|
# Budget alarm — $30/month ceiling
|
|
ArchNestBudget:
|
|
Type: AWS::Budgets::Budget
|
|
Properties:
|
|
Budget:
|
|
BudgetName: archnest-monthly
|
|
BudgetType: COST
|
|
TimeUnit: MONTHLY
|
|
BudgetLimit:
|
|
Amount: 30
|
|
Unit: USD
|
|
NotificationsWithSubscribers:
|
|
- Notification:
|
|
NotificationType: ACTUAL
|
|
ComparisonOperator: GREATER_THAN
|
|
Threshold: 80
|
|
Subscribers:
|
|
- SubscriptionType: EMAIL
|
|
Address: samueljamesinc@gmail.com
|
|
- Notification:
|
|
NotificationType: ACTUAL
|
|
ComparisonOperator: GREATER_THAN
|
|
Threshold: 100
|
|
Subscribers:
|
|
- SubscriptionType: EMAIL
|
|
Address: samueljamesinc@gmail.com
|
|
|
|
Mappings:
|
|
# Ubuntu 24.04 LTS ARM64 AMIs per region
|
|
RegionAMI:
|
|
us-east-1:
|
|
AMI: ami-0a7a4e87939439934
|
|
us-east-2:
|
|
AMI: ami-0ea3405d2d2522162
|
|
us-west-2:
|
|
AMI: ami-05d38da78ce859165
|
|
|
|
Outputs:
|
|
PublicIP:
|
|
Description: ArchNest public IP address
|
|
Value: !Ref ArchNestEIP
|
|
|
|
SSHCommand:
|
|
Description: SSH into the instance
|
|
Value: !Sub 'ssh -i ~/.ssh/kiro_ide_key ubuntu@${ArchNestEIP}'
|
|
|
|
InstanceId:
|
|
Description: EC2 Instance ID
|
|
Value: !Ref ArchNestInstance
|
|
|
|
EstimatedMonthlyCost:
|
|
Description: Estimated monthly cost
|
|
Value: '~$15/month (t4g.small + 30GB gp3 + Elastic IP)'
|