{"id":19368456,"url":"https://github.com/anchore/ecs-inventory","last_synced_at":"2025-08-22T08:09:57.017Z","repository":{"id":165591312,"uuid":"578325574","full_name":"anchore/ecs-inventory","owner":"anchore","description":"Anchore ECS Inventory can poll ECS Cluster API(s) to tell Anchore Enterprise which Containers and Images are currently in-use","archived":false,"fork":false,"pushed_at":"2025-08-08T15:23:01.000Z","size":639,"stargazers_count":6,"open_issues_count":2,"forks_count":5,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-08-08T16:32:04.600Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","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/anchore.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":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-12-14T19:39:28.000Z","updated_at":"2025-08-08T15:21:55.000Z","dependencies_parsed_at":null,"dependency_job_id":"fccd3789-832d-4de0-bd9a-395994446ef9","html_url":"https://github.com/anchore/ecs-inventory","commit_stats":null,"previous_names":[],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/anchore/ecs-inventory","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anchore%2Fecs-inventory","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anchore%2Fecs-inventory/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anchore%2Fecs-inventory/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anchore%2Fecs-inventory/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/anchore","download_url":"https://codeload.github.com/anchore/ecs-inventory/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/anchore%2Fecs-inventory/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271606595,"owners_count":24788979,"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","status":"online","status_checked_at":"2025-08-22T02:00:08.480Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":[],"created_at":"2024-11-10T08:06:28.351Z","updated_at":"2025-08-22T08:09:57.009Z","avatar_url":"https://github.com/anchore.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Anchore ECS Inventory\n\n\u003e **Note: this integration requires a valid license or subscription entitlement from Anchore**\n\n`anchore-ecs-inventory` is a tool to gather an inventory of images in use by\nAmazon Elastic Container Service (ECS).\n\n## Usage\n\n`anchore-ecs-inventory` is a command line tool. It can be run with the following\ncommand:\n\n```\n$ anchore-ecs-inventory can poll Amazon ECS (Elastic Container Service) APIs to tell Anchore which Images are currently in-use\n\nUsage:\n  anchore-ecs-inventory [flags]\n  anchore-ecs-inventory [command]\n\nAvailable Commands:\n  completion  Generate Completion script\n  help        Help about any command\n  version     show the version\n\nFlags:\n  -c, --config string                     application config file\n  -d, --dry-run                           do not report inventory to Anchore\n  -h, --help                              help for anchore-ecs-inventory\n  -p, --polling-interval-seconds string   this specifies the polling interval of the ECS API in seconds (default \"300\")\n  -q, --quiet                             suppresses inventory report output to stdout\n  -r, --region string                     if set overrides the AWS_REGION environment variable/region specified in anchore-ecs-inventory config\n  -v, --verbose count                     increase verbosity (-v = info, -vv = debug)\n\nUse \"anchore-ecs-inventory [command] --help\" for more information about a command. \n```\n\n## Configuration\n\n`anchore-ecs-inventory` needs to be configured with AWS credentials and Anchore\nECS Inventory configuration.\n\n### AWS Credentials\n\nAnchore ECS Inventory uses the AWS SDK for Go. The SDK will look for credentials\nin the following order:\n\n1. Environment variables\n2. Shared credentials file (~/.aws/credentials)\n   ```\n   [default]\n   aws_access_key_id = \u003cYOUR_ACCESS_KEY_ID\u003e\n   aws_secret_access_key = \u003cYOUR_SECRET_ACCESS_KEY\u003e\n   ```\n\n### Anchore ECS Inventory Configuration\n\nAnchore ECS Inventory can be configured with a configuration file. The default\nlocation the configuration file is looked for is\n`~/.anchore-ecs-inventory.yaml`. The configuration file can be overridden\nwith the `-c` flag.\n\n```yaml\nlog:\n  # level of logging that anchore-ecs-inventory will do  { 'error' | 'info' | 'debug }\n  level: \"info\"\n  \n  # location to write the log file (default is not to have a log file)\n  file: \"./anchore-ecs-inventory.log\"\n\nanchore:\n  # anchore enterprise api url  (e.g. http://localhost:8228)\n  url: $ANCHORE_ECS_INVENTORY_ANCHORE_URL\n  \n  # anchore enterprise username\n  user: $ANCHORE_ECS_INVENTORY_ANCHORE_USER \n  \n  # anchore enterprise password\n  password: ANCHORE_ECS_INVENTORY_ANCHORE_PASSWORD\n  \n  # anchore enterprise account that the inventory will be sent\n  account: $ANCHORE_ECS_INVENTORY_ANCHORE_ACCOUNT\n  \n  http:\n    insecure: true\n    timeout-seconds: 10\n\n# the aws region\nregion: $ANCHORE_ECS_INVENTORY_REGION\n\n# frequency of which to poll the region\npolling-interval-seconds: 300\n\nquiet: false\n```\n\nYou can also override any configuration value with environment variables. They\nmust be prefixed with `ANCHORE_ECS_INVENTORY_` and be in all caps. For example,\n`ANCHORE_ECS_INVENTORY_LOG_LEVEL=error` would override the `log.level`\nconfiguration\n\n## Releasing\nTo create a release of `anchore-ecs-inventory`, a tag needs to be created that points to a commit in `main`\nthat we want to release. This tag shall be a semver prefixed with a `v`, e.g. `v0.2.7`.\nOnce pushed to origin, this will trigger a GitHub Action that will create the release.\n\n```sh\ngit tag -s -a v0.2.7 -m \"v0.2.7\"\ngit push origin v0.2.7\n```\n\nAfter the release has been successfully created, make sure to specify the updated version\nin the `ecs-inventory` Helm Chart in [anchore-charts](https://github.com/anchore/anchore-charts). \nThe files to edit are `Chart.yaml` and `values.yaml`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanchore%2Fecs-inventory","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fanchore%2Fecs-inventory","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fanchore%2Fecs-inventory/lists"}