{"id":20238922,"url":"https://github.com/quintilesims/go-ecs-cleaner","last_synced_at":"2025-09-06T19:42:14.184Z","repository":{"id":64305173,"uuid":"221568047","full_name":"quintilesims/go-ecs-cleaner","owner":"quintilesims","description":"A Go tool for cleaning up ECS resources in an AWS account.","archived":false,"fork":false,"pushed_at":"2023-03-30T03:54:31.000Z","size":487,"stargazers_count":2,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-24T17:14:12.534Z","etag":null,"topics":["cli","ecs","go","golang"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/quintilesims.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":"2019-11-13T23:03:47.000Z","updated_at":"2019-12-09T19:52:19.000Z","dependencies_parsed_at":"2024-06-20T07:12:35.095Z","dependency_job_id":"0f8bcf39-5cdf-4ec7-a419-a66bc973cbff","html_url":"https://github.com/quintilesims/go-ecs-cleaner","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quintilesims%2Fgo-ecs-cleaner","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quintilesims%2Fgo-ecs-cleaner/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quintilesims%2Fgo-ecs-cleaner/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quintilesims%2Fgo-ecs-cleaner/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/quintilesims","download_url":"https://codeload.github.com/quintilesims/go-ecs-cleaner/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248281414,"owners_count":21077423,"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":["cli","ecs","go","golang"],"created_at":"2024-11-14T08:36:08.965Z","updated_at":"2025-04-10T19:36:04.737Z","avatar_url":"https://github.com/quintilesims.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# go-ecs-cleaner\n\nA Go tool for cleaning up ECS resources in your AWS account.\nCLI built using the [`cobra`](https://github.com/spf13/cobra) library.\n\n## Installation\n\nDownload a binary appropriate for your OS from the [releases](https://github.com/quintilesims/go-ecs-cleaner/releases).\n\nTo build from source yourself, clone the repo, then build and use a binary, or run `main.go` directly:\n\n- `go build \u0026\u0026 ./go-ecs-cleaner ecs-task`\n- `go run main.go ecs-task`\n\n## Usage\n\nThe `go-ecs-cleaner` tool takes AWS configuration parameters from these environment variables:\n\n- AWS_ACCESS_KEY\n- AWS_SECRET_ACCESS_KEY\n- AWS_REGION\n\nUse the `-h, --help` flag to learn more about the tool's abilities.\n\n## Docker\n\nThis repo publishes an image to DockerHub at [`quintilesims/go-ecs-cleaner`](https://hub.docker.com/r/quintilesims/go-ecs-cleaner), so you could pull it from there as well.\nRunning this image runs the tool's `ecs-task` command.\n\nThe Docker container takes its parameters as environment variables - yes, even the flags.\nHere's an example:\n\n```\ndocker run \\\n    -e FLAGS=\"-d -a\" \\\n    -e AWS_REGION=\"us-west-2\" \\\n    -e AWS_ACCESS_KEY=\"REDACTED\" \\\n    -e AWS_SECRET_ACCESS_KEY=\"REDACTED\" \\\n    go-ecs-cleaner:latest\n```\n\n## Helm\n\nThis repo contains a Helm chart that will deploy the `go-ecs-cleaner` tool into a Kubernetes cluster and run its `ecs-task` command.\nThe chart depends on configuration from two sources: secrets and user-specified values.\n\n### Secrets\n\nAWS Connection information is read from `AWS_ACCESS_KEY_ID` and `AWS_SECRET_ACCESS_KEY` keys stored in a Kubernetes secret.\nBefore you can install this chart, you must create this secret and populate it.\nYou can do so with `kubectl`:\n\n```\nkubectl create secret generic ecs-task-cleaner-secrets \\\n    --from-literal AWS_ACCESS_KEY_ID=your_value_here \\\n    --from-literal AWS_SECRET_ACCESS_KEY=your_value_here\n```\n\nIf you would like to name your secret something other than `ecs-task-cleaner-secrets` you may do so as long as you provide the name of your custom secret when you install the Helm chart.\n\n### User-Defined Values\n\n`AWS_REGION` and `FLAGS` should be specified in the `values.yaml` file, or passed as `helm install` arguments.\n\n- `values.yaml`:\n\n```\nenv:\n  AWS_REGION: \"us-west-2\"\n  FLAGS: \"--apply --debug\"\n```\n\n- `helm install`:\n\n```\nhelm install \\\n    --set env.AWS_REGION=\"us-west-2\" \\\n    --set env.FLAGS=\"--apply --debug\" \\\n    --values PATH_TO_POPULATED_VALUES.YAML \\\n    ecs-task-cleaner ./ecs-task-cleaner\n```\n\nThe name of the Kubernetes secret is `ecs-task-cleaner-secrets` by default, but you can change this by specifying `kubernetesSecretName:` in your `values.yaml` file or specifying `--set kubernetesSecretName=` in the `helm install` command.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquintilesims%2Fgo-ecs-cleaner","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fquintilesims%2Fgo-ecs-cleaner","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquintilesims%2Fgo-ecs-cleaner/lists"}