aws-discover

AWS Infrastructure Discovery

Explore an AWS account and collect comprehensive information about its infrastructure.

Before Starting

Ask the user for:

1. AWS Profile - Which AWS profile to use (or use default)
2. AWS Region - Which region to scan (or use default)

AWS CLI Configuration

Use the profile and region flags with all AWS CLI commands:

aws <command> --profile <profile> --region <region>

Discovery Process

Explore systematically. Start with basics, then dig deeper based on what you find.

1. Account Identity

aws sts get-caller-identity --profile <profile> --region <region>

2. Networking

• VPCs: aws ec2 describe-vpcs
• Subnets: aws ec2 describe-subnets
• Internet Gateways: aws ec2 describe-internet-gateways
• NAT Gateways: aws ec2 describe-nat-gateways
• Transit Gateways: aws ec2 describe-transit-gateways
• VPC Endpoints: aws ec2 describe-vpc-endpoints
• Route Tables: aws ec2 describe-route-tables

3. Compute

• ECS Clusters: aws ecs list-clusters then aws ecs describe-clusters
• ECS Services: aws ecs list-services --cluster <name> then aws ecs describe-services
• Lambda: aws lambda list-functions
• EC2: aws ec2 describe-instances
• EKS: aws eks list-clusters

4. Load Balancing

• ALB/NLB: aws elbv2 describe-load-balancers
• Listeners: aws elbv2 describe-listeners --load-balancer-arn <arn>
• Target Groups: aws elbv2 describe-target-groups
• Rules: aws elbv2 describe-rules --listener-arn <arn>

5. Databases

• RDS: aws rds describe-db-instances
• Aurora: aws rds describe-db-clusters
• DynamoDB: aws dynamodb list-tables
• ElastiCache: aws elasticache describe-cache-clusters

6. Storage

• S3: aws s3api list-buckets
• EFS: aws efs describe-file-systems
• ECR: aws ecr describe-repositories

7. Security

• Security Groups: aws ec2 describe-security-groups
• WAF: aws wafv2 list-web-acls --scope REGIONAL
• Cognito: aws cognito-idp list-user-pools --max-results 20
• ACM: aws acm list-certificates
• Secrets Manager: aws secretsmanager list-secrets
• KMS: aws kms list-keys

8. Messaging

• SQS: aws sqs list-queues
• SNS: aws sns list-topics
• EventBridge: aws events list-rules

9. API & CDN

• API Gateway: aws apigateway get-rest-apis
• CloudFront: aws cloudfront list-distributions

Output Format

Create aws_infrastructure.json with this structure:

{
  "metadata": {
    "account_id": "...",
    "region": "...",
    "environment": "...",
    "project": "...",
    "discovered_at": "..."
  },
  "networking": {
    "vpc": {"id": "...", "name": "...", "cidr": "..."},
    "subnets": {
      "public": [{"id": "...", "name": "...", "cidr": "...", "az": "..."}],
      "private": [{"id": "...", "name": "...", "cidr": "...", "az": "..."}]
    },
    "internet_gateway": {"id": "..."},
    "nat_gateways": [...],
    "transit_gateway": {"id": "...", "routes": [...]},
    "vpc_endpoints": [{"id": "...", "type": "...", "service": "..."}]
  },
  "load_balancers": {
    "public": {"name": "...", "scheme": "internet-facing", "dns_name": "..."},
    "private": {"name": "...", "scheme": "internal"}
  },
  "compute": {
    "ecs_cluster": {"name": "..."},
    "ecs_services": [{"name": "...", "launch_type": "FARGATE"}],
    "lambda_functions": [{"name": "...", "runtime": "..."}],
    "ec2_instances": [...]
  },
  "databases": {
    "aurora_clusters": [{"database_name": "...", "engine": "..."}],
    "dynamodb_tables": [{"name": "..."}],
    "elasticache": {"engine": "redis", "num_cache_clusters": 2}
  },
  "storage": {
    "s3_buckets": [{"name": "..."}],
    "ecr_repositories": [...]
  },
  "security": {
    "waf": {"web_acl": {"name": "..."}},
    "acm_certificates": [{"domain": "..."}],
    "cognito_pools": [{"name": "..."}]
  },
  "messaging": {
    "sqs_queues": [...],
    "sns_topics": [...],
    "eventbridge_rules": [...]
  },
  "traffic_rules": {
    "allowed_sources": {
      "public_internet": {"cidrs": ["0.0.0.0/0"], "ports": [443]},
      "corporate": {"cidrs": ["10.0.0.0/8"], "ports": [80, 443]}
    },
    "domains": {
      "public": ["api.example.com"],
      "private": ["internal.example.com"]
    }
  }
}

Guidelines

• Only include sections that have resources (omit empty sections)
• Infer environment and project from resource names/tags
• Infer traffic rules from security group ingress rules and load balancer configurations
• For subnets, use "az" field (not "availability_zone")
• Skip empty services quickly - if list-* returns empty, move on
• Add new sections for services not listed (e.g., "step_functions", "glue", "opensearch")

After Discovery

Tell the user:

1. What was discovered (summary of resources)
2. That they can now generate diagrams with: "generate AWS diagram"