{"id":22854946,"url":"https://github.com/np-guard/cloud-resource-collector","last_synced_at":"2025-04-14T10:13:48.898Z","repository":{"id":171612345,"uuid":"620279084","full_name":"np-guard/cloud-resource-collector","owner":"np-guard","description":"Collects cloud resources in a given account. Supports multiple cloud providers.","archived":false,"fork":false,"pushed_at":"2025-04-08T00:24:15.000Z","size":456,"stargazers_count":2,"open_issues_count":14,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-14T10:13:37.928Z","etag":null,"topics":["firewall-configuration","network-configuration","routing-tables","vpc","vpc-resources"],"latest_commit_sha":null,"homepage":"https://pkg.go.dev/github.com/np-guard/cloud-resource-collector","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/np-guard.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-03-28T11:29:07.000Z","updated_at":"2025-03-13T07:32:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"f5614c82-d1ac-41d7-9ec0-00992c32a653","html_url":"https://github.com/np-guard/cloud-resource-collector","commit_stats":null,"previous_names":["np-guard/cloud-resource-collector"],"tags_count":23,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/np-guard%2Fcloud-resource-collector","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/np-guard%2Fcloud-resource-collector/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/np-guard%2Fcloud-resource-collector/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/np-guard%2Fcloud-resource-collector/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/np-guard","download_url":"https://codeload.github.com/np-guard/cloud-resource-collector/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248860167,"owners_count":21173342,"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":["firewall-configuration","network-configuration","routing-tables","vpc","vpc-resources"],"created_at":"2024-12-13T07:09:16.154Z","updated_at":"2025-04-14T10:13:48.871Z","avatar_url":"https://github.com/np-guard.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# cloud-resource-collector\r\nCollects cloud resources in a given account. Supports multiple cloud providers.\r\n\r\n## Prerequisites\r\n\r\n### Setup the AWS Collector\r\n\r\nThe AWS Collector requires you to provide credential information. You can do this either by setting up \r\na shared credential file or by setting environment variables.\r\n\r\nTo setup the credential file, simply create a text file with the following content (replacing the keys with your AWS keys)\r\n```ini\r\n[default]\r\naws_access_key_id = YOUR_AWS_ACCESS_KEY_ID\r\naws_secret_access_key = YOUR_AWS_SECRET_ACCESS_KEY\r\n```\r\nIf you are using Windows save the file under `C:\\Users\\\u003cyourUserName\u003e\\.aws\\credentials`.\r\nIf you are using Linux, MacOS, or Unix save the file under `~/.aws/credentials`\r\n\r\nAlternatively, you can set the following environment variables:\r\n```shell\r\nexport AWS_ACCESS_KEY_ID=YOUR_AWS_ACCESS_KEY_ID\r\nexport AWS_SECRET_ACCESS_KEY=YOUR_AWS_SECRET_ACCESS_KEY\r\n```\r\n\r\nNote: Pagination is not yet implemented, the collector will return only the first page of resources.\r\n\r\n### Setup the IBM Collector\r\n\r\nThe IBM collector requires an IBM API key to be supplied through the following environment variable:\r\n```shell\r\nexport IBMCLOUD_API_KEY=\u003cibm-cloud-api-key\u003e\r\n```\r\n\r\n## Usage\r\n\r\n### Collecting resources\r\n```\r\n./bin/collector collect --provider \u003cprovider\u003e [flags]\r\n\r\nFlags:\r\n  -h, --help                    help for collect\r\n      --out string              file path to store results\r\n  -r, --region stringArray      cloud region from which to collect resources\r\n      --resource-group string   resource group id or name from which to collect resources\r\n```\r\n\r\n* Value of `--provider` must be either `ibm` or `aws`\r\n* The `--region` argument can appear multiple times. If running with no `--region` arguments, resources from all (public) regions are collected.\r\n* If running with no `--resource-group` argument, resources from all resource groups are collected.\r\n\r\n### Listing available regions\r\n```\r\n./bin/collector get-regions --provider \u003cprovider\u003e\r\n```\r\n\r\n## Build the project\r\nRequires Go version 1.23 or later.\r\n```shell\r\ngit clone git@github.com:np-guard/cloud-resource-collector.git\r\ncd cloud-resource-collector\r\nmake build\r\n```\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnp-guard%2Fcloud-resource-collector","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnp-guard%2Fcloud-resource-collector","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnp-guard%2Fcloud-resource-collector/lists"}