spreaker/aws-cloud-unmap

AWS Cloud Map EC2实例清理控制器

镜像概述

该Docker镜像提供一个外部控制器，专门用于自动检测并从AWS Cloud Map服务中移除已终止的EC2实例。通过持续监控EC2实例状态与Cloud Map注册记录的一致性，确保服务发现数据准确反映实际运行的基础设施，避免因无效实例记录导致的服务调用失败。

核心功能与特性

• 自动检测机制：定期扫描EC2实例状态，识别已终止（terminated）的实例
• Cloud Map集成：通过AWS API与Cloud Map服务交互，精准移除无效注册记录
• 安全操作：基于AWS IAM权限控制，仅对指定命名空间和服务执行清理操作
• 可配置扫描间隔：支持自定义检查频率，平衡实时性与资源消耗
• 日志记录：详细记录清理操作过程，便于审计与问题排查

使用场景

• AWS环境中基于Cloud Map实现服务发现的微服务架构
• 需要保持服务注册记录与实际运行实例严格一致的生产环境
• 自动运维场景下，替代手动清理Cloud Map无效记录的操作
• 多区域部署中，跨区域EC2实例的服务注册管理

使用方法

前置条件

1. 已配置AWS访问权限（通过IAM角色或访问密钥）
2. 目标EC2实例已在Cloud Map中注册
3. 控制器需具备以下AWS权限：
   • ec2:DescribeInstances（查看EC2实例状态）
   • servicediscovery:ListInstances（列出Cloud Map实例）
   • servicediscovery:DeregisterInstance（注销实例）

环境变量配置

Docker Run部署示例

bash
docker run -d \
  --name cloud-map-cleaner \
  -e AWS_REGION=us-east-1 \
  -e CLOUD_MAP_NAMESPACE_ID=ns-xxxxxxxxxxxxxxxxx \
  -e CLOUD_MAP_SERVICE_ID=srv-yyyyyyyyyyyyyyyyy \
  -e SCAN_INTERVAL_SECONDS=600 \
  -e LOG_LEVEL=INFO \
  your-registry/cloud-map-ec2-cleaner:latest

Docker Compose配置示例

yaml
version: '3.8'
services:
  cloud-map-cleaner:
    image: your-registry/cloud-map-ec2-cleaner:latest
    environment:
      - AWS_REGION=us-east-1
      - CLOUD_MAP_NAMESPACE_ID=ns-xxxxxxxxxxxxxxxxx
      - CLOUD_MAP_SERVICE_ID=srv-yyyyyyyyyyyyyyyyy
      - SCAN_INTERVAL_SECONDS=300
      - LOG_LEVEL=INFO
    restart: unless-stopped

运行流程

1. 控制器启动后，按配置的间隔时间执行扫描
2. 调用EC2 API获取目标区域所有EC2实例状态
3. 调用Cloud Map API获取指定服务下的所有注册实例
4. 比对EC2实例ID，识别Cloud Map中存在但EC2已终止的实例
5. 对识别出的无效实例执行DeregisterInstance操作
6. 记录操作日志并等待下一次扫描周期

注意事项

• 确保控制器的AWS权限最小化，仅授予必要操作权限
• 首次运行建议设置LOG_LEVEL=DEBUG以验证配置正确性
• 对于大规模部署，建议适当增加SCAN_INTERVAL_SECONDS以减少API调用频率
• 跨区域部署需为每个区域单独配置实例，或使用全局配置参数（如支持）