jlesage/render-template

docker-render-template

镜像概述和主要用途

docker-render-template是一个Docker容器，用于使用JSON或XML文件作为数据源渲染Jinja2模板。该容器支持指定多个数据源文件并将其合并，同时具备多轮渲染能力——模板渲染结果可作为新模板进行下一轮处理，直至两次连续渲染结果无变化时停止并输出最终结果。

核心功能和特性

• 多数据源支持：可同时处理多个JSON或XML格式的数据源文件
• 数据合并：自动将多个数据源文件合并为统一数据集供模板使用
• 递归渲染机制：模板渲染结果可作为新模板进行下一轮渲染，直至结果稳定
• 双格式兼容：同时支持JSON和XML两种结构化数据作为数据源
• XML列表控制：可强制指定XML元素为列表类型，即使该层级仅有单个子元素

使用场景和适用范围

适用于需要基于结构化数据动态生成文本内容的场景，包括但不限于：

• 配置文件自动生成（如Nginx、Apache等服务的配置文件）
• 基于JSON/XML数据的报告或文档生成
• 动态生成包含条件逻辑的模板内容
• 环境变量驱动的应用配置模板渲染

使用方法和配置说明

快速开始

通过提供的辅助脚本直接使用：

bash
curl -s https://raw.githubusercontent.com/jlesage/docker-render-template/master/render_template.sh | sh -s TEMPLATE TEMPLATE_DATA_SOURCE [TEMPLATE_DATA_SOURCE...]

参数说明：

• TEMPLATE：Jinja2模板文件的本地路径
• TEMPLATE_DATA_SOURCE：数据源文件（JSON或XML）的本地路径，可指定多个

命令行参数详解

容器核心执行命令为render_template.py，完整使用方法如下：

bash
usage: render_template.py [-h] [--force-list FORCE_LIST]
                          TEMPLATE TEMPLATE_DATA [TEMPLATE_DATA ...]

位置参数

可选参数

Docker部署示例

基础使用（docker run）

bash
docker run --rm \
  -v /local/path/to/template.j2:/app/template.j2 \
  -v /local/path/to/data1.json:/app/data1.json \
  -v /local/path/to/data2.xml:/app/data2.xml \
  docker.xuanyuan.run/jlesage/render-template \
  render_template.py /app/template.j2 /app/data1.json /app/data2.xml

带XML列表强制参数的使用

bash
docker run --rm \
  -v /local/path/to/template.j2:/app/template.j2 \
  -v /local/path/to/config.xml:/app/config.xml \
  docker.xuanyuan.run/jlesage/render-template \
  render_template.py --force-list "servers,databases" /app/template.j2 /app/config.xml

docker-compose配置示例

yaml
version: '3'
services:
  render-template:
    image: jlesage/render-template
    volumes:
      - ./templates:/app/templates
      - ./data:/app/data
    command: render_template.py --force-list "items,users" /app/templates/main.j2 /app/data/config.json /app/data/metadata.xml