zacblazic/graffiti-monkey

Graffiti Monkey镜像概述

Graffiti Monkey是针对AWS云环境的资源标签管理工具，通过自动同步EC2实例、EBS卷及快照的标签，解决云资源标签不一致问题，提升资源可追溯性与管理效率。

核心功能

1. 标签传播：将EC2实例标签复制到关联EBS卷，再从卷复制到对应快照；
2. 灵活配置：支持YAML文件自定义需传播的标签、默认标签及目标资源范围；
3. 命令行参数：提供区域、认证配置、详细日志等参数，支持dry-run模式验证操作；
4. 多认证方式：通过Boto支持IAM角色、环境变量、.boto文件等AWS认证方式。

使用场景

• 云资源管理：统一EC2、EBS卷、快照的标签，便于筛选、计费或审计；
• 自动化运维：集成到定时任务中，自动维护标签一致性；
• 合规审计：确保资源标签符合企业规范，满足监管要求。

配置说明

Boto认证配置

通过以下方式提供AWS凭证：

• IAM角色：容器运行环境（如EC2）关联IAM角色；
• 环境变量：设置AWS_ACCESS_KEY_ID和AWS_SECRET_ACCESS_KEY；
• .boto文件：挂载包含认证信息的.boto文件到容器~/.boto路径。

YAML配置示例

创建config.yml自定义规则：

yaml
---
_instance_tags_to_propagate:
  - 'Name'
  - 'Owner'
_volume_tags_to_propagate:
  - 'Name'
  - 'instance_id'
_volumes_to_tag: []  # 空列表表示所有卷
_snapshots_to_tag: [] # 空列表表示所有快照

部署示例

Docker Run命令

bash
docker run --rm \
  -e AWS_ACCESS_KEY_ID=your_key \
  -e AWS_SECRET_ACCESS_KEY=your_secret \
  -v ./config.yml:/app/config.yml \
  zacblazic/graffiti-monkey \
  --region us-east-1 \
  --config /app/config.yml \
  --verbose

Docker Compose示例

yaml
version: '3'
services:
  graffiti-monkey:
    image: zacblazic/graffiti-monkey
    environment:
      - AWS_REGION=us-east-1
      - AWS_ACCESS_KEY_ID=your_key
      - AWS_SECRET_ACCESS_KEY=your_secret
    volumes:
      - ./config.yml:/app/config.yml
    command: ["--config", "/app/config.yml", "--verbose"]