mesosphere/cloudcleaner

AWS未使用实例清理工具镜像

概述

本Docker镜像提供了一个实用工具，专门用于识别和清理AWS环境中当前未使用的EC2实例。通过自动化检测闲置或低利用率实例并执行清理操作，帮助用户优化资源分配、减少不必要的云服务支出。

核心功能与特性

• 智能识别：基于实例运行状态、CPU/内存使用率、网络流量等指标识别未使用实例
• 灵活清理策略：支持停止（stop）、终止（terminate）或标记（tag）等多种清理操作
• 安全机制：内置实例保留规则，可通过标签或资源组指定保护实例
• 操作审计：详细记录清理过程日志，支持导出审计报告
• 配置灵活：支持自定义闲置阈值（如CPU使用率低于10%持续7天）、清理时间窗口等参数

使用场景与适用范围

• AWS资源优化：定期清理开发/测试环境中遗忘的临时实例
• 成本控制：减少生产环境中低利用率实例的资源浪费
• 运维自动化：集成到CI/CD或定时任务中实现周期性资源清理
• 多账户管理：支持跨AWS账户的实例清理操作

使用方法

前置条件

1. 已安装Docker环境
2. 拥有AWS访问权限（需具备EC2实例管理权限）
3. 配置AWS凭证（通过环境变量或挂载AWS配置文件）

基本使用（Docker Run）

bash
docker run -d \
  -e AWS_ACCESS_KEY_ID="your_access_key" \
  -e AWS_SECRET_ACCESS_KEY="your_secret_key" \
  -e AWS_REGION="us-east-1" \
  -e CLEANUP_THRESHOLD_CPU="10" \  # CPU使用率阈值（百分比）
  -e CLEANUP_THRESHOLD_DAYS="7" \  # 持续闲置天数阈值
  -e CLEANUP_ACTION="terminate" \  # 清理操作：terminate/stop/tag
  -e RETAIN_TAGS="env=production,project=core" \  # 保留实例标签（逗号分隔）
  aws-instance-cleanup:latest

Docker Compose配置

yaml
version: '3'
services:
  aws-cleanup:
    image: aws-instance-cleanup:latest
    environment:
      - AWS_ACCESS_KEY_ID=your_access_key
      - AWS_SECRET_ACCESS_KEY=your_secret_key
      - AWS_REGION=us-west-2
      - CLEANUP_THRESHOLD_CPU=5
      - CLEANUP_THRESHOLD_DAYS=3
      - CLEANUP_ACTION=stop
      - RETAIN_TAGS=env=prod,owner=admin
      - DRY_RUN=true  # 启用 dry run 模式（仅检测不执行操作）
      - LOG_LEVEL=info  # 日志级别：debug/info/warn/error
    volumes:
      - ./cleanup-logs:/app/logs  # 挂载日志目录

环境变量配置说明

注意事项

1. 首次使用建议启用DRY_RUN=true进行模拟运行，确认清理目标无误后再执行实际操作
2. 确保AWS凭证具备足够权限（建议最小权限：ec2:DescribeInstances, ec2:StopInstances, ec2:TerminateInstances）
3. 生产环境中建议配置RETAIN_TAGS保护核心业务实例
4. 清理操作不可逆，请谨慎配置阈值参数