Welcome to Cloud Inventory Tags 👋

Simple tool to search tagged resources around all AWS Account

Installation

MacOS / OSX

wget https://github.com/msfidelis/cloud-inventory/releases/download/v0.0.6/cloud-inventory_0.0.6_darwin_amd64 -O /usr/local/bin/cloud-inventory
chmod +x /usr/local/bin/cloud-inventory

Linux

wget https://github.com/msfidelis/cloud-inventory/releases/download/v0.0.6/cloud-inventory_0.0.6_linux_amd64 -O /usr/local/bin/cloud-inventory
chmod +x /usr/local/bin/cloud-inventory

Usage

cloud-inventory -h

Usage of cloud-inventory:
  -grep string
    	String pattern to search on Tag:Name and ARN resource
  -output string
    	Output report type; ex: default, arn, csv (default "default")
  -region string
    	Region to search inventory; default: us-east-1 (default "us-east-1")
  -resource string
    	Optional resource type; ex: ec2, s3, acm
  -tag-name string
    	Tag to search
  -tag-value string
    	Tag to search

Searching for a tag

cloud-inventory --tag-name Project --tag-value k8s-with-cri-o

Searching for resources using Tag Project:k8s-with-cri-o

Tag:Name                          ARN                                                                     Region     Service
k8s-node-2                        arn:aws:ec2:us-east-1:181560427716:instance/i-00329399f9be9057d         us-east-1  ec2
k8s-master                        arn:aws:ec2:us-east-1:181560427716:instance/i-09f69d92ae78e38a3         us-east-1  ec2
-                                 arn:aws:ec2:us-east-1:181560427716:key-pair/key-0e42ce8f71614c2b0       us-east-1  ec2
k8s-with-cri-o-kubernetes-sg      arn:aws:ec2:us-east-1:181560427716:security-group/sg-00cf6191cf7ab9fd5  us-east-1  ec2
k8s-with-cri-o-public-us-east-1b  arn:aws:ec2:us-east-1:181560427716:subnet/subnet-00e56eae76e947407      us-east-1  ec2
k8s-node-0                        arn:aws:ec2:us-east-1:181560427716:instance/i-0a896967635519624         us-east-1  ec2
k8s-node-1                        arn:aws:ec2:us-east-1:181560427716:instance/i-0dcb632206b511ab1         us-east-1  ec2
k8s-node-3                        arn:aws:ec2:us-east-1:181560427716:instance/i-0acb760119048a1b8         us-east-1  ec2
k8s-with-cri-o-public-us-east-1a  arn:aws:ec2:us-east-1:181560427716:subnet/subnet-0d4a1826dc74940af      us-east-1  ec2
k8s-with-cri-o-vpc                arn:aws:ec2:us-east-1:181560427716:vpc/vpc-0811ba78ad39174e2            us-east-1  ec2

Found 10 resources

Searching for a tag on a specific AWS service

cloud-inventory --tag-name Project --tag-value k8s-with-cri-o --resource ec2

Searching for resources using Tag Project:k8s-with-cri-o

Tag:Name                          ARN                                                                     Region     Service
k8s-node-1                        arn:aws:ec2:us-east-1:181560427716:instance/i-0dcb632206b511ab1         us-east-1  ec2
k8s-node-3                        arn:aws:ec2:us-east-1:181560427716:instance/i-0acb760119048a1b8         us-east-1  ec2
k8s-master                        arn:aws:ec2:us-east-1:181560427716:instance/i-09f69d92ae78e38a3         us-east-1  ec2
k8s-with-cri-o-public-us-east-1a  arn:aws:ec2:us-east-1:181560427716:subnet/subnet-0d4a1826dc74940af      us-east-1  ec2
k8s-node-0                        arn:aws:ec2:us-east-1:181560427716:instance/i-0a896967635519624         us-east-1  ec2
-                                 arn:aws:ec2:us-east-1:181560427716:key-pair/key-0e42ce8f71614c2b0       us-east-1  ec2
k8s-with-cri-o-kubernetes-sg      arn:aws:ec2:us-east-1:181560427716:security-group/sg-00cf6191cf7ab9fd5  us-east-1  ec2
k8s-with-cri-o-public-us-east-1b  arn:aws:ec2:us-east-1:181560427716:subnet/subnet-00e56eae76e947407      us-east-1  ec2
k8s-with-cri-o-vpc                arn:aws:ec2:us-east-1:181560427716:vpc/vpc-0811ba78ad39174e2            us-east-1  ec2
k8s-node-2                        arn:aws:ec2:us-east-1:181560427716:instance/i-00329399f9be9057d         us-east-1  ec2

Found 10 resources

Resource Filters

cloud-inventory --tag-name Project --tag-value k8s-with-cri-o --resource ec2:instance

Searching for resources using Tag Project:k8s-with-cri-o

Tag:Name    ARN                                                              Region     Service
k8s-node-0  arn:aws:ec2:us-east-1:181560427716:instance/i-0a896967635519624  us-east-1  ec2
k8s-node-1  arn:aws:ec2:us-east-1:181560427716:instance/i-0dcb632206b511ab1  us-east-1  ec2
k8s-node-2  arn:aws:ec2:us-east-1:181560427716:instance/i-00329399f9be9057d  us-east-1  ec2
k8s-node-3  arn:aws:ec2:us-east-1:181560427716:instance/i-0acb760119048a1b8  us-east-1  ec2
k8s-master  arn:aws:ec2:us-east-1:181560427716:instance/i-09f69d92ae78e38a3  us-east-1  ec2

Found 5 resources

cloud-inventory --tag-name Project --tag-value k8s-with-cri-o --resource ec2:vpc

Searching for resources using Tag Project:k8s-with-cri-o

Tag:Name            ARN                                                           Region     Service
k8s-with-cri-o-vpc  arn:aws:ec2:us-east-1:181560427716:vpc/vpc-0811ba78ad39174e2  us-east-1  ec2

Found 1 resources

Grepping Resources Patterns

Parameter --grep can filter ARN and Tag:Name string patter

cloud-inventory --tag-name Project --tag-value k8s-with-cri-o --grep "k8s-node"

Searching for resources using Tag Project:k8s-with-cri-o

Grepping by k8s-node pattern on resources

Tag:Name    ARN                                                              Region     Service
k8s-node-3  arn:aws:ec2:us-east-1:181560427716:instance/i-03ac47564b5cd5305  us-east-1  ec2
k8s-node-2  arn:aws:ec2:us-east-1:181560427716:instance/i-0e8d6b9c80bba16c4  us-east-1  ec2
k8s-node-1  arn:aws:ec2:us-east-1:181560427716:instance/i-0b18f56848fc957b7  us-east-1  ec2
k8s-node-0  arn:aws:ec2:us-east-1:181560427716:instance/i-06cb80dd7b8d2c7a3  us-east-1  ec2

Found 4 resources

cloud-inventory --tag-name Project --tag-value k8s-with-cri-o --grep "k8s-with-*"

Searching for resources using Tag Project:k8s-with-cri-o

Grepping by k8s-with-* pattern on resources

Tag:Name                          ARN                                                                     Region     Service
k8s-with-cri-o-vpc                arn:aws:ec2:us-east-1:181560427716:vpc/vpc-0b1aec96130d6a672            us-east-1  ec2
k8s-with-cri-o-kubernetes-sg      arn:aws:ec2:us-east-1:181560427716:security-group/sg-0fdd9aac57dc3b190  us-east-1  ec2
k8s-with-cri-o-public-us-east-1a  arn:aws:ec2:us-east-1:181560427716:subnet/subnet-0a750924d23dbc6b0      us-east-1  ec2
k8s-with-cri-o-public-us-east-1b  arn:aws:ec2:us-east-1:181560427716:subnet/subnet-0f11a62247f22d2db      us-east-1  ec2
k8s-with-cri-o-kubernetes-sg      arn:aws:ec2:us-east-1:181560427716:security-group/sg-061c28ddc1ae6144a  us-east-1  ec2

Found 5 resources

Customize output format

cloud-inventory --tag-name Project --tag-value CarsAndBus --resource rds --output csv

Searching for resources using Tag Project:CarsAndBus

Found 6 resources

Output file: results.csv

Docker usage

docker run -it fidelissauro/cloud-inventory:latest --tag-name Project --tag-value CarsAndBus

Run linter

golint -set_exit_status

Run tests

go test -v 

Author

👤 Matheus Fidelis

• Website: https://raj.ninja
• Twitter: @fidelissauro
• Github: @msfidelis
• LinkedIn: @msfidelis

🤝 Contributing

Contributions, issues and feature requests are welcome!
Feel free to check issues page.

Show your support

Give a ⭐️ if this project helped you!

📝 License

Copyright © 2020 Matheus Fidelis.
This project is MIT licensed.

---

This README was generated with ❤️ by readme-md-generator