multani/nomad

Nomad Docker镜像文档

镜像概述与主要用途

本镜像提供了HashiCorp Nomad调度器的Docker化部署版本，旨在简化Nomad的快速部署与测试。主要用途包括：

• 测试环境中快速搭建Nomad集群
• 构建包含Nomad的小型容器化部署栈
• 开发环境中验证Nomad任务调度功能

镜像设计参考了HashiCorp官方https://github.com/hashicorp/docker-consul%E7%9A%84%E5%AE%9E%E7%8E%B0%E6%A8%A1%E5%BC%8F%EF%BC%8C%E5%9F%BA%E4%BA%8Ehttps://github.com/djenriquez/nomad%E9%A1%B9%E7%9B%AE%E7%9A%84%E5%9F%BA%E7%A1%80%E8%BF%9B%E8%A1%8C%E5%BC%80%E5%8F%91%E3%80%82

核心功能与特性

配置灵活性

• 双重配置方式：支持通过绑定挂载HCL/JSON配置文件到/etc/nomad目录，或通过NOMAD_LOCAL_CONFIG环境变量直接注入配置内容
• 动态参数调整：可通过环境变量灵活设置Nomad运行参数

系统兼容性

• 主机网络模式：需使用host网络模式运行，确保Nomad正常通信
• Docker驱动支持：需挂载/var/run/docker.sock以支持Docker任务驱动
• 临时目录共享：需挂载/tmp目录，满足Nomad默认临时文件需求（尤其在-dev模式下）

安全与权限

• 非root运行支持：可配置为非root用户运行，需设置NOMAD_DISABLE_PERM_MGMT环境变量
• 权限管理控制：禁用权限管理后适合独立Nomad服务器场景

使用场景与适用范围

典型应用场景

• 测试环境验证：快速启动Nomad集群验证任务调度逻辑
• 开发环境搭建：本地开发时模拟Nomad集群环境
• 小型生产部署：轻量级Nomad集群（需注意权限与资源配置）

适用范围限制

• 不建议大规模生产环境：主要面向测试与小型部署，大规模集群需评估性能与稳定性
• 客户端模式需特权：运行Nomad客户端时通常需要privileged权限以支持各类任务驱动

使用方法与配置说明

前提条件

• Docker引擎版本需支持host网络模式与挂载卷功能
• 宿主机需提供以下目录用于挂载：
  • /var/run/docker.sock（Docker任务驱动必需）
  • /tmp（临时文件存储）
  • 自定义数据目录（如/host/path/to/nomad/data）

Docker Compose部署

通过Docker Compose可快速启动开发环境，示例配置如下：

yaml
version: '2.1'

services:
  nomad:
    image: multani/nomad
    command: agent -dev  # 开发模式运行
    privileged: true     # 开发模式需特权权限
    network_mode: host   # 使用主机网络
    environment:
      # 直接注入Nomad配置内容
      NOMAD_LOCAL_CONFIG: |
        data_dir = "/nomad/data/"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:rw  # 挂载Docker socket
      - /tmp:/tmp  # 共享临时目录

启动命令：

bash
docker-compose up

服务器模式部署

核心特性

• 可非root用户运行
• 需确保数据目录权限正确
• 无需特权模式（独立服务器场景）

部署命令

bash
docker run -d \
  --name nomad-server \
  --net host \                  # 主机网络模式
  --user nomad \                # 非root用户运行
  -e NOMAD_DISABLE_PERM_MGMT=true \  # 禁用权限管理
  -e NOMAD_LOCAL_CONFIG='       # 服务器配置内容
server {
  enabled = true
  bootstrap_expect = 3          # 期望的服务器节点数（集群启动需满足）
}

datacenter = "${REGION}"        # 数据中心名称（需替换为实际值）
region     = "${DATACENTER}"    # 区域名称（需替换为实际值）

data_dir = "/nomad/data/"       # 数据目录（容器内路径）

bind_addr = "0.0.0.0"           # 绑定所有网络接口

advertise {                     # 服务发现地址配置
  http = "{{ GetPrivateIP }}:4646"  # HTTP API端口
  rpc  = "{{ GetPrivateIP }}:4647"  # RPC端口
  serf = "{{ GetPrivateIP }}:4648"  # Serf通信端口
}
' \
  -v "nomad:/nomad/data:rw"     # 数据卷挂载（持久化存储）
  multani/nomad agent           # 启动Nomad代理

客户端模式部署

核心特性

• 通常需privileged权限以支持各类任务驱动
• 必须挂载Docker socket与临时目录
• 数据目录需确保读写权限

部署命令

bash
docker run -d \
  --name nomad-client \
  --net host \                      # 主机网络模式
  --privileged \                    # 客户端需特权权限
  -e NOMAD_LOCAL_CONFIG='           # 客户端配置内容
client {
  enabled = true                    # 启用客户端模式
}

datacenter = "${REGION}"            # 数据中心名称（需替换为实际值）
region     = "${DATACENTER}"        # 区域名称（需替换为实际值）

data_dir = "/nomad/data/"           # 数据目录（容器内路径）

bind_addr = "0.0.0.0"               # 绑定所有网络接口

advertise {                         # 服务发现地址配置
  http = "{{ GetPrivateIP }}:4646"  # HTTP API端口
  rpc  = "{{ GetPrivateIP }}:4647"  # RPC端口
  serf = "{{ GetPrivateIP }}:4648"  # Serf通信端口
}
' \
  -v "/srv/nomad/data:/nomad/data:rw" \  # 数据目录挂载
  -v "/var/run/docker.sock:/var/run/docker.sock" \  # Docker socket挂载
  -v "/tmp:/tmp" \                      # 临时目录挂载
  multani/nomad agent                   # 启动Nomad代理

配置参数与环境变量

核心环境变量

关键配置项（NOMAD_LOCAL_CONFIG）

数据目录配置注意事项

Nomad生成的模板文件路径依赖于data_dir配置，为确保宿主机Docker daemon能正确挂载这些路径，需满足以下条件：

1. 路径一致性：容器内data_dir路径必须与宿主机挂载路径完全一致
   示例：宿主机路径/host/nomad/data需挂载为容器内同路径，配置data_dir = "/host/nomad/data"

2. 环境变量传递：通过NOMAD_DATA_DIR环境变量显式指定数据目录路径，确保配置与挂载同步：

bash
export NOMAD_DATA_DIR=/host/path/to/nomad/data

docker run \
  ... \
  -v "$NOMAD_DATA_DIR:$NOMAD_DATA_DIR:rw" \  # 路径保持一致
  -e "NOMAD_DATA_DIR=$NOMAD_DATA_DIR" \      # 传递环境变量
  multani/nomad agent

3. 权限设置：非root用户运行时，宿主机数据目录需赋予运行用户读写权限（如chown -R 1000:1000 /host/path/to/nomad/data）# Nomad Docker镜像文档

镜像概述与主要用途

本镜像提供HashiCorp Nomad调度器的Docker化部署版本，主要用于测试环境及小型Nomad集群部署。镜像设计参考Hashicorp官方https://github.com/hashicorp/docker-consul%E6%A8%A1%E5%9E%8B%EF%BC%8C%E5%9F%BA%E4%BA%8Ehttps://github.com/djenriquez/nomad%E9%A1%B9%E7%9B%AE%E5%BC%80%E5%8F%91%E3%80%82

镜像需运行在主机网络模式下，支持灵活配置与非root用户运行，适合快速搭建Nomad测试环境或轻量级部署场景。

核心功能与特性

灵活配置方式

• 双配置源支持：通过绑定挂载HCL/JSON配置文件到/etc/nomad目录，或使用NOMAD_LOCAL_CONFIG环境变量直接注入配置内容
• 动态参数调整：支持运行时通过环境变量修改核心配置参数

系统集成能力

• Docker驱动支持：需挂载/var/run/docker.sock以启用Docker任务驱动
• 临时文件共享：默认依赖/tmp目录存储临时文件，需从宿主机挂载
• 主机网络依赖：采用host网络模式确保Nomad组件间通信正常

安全与权限管理

• 非root运行支持：设置NOMAD_DISABLE_PERM_MGMT环境变量可禁用权限管理，支持非root用户运行
• 权限粒度控制：服务器模式可安全降级权限，客户端模式通常需特权权限以支持各类任务驱动

使用场景与适用范围

典型应用场景

• 开发测试环境：快速搭建本地Nomad集群验证任务调度逻辑
• CI/CD集成：在持续集成流程中模拟Nomad部署环境
• 小型生产部署：轻量级Nomad集群（需评估资源需求与权限配置）

限制说明

• 生产环境注意事项：大规模生产部署需额外评估性能与稳定性
• 客户端权限要求：运行客户端时通常需要privileged标志以支持Docker、网络等任务驱动

使用方法与配置说明

前提条件

• Docker引擎支持host网络模式与挂载卷功能
• 宿主机需提供以下可挂载目录：
  • /var/run/docker.sock（Docker任务驱动必需）
  • /tmp（临时文件存储）
  • 自定义数据目录（如/srv/nomad/data）

Docker Compose快速部署

适用于开发测试环境，一键启动Nomad开发模式：

yaml
version: '2.1'

services:
  nomad:
    image: multani/nomad
    command: agent -dev  # 开发模式运行
    privileged: true     # 开发模式需特权权限
    network_mode: host   # 使用主机网络
    environment:
      NOMAD_LOCAL_CONFIG: |  # 内联配置
        data_dir = "/nomad/data/"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock:rw  # Docker socket挂载
      - /tmp:/tmp  # 临时目录共享

启动命令：

bash
docker-compose up

服务器模式部署

核心配置要点

• 可使用非root用户运行
• 禁用权限管理（NOMAD_DISABLE_PERM_MGMT=true）
• 配置服务器发现与引导参数

部署命令示例

bash
docker run -d \
  --name nomad-server \
  --net host \
  --user nomad \  # 非root用户运行
  -e NOMAD_DISABLE_PERM_MGMT=true \
  -e NOMAD_LOCAL_CONFIG='
server {
  enabled = true
  bootstrap_expect = 3  # 集群引导节点数
}

datacenter = "dc1"
region     = "global"

data_dir = "/nomad/data/"
bind_addr = "0.0.0.0"

advertise {
  http = "{{ GetPrivateIP }}:4646"
  rpc  = "{{ GetPrivateIP }}:4647"
  serf = "{{ GetPrivateIP }}:4648"
}
' \
  -v "nomad-data:/nomad/data:rw"  # 数据卷持久化
  multani/nomad agent

客户端模式部署

核心配置要点

• 需privileged权限支持任务驱动
• 必须挂载Docker socket与临时目录
• 配置客户端模式与服务发现地址

部署命令示例

bash
docker run -d \
  --name nomad-client \
  --net host \
  --privileged \  # 客户端需特权权限
  -e NOMAD_LOCAL_CONFIG='
client {
  enabled = true
}

datacenter = "dc1"
region     = "global"

data_dir = "/nomad/data/"
bind_addr = "0.0.0.0"

advertise {
  http = "{{ GetPrivateIP }}:4646"
  rpc  = "{{ GetPrivateIP }}:4647"
  serf = "{{ GetPrivateIP }}:4648"
}
' \
  -v "/srv/nomad/data:/nomad/data:rw" \  # 数据目录
  -v "/var/run/docker.sock:/var/run/docker.sock" \  # Docker socket
  -v "/tmp:/tmp" \  # 临时目录
  multani/nomad agent

配置参数与环境变量

核心环境变量

关键配置项（NOMAD_LOCAL_CONFIG）

数据目录配置注意事项

Nomad模板文件路径依赖data_dir配置，为确保宿主机Docker daemon能正确挂载这些路径，需满足：

1. 路径一致性：容器内data_dir路径必须与宿主机挂载路径完全相同
   示例：宿主机路径/host/nomad/data需挂载为容器内同路径，配置data_dir = "/host/nomad/data"

2. 环境变量传递：通过NOMAD_DATA_DIR显式指定路径，确保配置与挂载同步：

bash
export NOMAD_DATA_DIR=/host/nomad/data

docker run \
  ... \
  -v "$NOMAD_DATA_DIR:$NOMAD_DATA_DIR:rw" \
  -e "NOMAD_DATA_DIR=$NOMAD_DATA_DIR" \
  multani/nomad agent

3. 权限设置：非root用户运行时，宿主机数据目录需赋予对应用户读写权限（如chown -R 1000:1000 /host/nomad/data）