This directory contains comprehensive documentation for the Lilith platform infrastructure.
Contents#
| Document | Description |
|---|---|
| AWS Setup | AWS account structure, IAM, cost management |
| Networking | VPC architecture, subnets, security groups |
| EKS | Kubernetes cluster configuration and management |
| Secrets Management | HashiCorp Vault and secrets handling |
Quick Links#
Deployment#
- Terraform Guide - Infrastructure as code
- Kubernetes Deployment - Full deployment guide
- Helm Charts - Application deployment
Operations#
- Scaling Runbook - Manual and auto-scaling
- Deployment Runbook - Deployment procedures
- Monitoring - Observability stack
Security#
- Access Control - RBAC and permissions
- Threat Model - Security analysis
- Audit Logging - Compliance logging
Architecture Overview#
text
┌─────────────────────────────────────────────────────────────────────────┐
│ AWS Cloud │
│ ┌───────────────────────────────────────────────────────────────────┐ │
│ │ VPC (10.0.0.0/16) │ │
│ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────┐ │ │
│ │ │ Public Sub │ │ Private Sub │ │ Database Sub │ │ │
│ │ │ (ALB, NAT) │ │ (EKS Nodes) │ │ (RDS, Redis) │ │ │
│ │ └──────────────┘ └──────────────┘ └──────────────┘ │ │
│ │ │ │ │
│ │ ┌────────────────────────▼────────────────────────────────────┐ │ │
│ │ │ EKS Cluster │ │ │
│ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │
│ │ │ │ BFF │ │ Auth │ │ Content │ │ AI │ │ │ │
│ │ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ │ │
│ │ │ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ │ │
│ │ │ │ Istio │ │ Vault │ │ ArgoCD │ │Prometheus│ │ │ │
│ │ │ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │ │ │
│ │ └──────────────────────────────────────────────────────────────┘ │ │
│ └───────────────────────────────────────────────────────────────────┘ │
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ Route53 │ │ S3 │ │ KMS │ │ CloudWatch │ │
│ │ (DNS) │ │ (Storage) │ │ (Encryption)│ │ (Monitoring)│ │
│ └─────────────┘ └─────────────┘ └─────────────┘ └─────────────┘ │
└─────────────────────────────────────────────────────────────────────────┘
Environment Matrix#
| Component | Development | Staging | Production |
|---|---|---|---|
| EKS Version | 1.28 | 1.28 | 1.28 |
| Node Count | 2-5 | 3-10 | 6-30 |
| RDS Instance | db.t3.micro | db.t3.small | db.r5.large |
| Redis | Single node | 3-node cluster | 6-node cluster |
| Multi-AZ | No | Yes | Yes |
| Backup Retention | 1 day | 7 days | 30 days |
Getting Started#
-
Set up AWS credentials
bashaws configure --profile lilith-dev -
Bootstrap Terraform state
bashcd deploy/terraform/backend-bootstrap terraform init && terraform apply -
Deploy infrastructure
bashcd deploy/terraform terraform init -backend-config=backend.hcl terraform plan -var-file=terraform.tfvars terraform apply -
Configure kubectl
bashaws eks update-kubeconfig --name lilith-dev --region us-east-1
Support#
For infrastructure issues:
- Slack: #platform-oncall
- Email: platform@lilith.app