chatwork/gomplate

gomplate Docker镜像文档

镜像概述和主要用途

本镜像为gomplate（一款模板渲染工具，项目地址：https://github.com/hairyhenderson/gomplate%EF%BC%89%E6%8F%90%E4%BE%9BDocker%E8%BF%90%E8%A1%8C%E7%8E%AF%E5%A2%83%E3%80%82%E5%AE%98%E6%96%B9gomplate%E9%95%9C%E5%83%8F%EF%BC%88https://hub.docker.com/r/hairyhenderson/gomplate%EF%BC%89%E4%BB%85%E5%8C%85%E5%90%ABgomplate%E5%91%BD%E4%BB%A4%EF%BC%8C%E7%BC%BA%E4%B9%8F%E5%9F%BA%E7%A1%80%E8%BF%90%E8%A1%8C%E4%BE%9D%E8%B5%96%EF%BC%8C%E4%BD%BF%E7%94%A8%E4%BD%93%E9%AA%8C%E4%B8%8D%E4%BD%B3%E3%80%82%E6%9C%AC%E9%95%9C%E5%83%8F%E5%9F%BA%E4%BA%8Echatwork/alpine-sdk%E6%9E%84%E5%BB%BA%EF%BC%8C%E8%A1%A5%E5%85%85%E5%BF%85%E8%A6%81%E4%BE%9D%E8%B5%96%EF%BC%8C%E6%97%A8%E5%9C%A8%E6%8F%90%E4%BE%9B%E6%9B%B4%E6%98%93%E7%94%A8%E3%80%81%E6%9B%B4%E4%BE%BF%E6%8D%B7%E7%9A%84gomplate%E5%B7%A5%E5%85%B7%E7%8E%AF%E5%A2%83%EF%BC%8C%E6%BB%A1%E8%B6%B3%E6%A8%A1%E6%9D%BF%E6%B8%B2%E6%9F%93%E5%9C%BA%E6%99%AF%E7%9A%84%E9%AB%98%E6%95%88%E4%BD%BF%E7%94%A8%E9%9C%80%E6%B1%82%E3%80%82

核心功能和特性

• 基于alpine-sdk基础环境：采用chatwork/alpine-sdk作为基础镜像，包含alpine系统及SDK工具，减少因依赖缺失导致的使用问题。
• 完整集成gomplate命令：保留gomplate工具的全部模板渲染功能，支持各类模板文件处理。
• 优化使用体验：解决官方镜像仅含命令、使用门槛高的问题，提供更友好的运行环境，便于快速上手和日常使用。

使用场景和适用范围

适用于需要使用gomplate进行模板渲染的各类场景，包括但不限于：

• 配置文件动态生成（如根据环境变量渲染不同配置）
• CI/CD流程中的模板自动化处理（如生成部署配置文件）
• 多环境配置管理（通过模板统一管理开发、测试、生产环境配置）
• 批量文件模板渲染任务

使用方法和配置说明

基本使用示例

通过docker run命令运行镜像，挂载工作目录并执行gomplate命令：

bash
docker run --rm -v $(pwd):/workspace -w /workspace [镜像名称] gomplate [gomplate命令参数]

参数说明：

• --rm：容器退出后自动删除，避免残留容器文件
• -v $(pwd):/workspace：将当前目录挂载到容器内的/workspace目录，便于访问本地模板文件
• -w /workspace：设置容器工作目录为/workspace，方便直接操作挂载的本地文件
• [镜像名称]：替换为实际使用的本镜像名称或标签
• [gomplate命令参数]：gomplate工具的具体命令及参数，如-f input.tpl -o output.txt（渲染input.tpl模板文件并输出到output.txt）

示例：渲染模板文件

假设本地有模板文件config.tpl，内容如下：

app_name: {{.APP_NAME}}
env: {{.ENV}}

通过以下命令渲染模板（需提前设置环境变量APP_NAME和ENV）：

bash
docker run --rm -v $(pwd):/workspace -w /workspace -e APP_NAME="myapp" -e ENV="production" [镜像名称] gomplate -f config.tpl -o config.yaml

执行后，当前目录将生成config.yaml文件，内容为：

app_name: myapp
env: production