hashicorppreview/nomad

Nomad Docker 镜像文档

1. 镜像概述与主要用途

Nomad 是一款简单且灵活的工作负载编排器，旨在跨本地数据中心和云环境大规模部署和管理容器、非容器化应用及虚拟机。本镜像为官方 Docker 镜像，打包了 https://www.nomadproject.io/ 二进制文件，主要用于 CI/CD 管道及其他自动化流程中执行 Nomad 相关操作。

重要提示：不支持在容器内运行 Nomad 客户端。若使用 agent 子命令（Nomad 代理模式），镜像将发出警告。有关在容器环境中使用 Nomad 的详细信息，请参考官方文档的 https://www.nomadproject.io/s/nomad-in-docker 章节。

2. 核心功能与特性

2.1 多工作负载支持

• 统一编排容器（如 Docker、containerd）、非容器化应用（二进制程序、脚本）及虚拟机（通过集成 Hypervisor）。

2.2 跨环境部署能力

• 支持在本地数据中心、公有云（AWS、Azure、GCP 等）及混合云环境中无缝部署和管理工作负载。

2.3 轻量化与灵活性

• 架构简洁，易于配置和扩展，降低编排复杂度，适合从小型测试环境到大型生产集群的各类场景。

2.4 自动化流程集成

• 官方二进制打包，可直接集成到 CI/CD 管道、自动化部署脚本等流程中，简化 Nomad 命令调用。

2.5 客户端运行限制

• 明确不支持在容器内作为 Nomad 客户端运行，避免因容器网络、存储隔离导致的功能异常。

3. 使用场景与适用范围

3.1 适用场景

• CI/CD 管道：在自动化构建、测试或部署流程中调用 Nomad 命令（如提交作业、检查集群状态）。
• 自动化部署：通过容器化的 Nomad 二进制执行批量部署、版本更新等操作。
• 测试环境编排：在隔离的测试环境中快速启动 Nomad 服务端，验证作业配置或编排逻辑。

3.2 不适用场景

• 容器内运行 Nomad 客户端：镜像设计不支持作为 Nomad 客户端节点运行，此类场景需直接在物理机或虚拟机部署 Nomad 客户端。

4. 使用方法与配置说明

4.1 基本使用方式

通过 docker run 命令启动容器，执行 Nomad 命令。镜像默认入口点为 nomad，可直接传递子命令。

4.1.1 查看版本信息

bash
docker run --rm hashicorp/nomad version

输出示例：

Nomad v1.7.0 (abc1234)

4.1.2 执行 Nomad 命令

在 CI/CD 流程中提交 Nomad 作业：

bash
# 挂载本地作业配置文件到容器内，执行提交命令
docker run --rm -v $(pwd)/job.hcl:/job.hcl hashicorp/nomad job run /job.hcl

4.2 配置说明

• 命令行参数：通过 docker run 命令传递 Nomad 子命令及参数，例如 nomad job plan、nomad server members 等。
• 配置文件：如需使用自定义配置，可通过 -v 挂载本地配置文件到容器内（如 /etc/nomad/nomad.hcl），并通过 --config 参数指定路径：

  bash
  docker run --rm -v $(pwd)/nomad.hcl:/etc/nomad/nomad.hcl hashicorp/nomad agent -config /etc/nomad/nomad.hcl
  

  警告：使用 agent 子命令将触发客户端运行警告，不建议在生产环境中使用。

4.3 注意事项

• 无持久化存储：容器默认无持久化存储，若需保存数据（如作业日志、状态文件），需挂载外部卷。
• 网络配置：根据 Nomad 命令需求配置容器网络（如 --network host 或端口映射），确保与外部服务（如 Nomad 集群、数据库）通信。

5. 社区支持与反馈

5.1 官方文档

Nomad 完整文档请访问：https://www.nomadproject.io/docs

5.2 问题反馈

如遇镜像相关问题（如打包错误、功能异常），请提交至 GitHub 仓库：https://github.com/hashicorp/nomad/