elsce/replicator

Replicator镜像说明

镜像概述

Replicator是一个高性能Go守护进程，用于HashiCorp Nomad集群的任务和工作节点动态扩展。它通过元参数配置扩展策略，支持AWS自动扩展组伸缩，适用于需要弹性资源管理的Nomad环境。

核心功能

1. 任务扩展: 基于Nomad任务组元参数定义的CPU、内存阈值，自动调整任务实例数量。
2. 集群扩展: 针对AWS自动扩展组，通过Nomad客户端元参数配置工作节点的动态伸缩。
3. 分布式协调: 利用Consul会话实现 leadership 锁定，确保多实例环境下的协调运行。
4. 故障安全: 支持故障安全模式切换，暂停所有扩展操作以应对异常场景。

使用场景

• 任务负载波动时，自动调整实例数量优化资源利用率。
• 集群资源不足/过剩时，动态调整AWS工作节点数量降低成本。
• 分布式环境中需要可靠的扩展协调机制。

配置说明

Nomad客户端配置（启用工作节点扩展）

json
{
    "bind_addr": "0.0.0.0",
    "client": {
        "enabled": true,
        "meta": {
            "replicator_cooldown": 300,
            "replicator_enabled": "true",
            "replicator_node_fault_tolerance": 1,
            "replicator_notification_uid": "REP2",
            "replicator_region": "us-east-1",
            "replicator_retry_threshold": 3,
            "replicator_scaling_threshold": 3,
            "replicator_worker_pool": "container-node-private-nonprod"
        }
    }
}

Nomad任务配置（启用任务扩展）

hcl
job "example" {
  datacenters = ["dc1"]
  type        = "service"

  update {
    max_parallel = 1
    stagger      = "10s"
  }

  group "cache" {
    count = 3

    meta {
      "replicator_max"               = 10
      "replicator_cooldown"          = 50
      "replicator_enabled"           = true
      "replicator_min"               = 1
      "replicator_scalein_mem"       = 30
      "replicator_scalein_cpu"       = 30
      "replicator_scaleout_mem"      = 80
      "replicator_scaleout_cpu"      = 80
      "replicator_notification_uid"  = "REP1"
    }

  # 任务详情（如Redis）省略
  }
}

Docker运行示例

bash
docker run -v /path/to/replicator/config:/config elsce/replicator agent --config /config/config.hcl

说明：需挂载配置文件目录，并确保容器可访问Nomad和Consul服务。

权限要求

• Consul ACL: 需读取/写入特定键、节点和会话的权限（具体策略参考原项目文档）。
• AWS IAM: 使用集群扩展时，需授予AutoScaling和EC2相关操作权限（具体策略参考原项目文档）。