配置模板（Configuration Templates）

配置模板（Configuration Templates）是一套针对配置属性运行的模板处理器集合，能够根据配置源动态生成配置文件，支持多种模板引擎和配置文件格式，适用于需要动态配置生成的场景。

核心功能与特性

• 轻量级基础：基于Alpine Linux构建，体积小巧且运行高效
• 技术栈：集成NodeJS运行环境
• 多模板引擎支持：
  • Liquid
  • Mustache
• 多配置源：支持从键值文件、TOML文件及环境变量获取配置属性

使用场景

适用于需要根据环境变量、配置文件等动态生成配置的场景，例如：

• 应用部署时根据不同环境（开发/测试/生产）生成特定配置文件
• 通过模板统一管理多环境配置，减少配置冗余
• 基于外部配置源动态渲染配置内容

详细配置说明

环境变量

无特殊环境变量要求

目录结构

• /data：默认工作目录，可挂载本地配置目录至此以访问配置文件

命令参数

用于指定配置源的命令参数：

• --config-file=common.config：从普通键值对文件（key=value格式）加载属性，可多次使用以指定多个文件
• --config-toml-file=common.toml：从TOML格式配置文件加载属性，可多次使用以指定多个文件
• --config-env：从环境变量加载属性

组件详情

镜像内部包含以下组件：

• 基础系统：Alpine Linux
• 运行时：NodeJS
• 模板引擎：Liquid、Mustache
• 入口脚本：Entrypoint JS Script（负责模板处理逻辑）

使用示例

Liquid模板引擎示例

echo "<h1>Hello, {{NAME}} {{SURNAME}}</h1>{% for el in item['\$array'] %}<p>{{el.name}}</p><br/>{% endfor %}" | docker run \
    --interactive --rm \
    --env NAME="World" --env item.1.name=1 --env item.2.name=2 \
    theanurin/configuration-templates:20251014 \
      --engine liquid \
      --config-env

# 输出：<h1>Hello, World </h1><p>1</p><br/><p>2</p><br/>

Mustache模板引擎示例

echo '<h1>Hello, {{NAME}} {{SURNAME}}</h1>{{#item.$array}}<p>{{name}}</p><br/>{{/item.$array}}' | docker run \
    --interactive --rm \
    --env NAME="World" --env item.1.name=1 --env item.2.name=2 \
    theanurin/configuration-templates:20251014 \
      --engine mustache \
      --config-env

# 输出：<h1>Hello, World </h1><p>1</p><br/><p>2</p><br/>

多配置源组合使用示例

echo "<h1>Hello, {{NAME}} {{?SURNAME}}</h1>" | \
  docker run \
    --interactive --rm \
    --volume /path/to/configs:/data \  # 挂载本地配置目录至/data
    --env NAME="World" \
    theanurin/configuration-templates:20251014 \
      --engine mustache \
      --config-file=common.config \    # 加载键值配置文件
      --config-file=devel.config \     # 加载第二个键值配置文件
      --config-toml-file=devel.toml \  # 加载TOML配置文件
      --config-env                     # 同时加载环境变量

特殊属性说明

模板中可使用以下特殊属性处理数据结构：

• $parent：指向父数据节点
• $root：指向根数据节点
• $array：将当前对象转换为数组形式
• $single：约束为父命名空间中的单个属性

支持信息

• 维护者：Max Anurin
• 获取帮助：***频道