Navigazione docs

Plugin Model

Ogni servizio AWS è analizzato da uno scanner indipendente. Gli scanner implementano l’interfaccia WasteScannerPort definita nel domain layer. Il coordinatore (AnalyzeCloudWasteUseCase) è generico sugli scanner registrati — non sa nulla dei servizi specifici.

Interfaccia WasteScannerPort

Ogni scanner implementa questa porta:

interface WasteScannerPort {
  readonly resourceKind: ResourceKind;
  scan(params: ScanParams): Promise<WastedResource[]>;
}

Scanner esistenti

Scanner Servizio Condizione di spreco
EBS Volumes EC2/EBS Non attaccati (state: available)
EBS Volumes (idle) EC2/EBS Attaccati ma zero I/O in 14 giorni
EBS gp2→gp3 EC2/EBS Volume gp2 aggiornabile a gp3
Elastic IPs EC2 Non associati
EC2 Instances EC2 Ferme (EBS attaccati fatturati)
EC2 (underutilized) EC2 Running, CPU max ≤ 5% in 14 giorni
EBS Snapshots EC2/EBS Volume sorgente cancellato (orfani)
RDS Instances RDS Ferme (storage fatturato)
RDS (underutilized) RDS CPU max ≤ 5% in 14 giorni
Load Balancers ELBv2 Nessun target registrato
NAT Gateways VPC Zero traffico outbound in 14 giorni
CloudWatch Log Groups CloudWatch Nessuna retention policy
S3 Buckets S3 Nessuna lifecycle configuration
Lambda Functions Lambda Zero invocazioni in 7 giorni
EFS File Systems EFS Zero I/O in 14 giorni
DynamoDB Tables DynamoDB Provisioned, utilizzo < 10% in 7 giorni
ElastiCache, Redshift, OpenSearch, MSK, FSx, DocumentDB, Neptune, MQ, WorkSpaces, VPN, Transit Gateway, Kinesis Vari Idle (zero attività in 14 giorni)
SQS DLQ (abbandonate) SQS Messaggio più vecchio > 14 giorni
CloudWatch Log Groups (Lambda orfani) CloudWatch Funzione Lambda non più esistente
Aurora Serverless v2 RDS Min ACU sovradimensionato
SageMaker Notebooks/Endpoints/Models SageMaker Idle o orfani
Ambienti Dev/PR fantasma Multi-servizio Tutte le risorse inattive da 7+ giorni
EKS Node Groups / PVC orfani EKS Sovradimensionati o non attaccati
AMI (inutilizzate) EC2 Non referenziate da istanze o launch template
ECR Images (senza tag) ECR Immagine dangling in un repository
S3 Multipart upload (abbandonati) S3 Upload incompleto mai completato
RDS Snapshot manuali (vecchi) RDS Snapshot più vecchio del grace period
Secrets Manager (inutilizzati) Secrets Manager Non acceduti da 30+ giorni
CodePipeline (stagnanti) CodePipeline Nessuna esecuzione entro il grace period

Aggiungere un nuovo scanner

Guida step-by-step (dal README):

  1. Aggiungi il nuovo kind alla union type ResourceKind in wasted-resource.ts — il compilatore poi indica ogni punto da aggiornare
  2. Crea l’entità in libs/cloud-cost/domain/src/entities/ implementando WastedResource
  3. Crea la waste policy in libs/cloud-cost/domain/src/policies/ (grace period e ignore tag sono gratis dalla base class)
  4. Aggiungi la chiave prezzo a prices.json — PricingPort è un generico getPrice(region, key), nessuna interfaccia da toccare
  5. Implementa lo scanner in libs/cloud-cost/infrastructure/aws-adapter/src/scanners/ (implementa WasteScannerPort)
  6. Registra il presenter in apps/cli/src/formatters/resource-presenters.ts e lo scanner in analyze-waste.composition.ts

Nessuna modifica necessaria ad AnalyzeCloudWasteUseCase, WastedResourcesSummary, WasteReportDto, né ai formatter.

Il compilatore TypeScript guida l’intero processo: dopo aver aggiunto il kind alla union ResourceKind, pnpm nx run-many -t typecheck indica esattamente i punti da completare.