jrasell/levant

Levant

![Build Status]([] ![Go Report Card]([] ![GoDoc]([] ![Join the chat at []]([***]

Levant是一款针对HashiCorp Nomad作业的开源模板化与部署工具，能在部署出现问题时提供实时反馈和详细的失败信息。

核心功能

• 实时反馈：通过监控机制，为Nomad作业部署提供实时反馈，帮助用户深入了解应用部署过程。
• 高级作业状态检查：针对系统和批处理作业，确保作业、评估和分配达到预期状态，并在每个阶段提供反馈。
• 动态作业组计数：若Nomad作业已在集群运行，部署前自动更新渲染模板中的作业组计数。
• 失败检查：部署失败时，自动检查每个分配并记录事件信息，无需事后查询集群即可获取调试数据。
• 金丝雀自动推广：设置canary-auto-promote时间阈值，若金丝雀实例健康运行达标则自动推广部署。
• 多变量文件格式：支持.json、.tf、.yaml、.yml格式的模板变量声明。
• 自动回滚检查：启用自动回滚时，跟踪回滚部署过程，展示最终结果。

使用场景

1. Nomad集群作业部署：简化Nomad集群中作业的模板化与部署流程。
2. CI/CD自动化：集成到流水线中，实现Nomad作业的自动化发布与监控。
3. 部署问题排查：实时掌握部署进度和失败原因，提升问题解决效率。

配置说明

Levant使用Nomad和Consul官方客户端，可通过环境变量配置（如NOMAD_ADDR指定Nomad地址、CONSUL_HTTP_ADDR指定Consul地址）。详细配置见https://github.com/jrasell/levant/blob/master/docs/clients.md%E3%80%82

Docker部署示例

查看帮助

bash
docker run --rm jrasell/levant --help

部署作业（挂载模板与变量文件）

bash
docker run --rm -v $(pwd)/templates:/templates -v $(pwd)/vars:/vars jrasell/levant deploy -var-file=/vars/app_vars.yaml /templates/app_job.nomad

贡献

欢迎贡献！请参考https://github.com/jrasell/levant/blob/master/.github/CONTRIBUTING.md%E4%BA%86%E8%A7%A3%E5%BC%80%E5%8F%91%E7%BB%86%E8%8A%82%E3%80%82