{"id":15322782,"url":"https://github.com/msfidelis/cloud-inventory","last_synced_at":"2025-04-14T23:34:18.564Z","repository":{"id":55084524,"uuid":"323729276","full_name":"msfidelis/cloud-inventory","owner":"msfidelis","description":":cloud: :cloud: :cloud: Simple tool to search tagged resources between all AWS resouces","archived":false,"fork":false,"pushed_at":"2021-06-28T14:16:14.000Z","size":49,"stargazers_count":16,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-28T11:39:34.047Z","etag":null,"topics":["aws","cloud","cloud-inventory","golang","tags"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/msfidelis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-12-22T20:45:04.000Z","updated_at":"2022-01-26T10:41:51.000Z","dependencies_parsed_at":"2022-08-14T11:31:04.086Z","dependency_job_id":null,"html_url":"https://github.com/msfidelis/cloud-inventory","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msfidelis%2Fcloud-inventory","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msfidelis%2Fcloud-inventory/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msfidelis%2Fcloud-inventory/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/msfidelis%2Fcloud-inventory/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/msfidelis","download_url":"https://codeload.github.com/msfidelis/cloud-inventory/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248980251,"owners_count":21193131,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["aws","cloud","cloud-inventory","golang","tags"],"created_at":"2024-10-01T09:17:58.016Z","updated_at":"2025-04-14T23:34:18.533Z","avatar_url":"https://github.com/msfidelis.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003ch1 align=\"left\"\u003eWelcome to Cloud Inventory Tags šŸ‘‹\u003c/h1\u003e\n\u003cp\u003e\n \u003cimg alt=\"Version\" src=\"https://img.shields.io/badge/version-v0.0.6-blue.svg?cacheSeconds=2592000\" /\u003e\n \u003ca href=\"LICENSE \" target=\"_blank\"\u003e\n \u003cimg alt=\"License: MIT\" src=\"https://img.shields.io/badge/License-MIT-yellow.svg\" /\u003e\n \u003c/a\u003e\n \u003ca href=\"https://twitter.com/fidelissauro\" target=\"_blank\"\u003e\n \u003cimg alt=\"Twitter: fidelissauro\" src=\"https://img.shields.io/twitter/follow/fidelissauro.svg?style=social\" /\u003e\n \u003c/a\u003e\n \u003ca href=\"/\" target=\"_blank\"\u003e\n \u003cimg alt=\"Build CI\" src=\"https://github.com/msfidelis/cloud-inventory/workflows/cloud-inventory%20ci/badge.svg\" /\u003e\n \u003c/a\u003e \n \u003ca href=\"/\" target=\"_blank\"\u003e\n \u003cimg alt=\"Release\" src=\"https://github.com/msfidelis/cloud-inventory/workflows/release%20packages/badge.svg\" /\u003e\n \u003c/a\u003e\n\u003c/p\u003e\n\n\u003e Simple tool to search tagged resources around all AWS Account\n\n## Installation\n\n### MacOS / OSX\n\n```bash\nwget https://github.com/msfidelis/cloud-inventory/releases/download/v0.0.6/cloud-inventory_0.0.6_darwin_amd64 -O /usr/local/bin/cloud-inventory\nchmod +x /usr/local/bin/cloud-inventory\n```\n\n### Linux \n\n```bash\nwget https://github.com/msfidelis/cloud-inventory/releases/download/v0.0.6/cloud-inventory_0.0.6_linux_amd64 -O /usr/local/bin/cloud-inventory\nchmod +x /usr/local/bin/cloud-inventory\n```\n\n## Usage\n\n```sh\ncloud-inventory -h\n\nUsage of cloud-inventory:\n -grep string\n \tString pattern to search on Tag:Name and ARN resource\n -output string\n \tOutput report type; ex: default, arn, csv (default \"default\")\n -region string\n \tRegion to search inventory; default: us-east-1 (default \"us-east-1\")\n -resource string\n \tOptional resource type; ex: ec2, s3, acm\n -tag-name string\n \tTag to search\n -tag-value string\n \tTag to search\n```\n\n## Searching for a tag\n\n```sh\ncloud-inventory --tag-name Project --tag-value k8s-with-cri-o\n\nSearching for resources using Tag Project:k8s-with-cri-o\n\nTag:Name ARN Region Service\nk8s-node-2 arn:aws:ec2:us-east-1:181560427716:instance/i-00329399f9be9057d us-east-1 ec2\nk8s-master arn:aws:ec2:us-east-1:181560427716:instance/i-09f69d92ae78e38a3 us-east-1 ec2\n- arn:aws:ec2:us-east-1:181560427716:key-pair/key-0e42ce8f71614c2b0 us-east-1 ec2\nk8s-with-cri-o-kubernetes-sg arn:aws:ec2:us-east-1:181560427716:security-group/sg-00cf6191cf7ab9fd5 us-east-1 ec2\nk8s-with-cri-o-public-us-east-1b arn:aws:ec2:us-east-1:181560427716:subnet/subnet-00e56eae76e947407 us-east-1 ec2\nk8s-node-0 arn:aws:ec2:us-east-1:181560427716:instance/i-0a896967635519624 us-east-1 ec2\nk8s-node-1 arn:aws:ec2:us-east-1:181560427716:instance/i-0dcb632206b511ab1 us-east-1 ec2\nk8s-node-3 arn:aws:ec2:us-east-1:181560427716:instance/i-0acb760119048a1b8 us-east-1 ec2\nk8s-with-cri-o-public-us-east-1a arn:aws:ec2:us-east-1:181560427716:subnet/subnet-0d4a1826dc74940af us-east-1 ec2\nk8s-with-cri-o-vpc arn:aws:ec2:us-east-1:181560427716:vpc/vpc-0811ba78ad39174e2 us-east-1 ec2\n\nFound 10 resources\n```\n\n\n## Searching for a tag on a specific AWS service\n\n```sh\ncloud-inventory --tag-name Project --tag-value k8s-with-cri-o --resource ec2\n\nSearching for resources using Tag Project:k8s-with-cri-o\n\nTag:Name ARN Region Service\nk8s-node-1 arn:aws:ec2:us-east-1:181560427716:instance/i-0dcb632206b511ab1 us-east-1 ec2\nk8s-node-3 arn:aws:ec2:us-east-1:181560427716:instance/i-0acb760119048a1b8 us-east-1 ec2\nk8s-master arn:aws:ec2:us-east-1:181560427716:instance/i-09f69d92ae78e38a3 us-east-1 ec2\nk8s-with-cri-o-public-us-east-1a arn:aws:ec2:us-east-1:181560427716:subnet/subnet-0d4a1826dc74940af us-east-1 ec2\nk8s-node-0 arn:aws:ec2:us-east-1:181560427716:instance/i-0a896967635519624 us-east-1 ec2\n- arn:aws:ec2:us-east-1:181560427716:key-pair/key-0e42ce8f71614c2b0 us-east-1 ec2\nk8s-with-cri-o-kubernetes-sg arn:aws:ec2:us-east-1:181560427716:security-group/sg-00cf6191cf7ab9fd5 us-east-1 ec2\nk8s-with-cri-o-public-us-east-1b arn:aws:ec2:us-east-1:181560427716:subnet/subnet-00e56eae76e947407 us-east-1 ec2\nk8s-with-cri-o-vpc arn:aws:ec2:us-east-1:181560427716:vpc/vpc-0811ba78ad39174e2 us-east-1 ec2\nk8s-node-2 arn:aws:ec2:us-east-1:181560427716:instance/i-00329399f9be9057d us-east-1 ec2\n\nFound 10 resources\n```\n\n## Resource Filters\n\n```sh\ncloud-inventory --tag-name Project --tag-value k8s-with-cri-o --resource ec2:instance\n\nSearching for resources using Tag Project:k8s-with-cri-o\n\nTag:Name ARN Region Service\nk8s-node-0 arn:aws:ec2:us-east-1:181560427716:instance/i-0a896967635519624 us-east-1 ec2\nk8s-node-1 arn:aws:ec2:us-east-1:181560427716:instance/i-0dcb632206b511ab1 us-east-1 ec2\nk8s-node-2 arn:aws:ec2:us-east-1:181560427716:instance/i-00329399f9be9057d us-east-1 ec2\nk8s-node-3 arn:aws:ec2:us-east-1:181560427716:instance/i-0acb760119048a1b8 us-east-1 ec2\nk8s-master arn:aws:ec2:us-east-1:181560427716:instance/i-09f69d92ae78e38a3 us-east-1 ec2\n\nFound 5 resources\n```\n\n```sh\ncloud-inventory --tag-name Project --tag-value k8s-with-cri-o --resource ec2:vpc\n\nSearching for resources using Tag Project:k8s-with-cri-o\n\nTag:Name ARN Region Service\nk8s-with-cri-o-vpc arn:aws:ec2:us-east-1:181560427716:vpc/vpc-0811ba78ad39174e2 us-east-1 ec2\n\nFound 1 resources\n```\n\n## Grepping Resources Patterns\n\nParameter `--grep` can filter `ARN` and `Tag:Name` string patter \n\n```sh \ncloud-inventory --tag-name Project --tag-value k8s-with-cri-o --grep \"k8s-node\"\n\nSearching for resources using Tag Project:k8s-with-cri-o\n\nGrepping by k8s-node pattern on resources\n\nTag:Name ARN Region Service\nk8s-node-3 arn:aws:ec2:us-east-1:181560427716:instance/i-03ac47564b5cd5305 us-east-1 ec2\nk8s-node-2 arn:aws:ec2:us-east-1:181560427716:instance/i-0e8d6b9c80bba16c4 us-east-1 ec2\nk8s-node-1 arn:aws:ec2:us-east-1:181560427716:instance/i-0b18f56848fc957b7 us-east-1 ec2\nk8s-node-0 arn:aws:ec2:us-east-1:181560427716:instance/i-06cb80dd7b8d2c7a3 us-east-1 ec2\n\nFound 4 resources\n```\n\n```sh\ncloud-inventory --tag-name Project --tag-value k8s-with-cri-o --grep \"k8s-with-*\"\n\nSearching for resources using Tag Project:k8s-with-cri-o\n\nGrepping by k8s-with-* pattern on resources\n\nTag:Name ARN Region Service\nk8s-with-cri-o-vpc arn:aws:ec2:us-east-1:181560427716:vpc/vpc-0b1aec96130d6a672 us-east-1 ec2\nk8s-with-cri-o-kubernetes-sg arn:aws:ec2:us-east-1:181560427716:security-group/sg-0fdd9aac57dc3b190 us-east-1 ec2\nk8s-with-cri-o-public-us-east-1a arn:aws:ec2:us-east-1:181560427716:subnet/subnet-0a750924d23dbc6b0 us-east-1 ec2\nk8s-with-cri-o-public-us-east-1b arn:aws:ec2:us-east-1:181560427716:subnet/subnet-0f11a62247f22d2db us-east-1 ec2\nk8s-with-cri-o-kubernetes-sg arn:aws:ec2:us-east-1:181560427716:security-group/sg-061c28ddc1ae6144a us-east-1 ec2\n\nFound 5 resources\n```\n\n## Customize output format \n\n```sh\ncloud-inventory --tag-name Project --tag-value CarsAndBus --resource rds --output csv\n\nSearching for resources using Tag Project:CarsAndBus\n\nFound 6 resources\n\nOutput file: results.csv\n```\n\n## Docker usage\n\n```sh\ndocker run -it fidelissauro/cloud-inventory:latest --tag-name Project --tag-value CarsAndBus\n```\n\n## Run linter\n\n```sh\ngolint -set_exit_status\n```\n\n## Run tests\n\n```sh\ngo test -v \n```\n\n## Author\n\nšŸ‘¤ **Matheus Fidelis**\n\n* Website: https://raj.ninja\n* Twitter: [@fidelissauro](https://twitter.com/fidelissauro)\n* Github: [@msfidelis](https://github.com/msfidelis)\n* LinkedIn: [@msfidelis](https://linkedin.com/in/msfidelis)\n\n## šŸ¤ Contributing\n\nContributions, issues and feature requests are welcome!\u003cbr /\u003eFeel free to check [issues page](/issues). \n\n## Show your support\n\nGive a ā­ļø if this project helped you!\n\n## šŸ“ License\n\nCopyright Ā© 2020 [Matheus Fidelis](https://github.com/msfidelis).\u003cbr /\u003e\nThis project is [MIT](LICENSE ) licensed.\n\n***\n_This README was generated with ā¤ļø by [readme-md-generator](https://github.com/kefranabg/readme-md-generator)_\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmsfidelis%2Fcloud-inventory","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmsfidelis%2Fcloud-inventory","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmsfidelis%2Fcloud-inventory/lists"}