webhippie/templater

Templater

镜像概述

Templater是一款基于Golang text/template包开发的模板处理器，主要用于Docker容器环境中动态生成配置文件。它解决了传统envsubst工具缺乏控制结构的问题，提供更灵活的模板逻辑，变量完全通过环境变量注入，适配多种动态配置场景。

核心功能

1. Go模板支持：兼容Golang模板的所有控制结构（条件判断、循环、函数调用等）；
2. 环境变量传参：模板变量仅通过环境变量传递，无需额外配置文件；
3. 替代envsubst：相比envsubst提供更丰富的模板逻辑，满足复杂配置需求；
4. 多平台适配：提供预编译二进制、容器镜像及DEB/RPM包，支持多种部署环境。

使用场景

• Docker容器内动态生成Nginx、MySQL等服务的配置文件；
• 自动化部署流程中根据环境变量生成个性化配置；
• CI/CD流水线中需要灵活模板逻辑的场景。

配置说明

使用时需指定模板文件路径和输出文件路径，核心参数包括：

• -template：模板文件的绝对路径；
• -out：生成结果的输出路径；
• -strict：开启严格模式（变量未定义时抛出错误，默认关闭）。

Docker部署示例

基本运行（docker run）

bash
docker run --rm \
  -v $(pwd)/templates:/templates \
  -v $(pwd)/output:/output \
  -e APP_NAME="MyApplication" \
  -e APP_PORT=8080 \
  docker.xuanyuan.run/webhippie/templater \
  -template /templates/app.conf.tpl \
  -out /output/app.conf

Docker Compose示例

yaml
version: '3'
services:
  templater:
    image: docker.xuanyuan.run/webhippie/templater
    volumes:
      - ./templates:/templates
      - ./output:/output
    environment:
      - APP_NAME=MyApplication
      - APP_PORT=8080
    command: ["-template", "/templates/app.conf.tpl", "-out", "/output/app.conf"]

安全与贡献

• 安全问题请联系：***；
• 贡献方式：Fork仓库 → 提交补丁 → 推送分支 → 发起Pull Request。

许可证

Apache-2.0

版权

Copyright (c) 2018 Thomas Boerger <***>