hashicorp/nomad-autoscaler-enterprise

Nomad Autoscaler Enterprise 镜像文档

概述

Nomad Autoscaler Enterprise是HashiCorp Nomad的自动扩缩容守护进程，采用插件架构设计，支持多种指标源、扩缩目标和扩缩算法。该项目处于早期开发阶段，不提供任何保证，且可能在无预警情况下变更。更多信息参见官方文档：https://github.com/hashicorp/nomad-autoscaler%E3%80%82

核心功能与特性

• 插件化架构：支持通过插件扩展指标源（APM）、扩缩目标和扩缩算法，满足多样化扩缩需求
• Nomad集成部署：可作为Nomad任务部署，利用artifact自动获取插件/配置文件，通过template结合Vault/Consul渲染含密钥或动态值的配置
• 多部署模式：支持集群内部部署（Nomad任务）或外部独立部署（Docker容器）
• 灵活配置：支持自定义Nomad地址、APM配置（如Nomad、Prometheus）及扩缩策略

使用场景与适用范围

适用于需要对Nomad集群资源进行自动扩缩容的场景，包括：

• Nomad集群内部资源动态调整（作业实例数量、客户端节点等）
• 结合外部监控系统（如Prometheus）实现基于自定义指标的扩缩
• 需要灵活扩展指标源或扩缩算法的复杂部署环境

使用方法与配置说明

在Nomad中作为Docker任务运行

通过Docker驱动将Autoscaler部署为Nomad任务，示例Job配置：

hcl
job "autoscaler" {
  datacenters = ["dc1"]

  group "autoscaler" {
    count = 1

    task "autoscaler" {
      driver = "docker"

      config {
        image   = "hashicorp/nomad-autoscaler-enterprise:0.3.3"
        command = "nomad-autoscaler"
        args    = ["agent", "-config", "${NOMAD_TASK_DIR}/config.hcl"]
      }

      template {
        data = <<EOF
plugin_dir = "/plugins"

nomad {
  address = "http://{{env "attr.unique.network.ip-address" }}:4646"
}
apm "nomad" {
  driver = "nomad-apm"
  config  = {
    address = "http://{{env "attr.unique.network.ip-address" }}:4646"
  }
}
apm "prometheus" {
  driver = "prometheus"
  config = {
    address = "http://{{ env "attr.unique.network.ip-address" }}:9090"
  }
}
strategy "target-value" {
  driver = "target-value"
}
          EOF

        destination = "${NOMAD_TASK_DIR}/config.hcl"
      }
    }
  }
}

配置说明：

• datacenters：指定部署的数据中心（示例为"dc1"）
• group "autoscaler"：任务组配置，count=1表示运行单个实例
• task "autoscaler"：使用Docker驱动，镜像为hashicorp/nomad-autoscaler-enterprise:0.3.3
• config：设置启动命令，通过-config指定配置文件路径
• template：生成配置文件，包含插件目录、Nomad地址、APM配置（Nomad和Prometheus）及扩缩策略（target-value）

作为独立Docker容器运行

通过以下命令将Autoscaler作为独立Docker容器运行：

bash
$ docker run \
    --volume /usr/bin/nomad-autoscaler/plugins:/plugins \
    --volume /opt/nomad-autoscaler/config:/config \
    hashicorp/nomad-autoscaler nomad-autoscaler agent -config /config

参数说明：

• --volume /usr/bin/nomad-autoscaler/plugins:/plugins：挂载本地插件目录到容器内/plugins
• --volume /opt/nomad-autoscaler/config:/config：挂载本地配置目录到容器内/config
• nomad-autoscaler agent -config /config：启动Autoscaler代理，指定配置目录为/config

构建自定义Docker镜像

可构建自定义镜像以添加额外插件和配置，示例Dockerfile：

dockerfile
FROM hashicorp/nomad-autoscaler-enterprise:v0.3.3

# 添加自定义插件
ADD http://my-ci/build-num/my-plugin /plugin-dir/my-plugin

# 添加自定义配置（与基础镜像默认配置合并）
ADD http://my-ci/build-num/my-plugin-conf.hcl \
      /config-dir/my-plugin.hcl
...

说明：基于官方镜像，通过ADD命令添加自定义插件和配置文件，实现镜像定制化。