sergrua/kube-tagger

Kubernetes Volume Tagger

镜像概述

这是一个Kubernetes工具，旨在解决AWS环境中EBS卷标签管理的问题。当Kubernetes创建持久卷声明（PVC）时，它会自动为对应的EBS卷添加用户指定的标签，方便资源分类、成本追踪和权限控制。

核心功能

1. 自动标签添加：在PVC创建时，自动将注解中的标签应用到关联的EBS卷上。
2. 自定义分隔符：支持通过注解自定义标签的分隔符（默认使用逗号）。
3. IAM权限支持：需要为EC2实例配置最小化的IAM权限以执行标签操作。

使用场景

适用于在AWS上运行Kubernetes集群的用户，需要对EBS卷进行标签管理的场景，例如：

• 按环境（开发/测试/生产）分类资源
• 按团队或项目归属标记卷
• 满足AWS资源标签策略的合规要求

配置说明

PVC注解配置

在PVC中添加注解指定标签：

yaml
annotations:
  volume.beta.kubernetes.io/additional-resource-tags: Owner=Sergio,Environment=Dev

自定义分隔符：

yaml
annotations:
  volume.beta.kubernetes.io/additional-resource-tags-separator: ";"

IAM权限配置

需要为EC2实例授予以下最小权限：

json
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": "ec2:DescribeVolumes",
      "Resource": "*"
     },
     {
       "Effect": "Allow",
       "Action": [
         "ec2:CreateTags"
       ],
       "Resource": "arn:aws:ec2:*:*:volume/*",
       "Condition": {
         "StringEquals": {
             "ec2:CreateAction" : "CreateTags"
        }
      }
    }
  ]
}

部署方式

手动部署

使用示例YAML文件部署：

sh
kubectl apply -f https://raw.githubusercontent.com/sergiorua/kube-tagger/master/kube-tagger.yaml

Helm部署

添加Helm仓库并安装：

sh
helm repo add sergiorua https://sergiorua.github.io/helm-charts/
helm upgrade --install kube-tagger sergiorua/kube-tagger

Helm Values配置