veqryn/kube-cloudwatch-autoscaler

kube-cloudwatch-autoscaler

镜像概述

该镜像提供Kubernetes部署工具，可根据任意AWS CloudWatch指标（如SQS队列消息年龄、ELB响应时间等）定期调整目标部署的Pod副本数量，实现自动扩缩容。

核心功能

1. 支持多种CloudWatch指标（SQS队列大小、消息年龄、ELB响应时间等）作为扩缩容触发条件
2. 可配置副本数量上下限、扩缩步长、冷却时间等参数
3. 支持AWS EC2角色或访问密钥两种认证方式访问CloudWatch
4. 提供详细日志选项（VERBOSE模式）

使用场景

• 当SQS队列中最旧消息年龄超过阈值时，自动增加Pod副本数以加快消息处理
• 当ELB响应时间过高时，扩容服务副本提升处理能力
• 指标稳定后自动缩容以节省资源

配置说明

前提条件

确保该自动扩缩工具拥有访问AWS CloudWatch的权限：

• 使用AWS EC2角色（推荐）
• 或创建具备CloudWatch只读权限的用户并提供访问密钥

Kubernetes部署示例

yaml
apiVersion: extensions/v1beta1
kind: Deployment
metadata:
  name: kube-cloudwatch-autoscaler
  labels:
    app: kube-cloudwatch-autoscaler
spec:
  replicas: 1
  selector:
    matchLabels:
      app: kube-cloudwatch-autoscaler
  template:
    metadata:
      labels:
        app: kube-cloudwatch-autoscaler
    spec:
      containers:
        - name: kube-cloudwatch-autoscaler
          image: "docker.xuanyuan.run/veqryn/kube-cloudwatch-autoscaler:1.4"
          env:
            - name: KUBE_ENDPOINT # 必填，Kubernetes中目标部署的scale API端点（示例将扩缩名为my-app-name的部署）
              value: "apis/apps/v1beta1/namespaces/default/deployments/my-app-name/scale"
            - name: KUBE_MIN_REPLICAS # 可选，最小副本数
              value: "1"
            - name: KUBE_MAX_REPLICAS # 可选，最大副本数
              value: "50"
            - name: KUBE_SCALE_DOWN_COUNT # 可选，缩容时减少的副本数
              value: "1"
            - name: KUBE_SCALE_UP_COUNT # 可选，扩容时增加的副本数
              value: "1"
            - name: KUBE_SCALE_DOWN_COOLDOWN # 可选，缩容后冷却时间（秒）
              value: "180"
            - name: KUBE_SCALE_UP_COOLDOWN # 可选，扩容后冷却时间（秒）
              value: "300"
            - name: CW_SCALE_DOWN_VALUE # 必填，触发缩容的CloudWatch指标阈值
              value: "300"
            - name: CW_SCALE_UP_VALUE # 必填，触发扩容的CloudWatch指标阈值
              value: "900"
            - name: CW_NAMESPACE # 必填，CloudWatch命名空间（参考AWS文档）
              value: "AWS/SQS"
            - name: CW_METRIC_NAME # 必填，CloudWatch指标名称
              value: "ApproximateAgeOfOldestMessage"
            - name: CW_DIMENSIONS # 必填，指标维度（多维度用空格分隔，如"Name=QueueName,Value=my_queue"）
              value: "Name=QueueName,Value=my_sqs_queue_name"
            - name: CW_DIMENSIONS_DELIMITER # 可选，多维度分隔符，默认空格
              value: " "
            - name: CW_STATISTICS # 可选，指标聚合方式（Average/Sum/Minimum等）
              value: "Average"
            - name: CW_PERIOD # 可选，指标数据聚合周期（秒）
              value: "360"
            - name: CW_POLL_PERIOD # 可选，CloudWatch指标轮询间隔（秒）
              value: "30"
            - name: VERBOSE # 可选，是否开启详细日志
              value: "false"
            - name: AWS_DEFAULT_REGION # 可选，非EC2角色时需填写
              value: "us-east-1"
            - name: AWS_ACCESS_KEY_ID # 可选，非EC2角色时需填写（从secret获取）
              valueFrom:
                secretKeyRef:
                  name: aws-secrets
                  key: aws-access-key-id
            - name: AWS_SECRET_ACCESS_KEY # 可选，非EC2角色时需填写（从secret获取）
              valueFrom:
                secretKeyRef:
                  name: aws-secrets
                  key: aws-secret-access-key
          resources:
            requests:
              memory: 24Mi
              cpu: 10m
            limits:
              memory: 48Mi
              cpu: 50m

---
# 可选，非EC2角色时需创建此Secret
kind: Secret
metadata:
  name: aws-secrets
  labels:
    app: aws-secrets
type: Opaque
data:
  aws-access-key-id: "YXdzLWtleQ==" # 替换为Base64编码的访问密钥ID
  aws-secret-access-key: "YXdzLXNlY3JldA==" # 替换为Base64编码的秘密访问密钥

AWS权限配置

创建以下IAM策略（或直接使用CloudWatchReadOnlyAccess）并附加到角色/用户：

json
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": "cloudwatch:GetMetricStatistics",
            "Resource": "*"
        }
    ]
}