sideshowbandana/k8s-sqs-autoscaler

镜像概述

sideshowbandana/k8s-sqs-autoscaler是一款针对Kubernetes集群的自动扩缩容工具，核心功能是基于AWS SQS队列的消息数量动态调整目标Deployment的Pod数量，帮助用户实现资源弹性调度，平衡服务性能与成本。

核心功能

• 实时监控AWS SQS队列的消息堆积量
• 根据预设阈值自动触发Pod扩容/缩容操作
• 支持配置Pod数量的上下限限制
• 与Kubernetes API无缝集成，执行扩缩容指令

使用场景

• 消息处理服务：当SQS队列消息堆积时自动增加Worker Pod，减少时自动缩容
• 异步任务场景：针对依赖SQS的批量任务，动态调整资源以适配流量波动
• 成本优化：避免闲置Pod资源浪费，同时保证高负载时的服务稳定性

配置说明

需通过环境变量配置关键参数：

• AWS_ACCESS_KEY_ID: AWS访问密钥ID（需拥有SQS读取权限）
• AWS_SECRET_ACCESS_KEY: AWS秘密访问密钥
• SQS_QUEUE_URL: 目标SQS队列的完整URL
• KUBERNETES_DEPLOYMENT_NAME: 需扩缩容的K8s Deployment名称
• KUBERNETES_NAMESPACE: Deployment所在的K8s命名空间（默认：default）
• MIN_PODS: 最小Pod数量（默认：1）
• MAX_PODS: 最大Pod数量（默认：10）
• SCALE_UP_THRESHOLD: 触发扩容的消息数量阈值（默认：100）
• SCALE_DOWN_THRESHOLD: 触发缩容的消息数量阈值（默认：20）
• POLL_INTERVAL: 队列监控间隔（秒，默认：30）

部署示例

Docker Run命令

bash
docker run -d \
  -e AWS_ACCESS_KEY_ID="your-aws-key" \
  -e AWS_SECRET_ACCESS_KEY="your-aws-secret" \
  -e SQS_QUEUE_URL="https://sqs.us-east-1.amazonaws.com/123456789012/your-queue" \
  -e KUBERNETES_DEPLOYMENT_NAME="worker-deployment" \
  -e MIN_PODS=2 \
  -e MAX_PODS=8 \
  -e SCALE_UP_THRESHOLD=80 \
  -e SCALE_DOWN_THRESHOLD=15 \
  -e POLL_INTERVAL=20 \
  --mount type=bind,source=$HOME/.kube/config,target=/root/.kube/config \
  docker.xuanyuan.run/sideshowbandana/k8s-sqs-autoscaler

说明：需挂载本地K8s配置文件（~/.kube/config）以允许容器访问集群。

Docker Compose示例

yaml
version: '3.8'
services:
  autoscaler:
    image: sideshowbandana/k8s-sqs-autoscaler
    environment:
      AWS_ACCESS_KEY_ID: "your-aws-key"
      AWS_SECRET_ACCESS_KEY: "your-aws-secret"
      SQS_QUEUE_URL: "https://sqs.us-east-1.amazonaws.com/123456789012/your-queue"
      KUBERNETES_DEPLOYMENT_NAME: "worker-deployment"
      KUBERNETES_NAMESPACE: "default"
      MIN_PODS: 2
      MAX_PODS: 8
      SCALE_UP_THRESHOLD: 80
      SCALE_DOWN_THRESHOLD: 15
      POLL_INTERVAL: 20
    volumes:
      - ~/.kube/config:/root/.kube/config