autoscaler/autoscale-dockerswarm-rabbit

Autoscaler Docker镜像文档

概述

Autoscaler是一款针对Docker Swarm集群的服务自动扩展工具，旨在提供按需扩展能力，实现资源的高效分配，最小化运行成本并确保用户满意度。作为可扩展框架，它允许用户自定义模块以检索待扩展服务、获取决策指标及执行扩展操作，适配多样化的业务场景需求。

核心功能与特性

• 按需服务扩展：根据实际负载动态调整Docker Swarm集群中的服务资源，确保资源精准分配到需求最迫切的服务。
• 可扩展框架设计：支持用户开发自定义模块，覆盖服务检索、指标收集和扩展操作全流程，满足个性化扩展需求。
• Swarm标签识别：内置Swarm源模块，通过服务标签（如自定义标签规则）精准识别需扩展的目标服务。
• RabbitMQ工作负载分析：集成RabbitMQ队列分析器，实时获取队列长度、消息堆积等指标，作为扩展决策依据。
• Swarm API集成：通过Docker Swarm REST API执行服务扩缩容命令，确保扩展操作与Swarm集群无缝协同。

使用场景与适用范围

• 动态负载场景：适用于流量波动显著的Docker Swarm集群，需根据实时请求量或资源使用率动态调整服务实例数量。
• 消息队列依赖服务：特别适合依赖RabbitMQ等消息队列的服务，可基于队列负载自动扩缩容以避免消息堆积或资源浪费。
• 自定义扩展逻辑：需要根据业务特定指标（如自定义监控数据、业务优先级）执行扩展决策的场景，支持通过自定义模块实现个性化策略。

使用方法与配置说明

基本部署

Docker Run命令示例

bash
docker run -d \
  --name autoscaler \
  --network swarm-network \
  -e SWARM_MANAGER_URL=http://swarm-manager:2375 \
  -e RABBITMQ_URL=amqp://user:password@rabbitmq:5672 \
  -e SCALE_LABEL=autoscaler.enable=true \
  -e SCALE_INTERVAL=30 \
  -e MIN_REPLICAS=1 \
  -e MAX_REPLICAS=10 \
  docker.xuanyuan.run/autoscaler:latest

Docker Compose配置示例

yaml
version: '3.8'
services:
  autoscaler:
    image: docker.xuanyuan.run/autoscaler:latest
    container_name: autoscaler
    networks:
      - swarm-network
    environment:
      - SWARM_MANAGER_URL=http://swarm-manager:2375  # Docker Swarm管理器REST API地址
      - RABBITMQ_URL=amqp://user:password@rabbitmq:5672  # RabbitMQ连接地址
      - SCALE_LABEL=autoscaler.enable=true  # 用于识别待扩展服务的Swarm标签
      - SCALE_INTERVAL=30  # 扩展检查间隔（秒）
      - MIN_REPLICAS=1  # 服务最小副本数
      - MAX_REPLICAS=10  # 服务最大副本数
    deploy:
      placement:
        constraints: [node.role == manager]  # 建议部署在Swarm管理节点

networks:
  swarm-network:
    external: true  # 需提前创建的Swarm网络

核心配置参数

自定义模块开发

Autoscaler支持通过以下模块类型扩展功能：

1. 服务检索模块：实现ServiceDiscoverer接口，定义如何发现需扩展的服务（如基于标签、命名规则等）。
2. 指标收集模块：实现MetricCollector接口，自定义扩展决策指标（如CPU使用率、自定义业务指标等）。
3. 扩展操作模块：实现Scaler接口，定义扩缩容执行逻辑（如调用外部API、执行特定命令等）。

详细开发指南请参考官方文档：https://autoscaler.github.io/autoscaler/