https://github.com/byunjuneseok/cloud-map-py
AWS Cloud Infrastructure Visualizer - Discovers and visualizes AWS resources across multiple regions with PlantUML diagrams and PNG export.
https://github.com/byunjuneseok/cloud-map-py
aws infrastucture plantuml
Last synced: 29 days ago
JSON representation
AWS Cloud Infrastructure Visualizer - Discovers and visualizes AWS resources across multiple regions with PlantUML diagrams and PNG export.
- Host: GitHub
- URL: https://github.com/byunjuneseok/cloud-map-py
- Owner: byunjuneseok
- License: mit
- Created: 2025-07-26T10:46:06.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-07-28T13:32:56.000Z (11 months ago)
- Last Synced: 2025-08-10T21:28:57.370Z (11 months ago)
- Topics: aws, infrastucture, plantuml
- Language: Python
- Homepage:
- Size: 74.2 KB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# cloud-map-py
AWS Cloud Infrastructure Mapper - Visualize and analyze AWS cloud resources
## Installation
```bash
pip install cloud-map-py
```
## Usage
### Basic Usage
```bash
cloud-map --regions us-east-1 --presentation terminal
```
### PlantUML Diagram Generation
```bash
cloud-map --regions ap-northeast-2 --presentation plantuml --output infrastructure.puml
```
### Multiple Regions
```bash
cloud-map --regions us-east-1 us-west-2 eu-west-1 --presentation plantuml
```
When multiple regions are specified with PlantUML presentation, the tool automatically generates a single consolidated diagram showing all regions in one PNG image.
### Specific VPC Analysis
```bash
cloud-map --vpc-id vpc-12345678 --presentation plantuml
```
## Options
- `--regions`: AWS regions to scan (default: us-east-1)
- `--vpc-id`: Specific VPC ID to analyze (optional)
- `--presentation`: Output format - `terminal` or `plantuml` (default: terminal)
- `--output`: Output file path (optional, defaults to stdout)
## Requirements
- Python 3.12+
- AWS credentials configured (via AWS CLI, environment variables, or IAM roles)
- Appropriate AWS permissions for EC2, Lambda, Route53, API Gateway services
## Development
```bash
git clone https://github.com/your-username/cloud-map-py.git
cd cloud-map-py
uv install --dev
uv run cloud-map --help
```
## License
MIT