{"id":16513949,"url":"https://github.com/twin/aws-eks-auto-tagger","last_synced_at":"2025-10-28T04:32:26.362Z","repository":{"id":106444195,"uuid":"288802921","full_name":"TwiN/aws-eks-auto-tagger","owner":"TwiN","description":"Automatically tags EBS volumes created by Persistent Volumes within an AWS EKS cluster","archived":false,"fork":false,"pushed_at":"2021-10-08T01:35:57.000Z","size":685,"stargazers_count":4,"open_issues_count":2,"forks_count":2,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-01T11:34:45.409Z","etag":null,"topics":["auto-tagger","auto-tagging","aws","ebs","ebs-volumes","eks","hacktoberfest","k8s","persistent-volume","persistent-volumes","tagging"],"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/TwiN.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","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},"funding":{"github":["TwiN"]}},"created_at":"2020-08-19T18:07:53.000Z","updated_at":"2022-02-10T20:31:18.000Z","dependencies_parsed_at":null,"dependency_job_id":"969da6a4-a3c4-434f-9c3c-287d2e420e69","html_url":"https://github.com/TwiN/aws-eks-auto-tagger","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TwiN%2Faws-eks-auto-tagger","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TwiN%2Faws-eks-auto-tagger/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TwiN%2Faws-eks-auto-tagger/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TwiN%2Faws-eks-auto-tagger/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TwiN","download_url":"https://codeload.github.com/TwiN/aws-eks-auto-tagger/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238597386,"owners_count":19498396,"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":["auto-tagger","auto-tagging","aws","ebs","ebs-volumes","eks","hacktoberfest","k8s","persistent-volume","persistent-volumes","tagging"],"created_at":"2024-10-11T16:10:56.347Z","updated_at":"2025-10-28T04:32:25.889Z","avatar_url":"https://github.com/TwiN.png","language":"Go","funding_links":["https://github.com/sponsors/TwiN"],"categories":[],"sub_categories":[],"readme":"# aws-eks-auto-tagger\n\n[![Docker pulls](https://img.shields.io/docker/pulls/twinproduction/aws-eks-auto-tagger.svg)](https://cloud.docker.com/repository/docker/twinproduction/aws-eks-auto-tagger)\n[![Go Report Card](https://goreportcard.com/badge/github.com/TwiN/aws-eks-auto-tagger)](https://goreportcard.com/report/github.com/TwiN/aws-eks-auto-tagger)\n\n\nAutomatically tags all EBS volumes that are tagged with \n\n```\nkubernetes.io/cluster/$CLUSTER_NAME: owned\n```\n\nThere's no way to automatically add one or multiple tags to an EBS that was created by a PersistentVolume.\nBy leveraging the aforementioned default tag, this application is able to iterate over all EBS volumes that are owned by the cluster and add one or multiple tags to each EBS volume.\n\n\n## Environment variables\n\n| Key                                | Description | Default value |\n| ---------------------------------- | ----------- | ------------- |\n| `TAG_\u003ctag_key\u003e`                    | Tag to add to the resources. The tag name will be the name of the variable stripped of the `TAG_` prefix and the tag value will be the value assigned to the variable | N/A |\n| `CLUSTER_NAME`                     | Name of the EKS cluster. Used to search for EBS volumes that belong to the cluster (i.e. by looking for the tag `kubernetes.io/cluster/$CLUSTER_NAME: owned`) | `\"\"` required |\n| `AWS_REGION`                       | Name of AWS region. | `\"\"` required |\n| `EBS_TAGGING_ENABLED`              | Whether to automatically tag EBS volumes or not | `true` |\n| `OVERWRITE_IF_DIFFERENT_TAG_VALUE` | Whether to overwrite the tag if it already exists, but with a different value | `false` |\n| `EXECUTION_INTERVAL_IN_MINUTES`    | Time to wait between each run in minutes | `10` |\n\n\n## Permissions\n\nTo function properly, this application requires the following permissions on AWS:\n- ec2:CreateTags\n- ec2:DescribeVolumes\n\n\n## Developing\n\nMake sure to set the required environment variables, and consider whether you want\nthe EBS Volumes to be tagged or not. \nIf you just want to test it, you can set `EBS_TAGGING_ENABLED` to `false`, and the creation of the tags will be skipped.\n\nYour local aws credentials must also be valid (i.e. you can use `awscli`)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftwin%2Faws-eks-auto-tagger","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftwin%2Faws-eks-auto-tagger","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftwin%2Faws-eks-auto-tagger/lists"}