dwpdigital/ecs-service-discovery

Docker ECS服务发现服务（Prometheus集成）

镜像概述

该镜像提供用于Prometheus的ECS服务发现功能，旨在解决Prometheus监控Amazon ECS集群时的服务实例动态发现问题。通过自动获取ECS集群中的服务实例信息（如容器IP、端口等），实现Prometheus监控目标的自动化配置与更新，减少手动运维成本。

核心功能与特性

• 自动服务发现：实时探测ECS集群中的服务实例，包括容器IP、端口及元数据
• Prometheus集成：提供符合Prometheus HTTP服务发现规范的接口，无缝对接Prometheus
• 动态配置支持：适配ECS任务扩缩容、服务更新等动态变化场景
• 可配置刷新机制：支持自定义服务发现信息刷新间隔，平衡实时性与资源消耗
• AWS权限兼容：支持通过AWS IAM角色或访问密钥进行身份验证，安全访问ECS API

使用场景与适用范围

• 基于Prometheus监控Amazon ECS集群的用户
• 需要动态发现和监控ECS服务实例的场景（如微服务架构、动态扩缩容环境）
• 多环境（开发/测试/生产）ECS集群的统一监控管理
• 希望减少Prometheus target手动配置的运维场景

使用方法与配置说明

前提条件

• 已部署Prometheus服务
• 拥有运行中的Amazon ECS集群
• 具备访问ECS API的权限（通过IAM角色或AWS访问密钥）

Docker Run命令示例

bash
docker run -d \
  --name ecs-service-discovery \
  -e AWS_ACCESS_KEY_ID=AKIAEXAMPLE \
  -e AWS_SECRET_ACCESS_KEY=your-secret-key \
  -e AWS_REGION=us-west-2 \
  -e ECS_CLUSTER=my-ecs-cluster \
  -e REFRESH_INTERVAL=60s \
  -p 9090:9090 \
  prom/ecs-service-discovery

环境变量配置说明

Prometheus配置集成

在Prometheus配置文件（prometheus.yml）中添加以下http_sd_configs配置：

yaml
scrape_configs:
  - job_name: 'ecs-services'
    http_sd_configs:
      - url: 'http://ecs-service-discovery:9090/sd'  # 服务发现服务地址
    relabel_configs:
      - source_labels: [__meta_ecs_service_name]
        action: replace
        target_label: service
      - source_labels: [__meta_ecs_cluster]
        action: replace
        target_label: cluster

Docker Compose配置示例

yaml
version: '3.8'
services:
  ecs-service-discovery:
    image: prom/ecs-service-discovery
    container_name: ecs-service-discovery
    environment:
      - AWS_REGION=us-west-2
      - ECS_CLUSTER=production-cluster
      - REFRESH_INTERVAL=45s
      - LOG_LEVEL=info
    ports:
      - "9090:9090"
    restart: unless-stopped
    # 若使用IAM角色，需挂载相应凭证文件
    volumes:
      - /var/run/secrets/aws.ecr.credentials:/root/.aws/credentials:ro