How xuanmai1812/netfabric works
NetFabric is an AWS networking lab whose main workflow is to provision two regional VPCs, manually configure a WireGuard link through SSM, and run cross-network connectivity and throughput checks. The graph includes the documented infrastructure modules and testing/reporting branches; Terraform module wiring and the throughput implementation were not sampled, so those links are shown only where the README supports them.
Main entry points: hub/main.tf Hub environment · spoke/main.tf Spoke environment · nat-instance/main.tf NAT instances · nat-instance WireGuard tunnel
Components 16
Network infrastructure
- Hub environment
terraform/envs/hub/main.tf - Spoke environment
terraform/envs/spoke/main.tf - VPC networking
terraform/modules/vpc/main.tf - Test hosts
terraform/modules/test-host/main.tf
Tunnel and access
- SSM IAM role
terraform/modules/iam/main.tf - NAT instances
terraform/modules/nat-instance/main.tf - NAT boot setup
terraform/modules/nat-instance/user-data.sh - AWS Systems Manager
- WireGuard tunnel
terraform/modules/nat-instance
Network validation
- Target generation
tools/get_targets.py - Target inventory
tools/get_targets.py - Connectivity checks
tools/connectivity_matrix.py - Throughput checks
tools/throughput_test.py - Connectivity report
reports/connectivity_matrix.json - Throughput report
reports/throughput.json
Other components
- Engineer
Connections 25
- Engineer → Hub environment: applies Terraform
README.md - Engineer → Spoke environment: applies Terraform
README.md - Hub environment → VPC networking: provisions network
- Spoke environment → VPC networking: provisions network
- Hub environment → NAT instances: provisions instance
- Spoke environment → NAT instances: provisions instance
- Hub environment → Test hosts: provisions host
- Spoke environment → Test hosts: provisions host
- Hub environment → SSM IAM role: assigns SSM role
- Spoke environment → SSM IAM role: assigns SSM role
- NAT instances → NAT boot setup: runs at boot
- Engineer → AWS Systems Manager: starts sessions
README.md - AWS Systems Manager → NAT instances: administers instances
README.md - Engineer → WireGuard tunnel: configures manually
README.md - NAT instances → WireGuard tunnel: hosts endpoint
README.md - Hub environment → Target generation: provides outputs
README.md - Spoke environment → Target generation: provides outputs
README.md - Target generation → Target inventory: writes inventory
tools/get_targets.py - Target inventory → Connectivity checks: supplies test targets
tools/connectivity_matrix.py - Connectivity checks → AWS Systems Manager: runs remote checks
tools/connectivity_matrix.py - Connectivity checks → Connectivity report: writes results
README.md - Throughput checks → AWS Systems Manager: runs remote test
README.md - Throughput checks → Throughput report: writes results
README.md - Hub environment → WireGuard tunnel: routes tunnel traffic
README.md - Spoke environment → WireGuard tunnel: routes tunnel traffic
README.md