subfuzion/envtpl

envtpl

envtpl 是一个命令行工具，使用shell环境变量渲染Go模板，灵感来自Python工具https://github.com/andreasjansson/envtpl%EF%BC%8C%E6%97%A8%E5%9C%A8%E4%B8%BADocker%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%E6%8F%90%E4%BE%9B%E6%A8%A1%E6%9D%BF%E6%94%AF%E6%8C%81%E8%80%8C%E6%97%A0%E9%9C%80%E5%AE%89%E8%A3%85Python%E6%88%96Node.js%E3%80%82

核心功能

• 支持从文件或标准输入读取模板，输出到文件或标准输出
• 提供缺失变量处理选项（default/invalid、zero、error）
• 集成https://github.com/Masterminds/sprig%E5%BA%93%E6%89%A9%E5%B1%95%E6%A8%A1%E6%9D%BF%E5%87%BD%E6%95%B0%EF%BC%88%E5%A6%82title%E3%80%81printf%E7%AD%89%EF%BC%89
• 通过environment函数过滤带前缀的环境变量

使用场景

• Docker镜像中生成模板驱动的配置文件
• 自动化部署流程中动态替换配置变量
• 命令行快速渲染含环境变量的模板文件

配置说明

命令语法：envtpl [-o|--output outfile] [-m|--missingkey option] [template] 参数说明：

• template：可选，模板文件路径，未提供则从stdin读取
• -o/--output：可选，输出文件路径，未提供则输出到stdout
• -m/--missingkey：可选，缺失变量处理策略
  • default/invalid：默认，填充<no value>
  • zero：填充空字符串
  • error：报错终止程序

Docker部署示例

基本使用

bash
echo 'Hello {{ .NAME | title }}' | docker run -i --rm -e NAME=world subfuzion/envtpl
# 输出：Hello World

使用远程模板

bash
curl -s https://gist.githubusercontent.com/subfuzion/d5a6e3b7c2577902408069deb1d8e4d7/raw/2e4c0b894e2983411a20ffa5ee84aeafa5c6ebfb/greeting.tpl | docker run -i -e USER=$USER subfuzion/envtpl
# 输出：Hello, [你的用户名]

处理缺失变量

bash
# 模拟缺失USER变量并设置error策略
unset USER; echo 'Hello {{ .USER }}' | docker run -i --rm subfuzion/envtpl -m error
# 输出：map has no entry for key "USER"（程序终止）

模板函数示例

sprig函数使用

bash
echo 'Greetings, {{ .USER | title }}' | docker run -i --rm -e USER=mary subfuzion/envtpl
# 输出：Greetings, Mary

过滤环境变量

bash
echo '{{ range $key, $value := environment "GO" }}{{ $key }} => {{ $value }}\n{{ end }}' | docker run -i --rm -e GOPATH=/usr/local/go -e GOROOT=/go subfuzion/envtpl
# 输出：GOPATH => /usr/local/go\nGOROOT => /go

许可证

https://raw.githubusercontent.com/subfuzion/envtpl/master/LICENSE