Aws Disco
@aaronge/aws-discov2026.08.21.5
01README
Region-wide AWS topology discovery and an animated D3 architecture diagram. Adds a fan-out discover method to the official @swamp/aws EC2, ECS and ELBv2 model types, then renders every compute object and every inbound and outbound network route into a single self-contained HTML file.
02Models
@aaronge/aws-architecture-diagramv2026.08.21.1aws/architecture_diagram.ts
Global Arguments
| Argument | Type | Description |
|---|---|---|
| region? | string | AWS region the diagram describes. Defaults to eu-west-2. |
| title? | string | Optional override for the diagram heading. |
| inlineD3? | boolean | Embed the D3 library in the HTML so the file works offline. Defaults to true. |
| d3Url? | string | |
| publishDir? | string | Directory, relative to the repo root, to publish the diagram into. Defaults to diagrams. |
| maxInventoryAgeMinutes? | number | How old an inventory may be before it counts as stale. Defaults to 360 (6 hours). |
fn render(region?: string)
Render the discovered inventories into an animated D3 architecture diagram
| Argument | Type | Description |
|---|---|---|
| region? | string | Override the region label and output filename. |
Resources
summary(infinite)— Counts and metadata describing the rendered diagram
Files
html(text/html)— Standalone animated D3 architecture diagram
03Workflows
@aaronge/aws-disco/diagramd2a79984-a0ce-4871-b65d-8588472a1b20
Inventory every compute and network object in an AWS region and render an animated D3 architecture diagram. Run weekly and share the HTML with the team. Pass --input region=<region> to target a region other than eu-west-2.
discoverInventory the region's network, compute, workloads and edge
1.networkaws-network.discover— VPCs, subnets, route tables, gateways, endpoints and filters
2.computeaws-compute.discover— EC2 instances, auto scaling groups and launch templates
3.workloadsaws-workloads.discover— ECS clusters and services, EKS clusters, Lambda functions
4.edgeaws-edge.discover— Load balancers, listeners and target groups
renderBuild the animated D3 topology diagram from the inventories
1.diagramaws-diagram.render— Render the standalone HTML diagram
2.verify— Fail the run if the diagram came out empty
3.freshness— Fail the run if any domain served stale data
04Previous Versions
2026.08.21.4
2026.08.21.3
2026.08.21.2
2026.08.21.1
2026.08.13.1
05Stats
A
100 / 100
Downloads
1
Archive size
1011.8 KB
- Has README or module doc2/2earned
- README has a code example1/1earned
- README is substantive1/1earned
- Most symbols documented1/1earned
- No slow types (deprecated)1/1earned
- Dependencies pass trust audit2/2earned
- Has description1/1earned
- Platform support declared (or universal)2/2earned
- License declared1/1earned
- Verified public repository2/2earned
06Platforms
07Labels