trivadis/jinja2-renderer

docker-jinja2-renderer

镜像概述

docker-jinja2-renderer是一个用于在Docker容器中执行批量Jinja2模板渲染的镜像。它提供了容器化的环境，通过外部脚本驱动Jinja2模板的批量处理，适用于需要隔离环境的模板渲染场景。

核心功能与特性

• 批量渲染支持：可处理多个Jinja2模板文件的批量渲染任务
• 脚本驱动执行：通过外部脚本定义渲染逻辑，灵活定制渲染流程
• 容器化隔离：提供独立的运行环境，避免依赖冲突
• 简单集成：支持通过文件映射方式快速接入现有工作流

使用场景

• 配置文件批量生成（如多环境配置模板渲染）
• 文档模板批量处理（如报告、证书等动态内容生成）
• CI/CD流程中的模板渲染步骤
• 需要隔离Jinja2依赖环境的场景

使用方法

准备工作

1. 创建渲染脚本generate.sh，包含Jinja2渲染命令

   bash
   # 示例generate.sh内容
   #!/bin/bash
   # 渲染单个模板
   jinja2 input_template.j2 data.json -o output.txt
   # 批量渲染多个模板
   for template in ./templates/*.j2; do
     filename=$(basename "$template" .j2)
     jinja2 "$template" data.json -o "outputs/$filename"
   done
   

2. 确保脚本具有可执行权限：chmod +x generate.sh

运行容器

使用docker run命令启动容器，将本地脚本目录映射到容器内的/scripts目录：

bash
docker run -v $(pwd):/scripts docker-jinja2-renderer

参数说明：

• -v $(pwd):/scripts：将当前目录映射到容器内的/scripts目录，使容器可访问generate.sh脚本及相关文件

配置说明

• 核心配置：渲染逻辑完全由generate.sh脚本定义，需确保脚本中包含正确的Jinja2命令
• 文件映射：必须将包含generate.sh的目录映射到容器内的/scripts目录，容器会自动执行该脚本
• 依赖管理：如需额外依赖，可在generate.sh中添加安装命令（如pip install）

注意事项

• generate.sh必须位于映射目录的根目录或通过脚本内部路径正确引用
• 确保模板文件、数据文件与generate.sh在同一映射目录或通过绝对路径访问
• 容器执行完成后会自动退出，渲染结果将保存在映射目录中